本地搜索
优质
小牛编辑
132浏览
2023-12-01
本地搜索服务可以根据用户输入的POI关键词在指定范围“city”内查找与之匹配的地理兴趣点，并将其结果有序返回。
使用服务前需要先申请 key。
资源服务地址：https://www.supermapol.com/iserver/services/localsearch/rest/searchdatas/China/poiinfos
资源接口参数说明
本地搜索服务支持GET和HEAD请求，支持json\xml\jsonp等格式
GET 请求参数
| 参数名 | 类型 | 默认值 | 范例 | 是否必须 | 描述 |
|---|---|---|---|---|---|
| keyWords | String | 无 | 超图软件 | 是 | 搜索关键字，需要检索的POI关键字，如输入多个关键字，请使用空格隔开 |
| city | String | 无 | 北京市 | 否 | POI服务查询范围，默认北京市范围查找 |
| pageSize | int | 10 | 10 | 否 | 返回记录结果数，默认10，最大设置为20 |
| pageNum | int | 1 | 1 | 否 | 分页页码，默认1代表第一页 |
| to | int | 910101 | 910101 | 否 | 输出结果坐标类型。枚举值：910101、910111、910102、910112、910113。坐标类型编码参考坐标类型。 |
距离搜索模式请求参数
| 参数名 | 类型 | 默认值 | 范例 | 是否必须 | 描述 |
|---|---|---|---|---|---|
| location | Point2D | 无 | {"x":116.505792,"y":39.985568} | 是 | POI查询中心点 |
| radius | int | 无 | 200 | 是 | POI查询半径，单位为米 |
范围搜索模式请求参数
| 参数名 | 类型 | 默认值 | 范例 | 是否必须 | 描述 |
|---|---|---|---|---|---|
| leftLocation | Point2D | 无 | {"x":116.00,"y":39.00} | 是 | POI查询左下角坐标 |
| rightLocation | Point2D | 无 | {"x":116.70,"y":40.00} | 是 | POI查询右上角坐标 |
响应结构
| 名称 | 类型 | 描述 |
|---|---|---|
| totalHits | int | POI查询结果总数 |
| poiInfos | POIInfo数组 | POI搜索服务查询到的POI集合信息，每个POI信息如下表所示 |
POIInfo 说明：
| 属性名称 | 类型 | 描述 | |
|---|---|---|---|
| address | String | POI详细地址信息 | |
| name | String | POI名称信息 | |
| location | Point2D | POI地理坐标 | |
| x | double | 地理坐标经度值 | |
| y | double | 地理坐标纬度值 | |
| score | float | 查询结果的可信度 | |
| telephone | String | POI地址的联系电话 | |
| uid | String | POI地址唯一标识 | |
服务示例
https://www.supermapol.com/iserver/services/localsearch/rest/searchdatas/China/ poiinfos.json?keywords=超图软件&city=北京市&location=&radius=&leftLocation=& rightLocation=&pageSize=10&pageNum=1&key=fvV2osxwuZWlY0wJb8FEb2i5
| 参数名 | 值 | 备注 |
|---|---|---|
| searchType | 三种搜索模式：默认；距离搜索；范围搜索 | |
| keyWords | 超图软件 | 搜索关键字，需要检索的POI关键字 |
| city | 北京市 | POI服务查询范围 |
| pageSize | 10 | 返回记录结果数，默认10 |
| pageNum | 1 | 分页页码，默认1代表第一页 |
响应结果
{
"poiInfos": [
{
"address": "北京市朝阳区酒仙桥北路甲10号电子城IT产业园107楼6层",
"location": {
"x": 116.50579227900883,
"y": 39.98556847551764
},
"name": "北京超图软件股份有限公司",
"score": 0,
"telephone": "(010)59896655",
"uid": "e30da3876c4fdffb932ca3e8"
},
{
"address": "北京市朝阳区将台酒仙桥北路甲10号院电子城it产业园107号楼1楼(超图软件大楼)",
"location": {
"x": 116.50584249699072,
"y": 39.985587854384725
},
"name": "瑞华康源科技有限公司",
"score": 0,
"telephone": "(010)50953959",
"uid": "ffa45bb0bb32c20ca8f0cd8e"
}
],
"totalHits": 2
}