POI检索
说明：可通过兴趣点名称、行政区划名称、经纬度以及分页核查来获取兴趣点全称、中心点坐标、地址描述、电话、兴趣点唯一识别码、兴趣点类型、细节说明。POI检索分为周边检索、区域检索和城市内检索。
周边检索：周边检索是一个圆形范围，适用于以某个位置为中心点，自定义检索半径值，搜索某个位置附近的POI。
区域检索：POI区域检索，是在指定的绘制的矩形范围内（依据左下角坐标和右上角坐标绘制的矩形范围），检索POI。
城市内检索：根据关键字检索适用于在某个城市搜索某个名称相关的POI，例如：查找北京市的 “饭店”。
周边检索
GET
周边检索
http://map.botaisoft.com/apis/v1/poi?query=&location=&radius=&token=说明：根据兴趣点名称、经纬度、范围半径获取兴趣点全称、中心点坐标、地址描述、电话、兴趣点唯一识别码、兴趣点类型、细节说明
请求参数:
| 名称 | 类型 | 说明 |
|---|---|---|
| token | String | 用户的访问权限key |
| query | String | 兴趣点名称 |
| location | double[] | 中心点坐标(lat,lon) |
| radius | int | 范围半径 |
| page_size | int | 返回条数限制(可选参数) |
| page_num | int | 返回条目数(可选参数) |
| type | int | 检索类别(海图专用) |
响应参数:
| 对象（数组）名 | 参数名 | 类型 | 说明 |
|---|---|---|---|
| code | number | 成功：200 失败：-1 | |
| message | String | 成功：ok 失败：no result | |
| result | |||
| name | String | 兴趣点全称 | |
| location | double[] | 中心点坐标 | |
| lon | double | 经度 | |
| lat | double | 纬度 | |
| address | String | 地址描述 | |
| telephone | String | 电话 | |
| uid | long | 兴趣点唯一识别码 | |
| poitype | String | 兴趣点类型 | |
| detail_info | String | 细节说明 |
Response:
- 没有返回限制
- 有返回限制
- 海图周边检索
区域检索
GET
区域检索
http://map.botaisoft.com/apis/v1/poi?query=&bounds=&token=说明：根据兴趣点名称、左上右下两点经纬度画出的矩形框，获取兴趣点全称、中心点坐标、地址描述、电话、兴趣点唯一识别码、兴趣点类型、细节说明
请求参数:
| 名称 | 类型 | 说明 |
|---|---|---|
| token | String | 用户的访问权限key |
| query | String | 兴趣点名称 |
| bounds | double[] | 矩形框 |
| page_size | int | 返回条数限制(可选参数) |
| page_num | int | 返回条目数(可选参数) |
响应参数:
| 对象（数组）名 | 参数名 | 类型 | 说明 |
|---|---|---|---|
| code | number | 成功：200 失败：-1 | |
| message | String | 成功：ok 失败：no result | |
| result | |||
| name | String | 兴趣点全称 | |
| location | double[] | 中心点坐标 | |
| lon | double | 经度 | |
| lat | double | 纬度 | |
| address | String | 地址描述 | |
| telephone | String | 电话 | |
| uid | long | 兴趣点唯一识别码 | |
| poitype | String | 兴趣点类型 | |
| detail_info | String | 细节说明 |
Response:
- 没有返回限制
- 有返回限制
城市内检索
GET
城市内检索
http://map.botaisoft.com/apis/v1/poi?query=®ion=&token=说明：根据兴趣点名称、城市名称，获取兴趣点全称、中心点坐标、地址描述、电话、兴趣点唯一识别码、兴趣点类型、细节说明
请求参数:
| 名称 | 类型 | 说明 |
|---|---|---|
| token | String | 用户的访问权限key |
| query | String | 兴趣点名称 |
| region | String | 城市名称 |
| page_size | int | 返回条数限制(可选参数) |
| page_num | int | 返回条目数(可选参数) |
响应参数:
| 对象（数组）名 | 参数名 | 类型 | 说明 |
|---|---|---|---|
| code | number | 成功：200 失败：-1 | |
| message | String | 成功：ok 失败：no result | |
| result | |||
| name | String | 兴趣点全称 | |
| location | double[] | 中心点坐标 | |
| lon | double | 经度 | |
| lat | double | 纬度 | |
| address | String | 地址描述 | |
| telephone | String | 电话 | |
| uid | long | 兴趣点唯一识别码 | |
| poitype | String | 兴趣点类型 | |
| detail_info | String | 细节说明 |
Response:
- 没有返回限制
- 有返回限制