正在跳转至目标页,请稍后…
概述
提供多种搜索功能:
- 指定城市/区域搜索:如在北京搜索景点。新增高级参数:支持获取车站、机场、园区等较大范围地点的子点和出入口热度,辅助用户选择准确目的地。
- 周边搜索:如,搜索颐和园附近半径500米内的酒店(一个圆形范围);
- 矩形范围搜索:在地图应用中,往往用于视野内搜索,因为显示地图的区域是个矩形。
- 多边形范围搜索:自定义多边形范围进行地点搜索,由此您可以更好地控制搜索范围的准确性。
- 周边推荐:只需提供中心点及半径(无须关键词),即可搜索获取周边高热度地点,一般用于发送位置、地点签到等场景,自动为用户提供备选地点列表
- id查询POI信息:通过POI ID查询POI信息
周边搜索
![](http://p.qpic.cn/lbsconsole/0/f557043163e95729352bbcde221d65c3/0)
请求URL
https://apis.map.qq.com/ws/place/v1/search
请求参数
请求方式(Method): GET
参数 |
必填 |
说明 |
示例 |
key |
是 |
开发密钥(Key) |
key=OB4BZ-D4W3U-*** |
keyword |
是 |
搜索关键字,长度最大96个字节,注:keyword仅支持检索一个。 (API采用UTF-8字符编码,1个英文字符占用1个字节, 1个中文字符占3个字节,具体请参阅相关技术资料) |
keyword=酒店,注意键值要进行URL编码(推荐encodeURI),如 keyword=%e9%85%92%e5%ba%97 |
boundary |
是 |
格式: boundary=nearby(lat,lng,radius[, auto_extend]) 子参数: lat,lng:搜索中心点的经纬度,格式顺序为纬度在前,经度在后 radius:搜索半径,单位:米,取值范围:10到1000 auto_extend:[可选] 当前范围无结果时,是否自动扩大范围,取值: 0 不扩大 1 [默认] 自动扩大范围(依次按照按1公里、2公里、5公里, 最大到全城市范围搜索) |
boundary=nearby(28.681114,115.918377,1000,1) |
get_subpois |
否 |
是否返回子地点,如大厦停车场、出入口等取值:0 [默认]不返回1 返回 |
get_subpois=1 |
filter |
否 |
筛选条件 1. 指定分类筛选,语句格式为: category=分类名1,分类名2 分类词数量建议不超过5个,支持设置分类编码(支持的分类请参考:POI分类表) 2. 排除指定分类,语句格式为: category<>分类名1,分类名2 分类词数量建议不超过5个,支持设置分类编码(支持的分类请参考:POI分类表) 3. 筛选有电话的地点:tel<>null |
搜索指定分类 分类名:filter=category=公交车站 分类编码:filter=category=271013 搜索多个分类 分类名:filter=category=大学,中学 分类编码:filter=category= 241000,241100 排除指定分类 分类名:filter=category<>商务楼宇 分类编码:filter=category<>281200 (注意参数值要进行url编码) |
added_fields |
否 |
返回指定标准附加字段,取值支持: category_code - poi分类编码 |
added_fields=category_code |
orderby |
否 |
排序,支持按距离由近到远排序,取值:_distance 说明: 1. 周边搜索默认排序会综合考虑距离、权重等多方面因素 2. 设置按距离排序后则仅考虑距离远近,一些低权重的地点可能因距离近排在前面,导致体验下降 |
orderby=_distance |
page_size |
否 |
每页条目数,最大限制为20条,默认为10条 |
page_size=10 |
page_index |
否 |
第x页,默认第1页 |
page_index=2 |
output |
否 |
返回格式: 支持JSON/JSONP,默认JSON |
output=json |
callback |
否 |
JSONP方式回调函数 |
callback=function1 |
响应结果
名称 |
类型 |
必有 |
说明 |
status |
number |
是 |
状态码,0为正常,其它为异常,详细请参阅状态码说明 |
message |
string |
是 |
状态说明 |
count |
number |
是 |
本次搜索结果总数,另外本服务限制最多返回200条数据(data), 翻页(page_index)超过搜索结果总数返回空,未超过搜索总数但超过200条限制时,将返回最后一页数据。 |
request_id |
string |
是 |
本次请求的唯一标识,由系统自动生成,用于追查结果有异常时使用 |
data |
array |
是 |
搜索结果POI(地点)数组,每项为一个POI(地点)对象 |
|
id |
string |
是 |
POI(地点)唯一标识 |
|
title |
string |
是 |
POI(地点)名称 |
|
address |
string |
是 |
地址 |
|
tel |
string |
是 |
电话 |
|
category |
string |
是 |
POI(地点)分类 |
|
category_code |
number |
否 |
POI(地点)分类编码,设置added_fields=category_code时返回 |
|
type |
number |
是 |
POI类型,值说明:0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划 |
|
location |
object |
是 |
坐标 |
|
lat |
number |
是 |
纬度 |
|
lng |
number |
是 |
经度 |
|
_distance |
number |
是 |
距离,单位: 米,在周边搜索、城市范围搜索传入定位点时返回 |
|
ad_info |
object |
是 |
行政区划信息 |
|
adcode |
number |
是 |
行政区划代码,详见:行政区划代码说明 |
|
province |
string |
是 |
省 |
|
city |
string |
是 |
市,如果当前城市为省直辖县级区划,此字段会返回为空,由district字段返回。 注:省直辖县级区划adcode第3和第4位分别为9、0,如济源市adcode为419001 |
|
district |
string |
是 |
区 |
sub_pois |
array |
否 |
子地点列表,仅在输入参数get_subpois=1时返回 |
|
parent_id |
string |
是 |
主地点ID,对应data中的地点ID |
id |
string |
是 |
地点唯一标识 |
title |
string |
是 |
地点名称 |
tel |
string |
是 |
电话 |
category |
string |
是 |
POI(地点)分类 |
type |
number |
是 |
POI类型,值说明:0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划 |
address |
string |
是 |
地址 |
location |
object |
是 |
坐标 |
|
lat |
number |
是 |
纬度 |
lng |
number |
是 |
经度 |
ad_info |
object |
是 |
行政区划信息 |
|
adcode |
number |
是 |
行政区划代码,详见:行政区划代码说明 |
|
province |
string |
是 |
省 |
|
city |
string |
是 |
市,如果当前城市为省直辖县级区划,此字段会返回为空,由district字段返回。 注:省直辖县级区划adcode第3和第4位分别为9、0,如济源市adcode为419001 |
|
district |
string |
是 |
区 |
调用示例
//GET请求示例,注意参数值要进行URL编码
//周边搜索(圆形范围):boundary=nearby(lat,lng<中心坐标>,radius<半径/米>)
https://apis.map.qq.com/ws/place/v1/search?boundary=nearby(40.040589,116.273543,1000)&keyword=公园&page_size=10&page_index=1&key=OB4BZ-D4W3U-*****
在线体验
城市/区域搜索
![](http://p.qpic.cn/lbsconsole/0/e9b025d3abeccef5775b1286cbbf4725/0)
请求URL
https://apis.map.qq.com/ws/place/v1/search
请求参数
请求方式(Method): GET
参数 |
必填 |
说明 |
示例 |
key |
是 |
开发密钥(Key) |
key=OB4BZ-D4W3U-*** |
keyword |
是 |
搜索关键字,长度最大96个字节,注:keyword仅支持检索一个。 (API采用UTF-8字符编码,1个英文字符占用1个字节, 1个中文字符占3个字节,具体请参阅相关技术资料) |
keyword=酒店,注意键值要进行URL编码(推荐encodeURI),如 keyword=%e9%85%92%e5%ba%97 |
boundary |
是 |
格式: boundary=region(city_name [,auto_extend][,lat,lng]) 子参数: city_name:检索城市名称, 如北京市,同时支持adcode(行政区划代码,可精确到区县级),如130681 auto_extend:[可选]当前范围无结果时,是否自动扩大范围,取值 0 仅在当前城市搜索; 1 [默认] 若当前城市搜索无结果,则自动扩大范围; 2 限制在当前区/县范围搜索,无结果时不自动扩大范围(仅在传入city_name为区级或区级行政区划代码时有效)。 lat,lng:[可选] 当keyword使用酒店、超市等泛分类关键词时,这类场景大多倾向于搜索附近,传入此经纬度,搜索结果会优先就近地点,体验更优。格式顺序为纬度在前,经度在后 |
boundary=region(北京,1,40.040493,116.273545) |
get_subpois |
否 |
是否返回子地点,如大厦停车场、出入口等取值:0 [默认]不返回1 返回 |
get_subpois=1 |
返回子点热度 |
否 |
支持获取车站、机场、园区等较大范围地点的子点和出入口热度,辅助用户选择准确目的地。 本参数属于高级付费参数,如需试用请提交商务合作开通试用。
![](http://p.qpic.cn/lbsconsole/0/b7afbb50721ba713f4b3936d3a6b98de/0) |
|
filter |
否 |
筛选条件 1. 指定分类筛选,语句格式为: category=分类名1,分类名2 分类词数量建议不超过5个,支持设置分类编码(支持的分类请参考:POI分类表) 2. 排除指定分类,语句格式为: category<>分类名1,分类名2 分类词数量建议不超过5个,支持设置分类编码(支持的分类请参考:POI分类表) 3. 筛选有电话的地点:tel<>null |
搜索指定分类 分类名:filter=category=公交车站 分类编码:filter=category=271013 搜索多个分类 分类名:filter=category=大学,中学 分类编码:filter=category= 241000,241100 排除指定分类 分类名:filter=category<>商务楼宇 分类编码:filter=category<>281200 (注意参数值要进行url编码) |
added_fields |
否 |
返回指定标准附加字段,取值支持: category_code - poi分类编码 |
added_fields=category_code |
page_size |
否 |
每页条目数,最大限制为20条,默认为10条 |
page_size=10 |
page_index |
否 |
第x页,默认第1页 |
page_index=2 |
output |
否 |
返回格式: 支持JSON/JSONP,默认JSON |
output=json |
callback |
否 |
JSONP方式回调函数 |
callback=function1 |
响应结果 - 正常搜索结果
名称 |
类型 |
必有 |
说明 |
status |
number |
是 |
状态码,0为正常,其它为异常,详细请参阅状态码说明 |
message |
string |
是 |
状态说明 |
count |
number |
是 |
本次搜索结果总数,另外本服务限制最多返回200条数据(data), 翻页(page_index)超过搜索结果总数返回空,未超过搜索总数但超过200条限制时,将返回最后一页数据。 |
request_id |
string |
是 |
本次请求的唯一标识,由系统自动生成,用于追查结果有异常时使用 |
data |
array |
是 |
搜索结果POI(地点)数组,每项为一个POI(地点)对象 |
|
id |
string |
是 |
POI(地点)唯一标识 |
|
title |
string |
是 |
POI(地点)名称 |
|
address |
string |
是 |
地址 |
|
tel |
string |
是 |
电话 |
|
category |
string |
是 |
POI(地点)分类 |
|
category_code |
number |
否 |
POI(地点)分类编码,设置added_fields=category_code时返回 |
|
type |
number |
是 |
POI类型,值说明:0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划 |
|
location |
object |
是 |
坐标 |
|
lat |
number |
是 |
纬度 |
|
lng |
number |
是 |
经度 |
|
_distance |
number |
是 |
距离,单位: 米,在周边搜索、城市范围搜索传入定位点时返回 |
|
ad_info |
object |
是 |
行政区划信息 |
|
adcode |
number |
是 |
行政区划代码,详见:行政区划代码说明 |
|
province |
string |
是 |
省 |
|
city |
string |
是 |
市,如果当前城市为省直辖县级区划,此字段会返回为空,由district字段返回。 注:省直辖县级区划adcode第3和第4位分别为9、0,如济源市adcode为419001 |
|
district |
string |
是 |
区 |
sub_pois |
array |
否 |
子地点列表,仅在输入参数get_subpois=1时返回 |
|
parent_id |
string |
是 |
主地点ID,对应data中的地点ID |
id |
string |
是 |
地点唯一标识 |
title |
string |
是 |
地点名称 |
tel |
string |
是 |
电话 |
category |
string |
是 |
POI(地点)分类 |
type |
number |
是 |
POI类型,值说明:0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划 |
address |
string |
是 |
地址 |
location |
object |
是 |
坐标 |
|
lat |
number |
是 |
纬度 |
lng |
number |
是 |
经度 |
ad_info |
object |
是 |
行政区划信息 |
|
adcode |
number |
是 |
行政区划代码,详见:行政区划代码说明 |
|
province |
string |
是 |
省 |
|
city |
string |
是 |
市,如果当前城市为省直辖县级区划,此字段会返回为空,由district字段返回。 注:省直辖县级区划adcode第3和第4位分别为9、0,如济源市adcode为419001 |
|
district |
string |
是 |
区 |
lines |
array |
否 |
搜索公交线路数组,每项为一个公交路线对象 |
|
id |
string |
否 |
公交线路唯一标识 |
|
title |
string |
否 |
公交线路名称 |
|
origin |
object |
否 |
当前公交线路的始发站 |
|
title |
string |
否 |
始发站站点名称 |
|
destination |
object |
否 |
当前公交线路的终点站 |
|
title |
string |
否 |
终点站站点名称 |
region |
object |
是 |
POI数据所属地区 |
|
title |
string |
是 |
所属地区名称 |
响应结果 - 按城市统计结果
当搜索范围过大,如 boundary=region(全国) 时,而且keyword的搜索结果在各城市无明显权重特别高的时,将返回各城市搜索结果数量的统计数,您可以将此统计结果展示给用户,供用户缩小城市范围,再次发起搜索使用。
![](http://p.qpic.cn/lbsconsole/0/3dceca30ed4d82cea2785a270daa9e47/0)
名称 |
类型 |
必有 |
说明 |
status |
number |
是 |
状态码,0为正常,其它为异常,详细请参阅状态码说明 |
message |
string |
是 |
状态说明 |
count |
number |
是 |
本次搜索结果总数 |
request_id |
string |
是 |
本次请求的唯一标识,由系统自动生成,用于追查结果有异常时使用 |
data |
array |
是 |
搜索结果POI(地点)数组,每项为一个POI(地点)对象 |
cluster |
array |
是 |
统计结果数组 |
|
title |
string |
是 |
城市名称 |
|
count |
number |
是 |
根据搜索条件,在该城市搜到的结果数 |
调用示例:正常搜索结果
//GET请求示例,注意参数值要进行URL编码
//指定地区名称,不自动扩大范围:boundary=region(北京,0)
https://apis.map.qq.com/ws/place/v1/search?boundary=region(北京,0)&keyword=颐和园&page_size=20&page_index=1&key=OB4BZ-D4W3U-*****
在线体验
调用示例:按城市统计结果
//GET请求示例,注意参数值要进行URL编码
https://apis.map.qq.com/ws/place/v1/search?boundary=region(全国)&keyword=博物馆&key=OB4BZ-D4W3U-*****
在线体验
矩形范围(屏幕视野内)搜索
![](http://p.qpic.cn/lbsconsole/0/ea53f0260612417c90ce26b81cf0804c/0)
请求URL
https://apis.map.qq.com/ws/place/v1/search
请求参数
请求方式(Method): GET
参数 |
必填 |
说明 |
示例 |
key |
是 |
开发密钥(Key) |
key=OB4BZ-D4W3U-*** |
keyword |
是 |
搜索关键字,长度最大96个字节,注:keyword仅支持检索一个。 (API采用UTF-8字符编码,1个英文字符占用1个字节, 1个中文字符占3个字节,具体请参阅相关技术资料) |
keyword=酒店,注意键值要进行URL编码(推荐encodeURI),如 keyword=%e9%85%92%e5%ba%97 |
boundary |
是 |
格式: boundary=rectangle(lat,lng,lat,lng) 子参数: 由矩形左下角(西南)和右上角(东北)两对经纬度组成,格式顺序为纬度在前,经度在后 |
boundary=rectangle(40.037961,116.267921,40.051036,116.284873) |
filter |
否 |
筛选条件 1. 指定分类筛选,语句格式为: category=分类名1,分类名2 分类词数量建议不超过5个,支持设置分类编码(支持的分类请参考:POI分类表) 2. 排除指定分类,语句格式为: category<>分类名1,分类名2 分类词数量建议不超过5个,支持设置分类编码(支持的分类请参考:POI分类表) 3. 筛选有电话的地点:tel<>null |
搜索指定分类 分类名:filter=category=公交车站 分类编码:filter=category=271013 搜索多个分类 分类名:filter=category=大学,中学 分类编码:filter=category= 241000,241100 排除指定分类 分类名:filter=category<>商务楼宇 分类编码:filter=category<>281200 (注意参数值要进行url编码) |
added_fields |
否 |
返回指定标准附加字段,取值支持: category_code - poi分类编码 |
added_fields=category_code |
page_size |
否 |
每页条目数,最大限制为20条,默认为10条 |
page_size=10 |
page_index |
否 |
第x页,默认第1页 |
page_index=2 |
output |
否 |
返回格式: 支持JSON/JSONP,默认JSON |
output=json |
callback |
否 |
JSONP方式回调函数 |
callback=function1 |
响应结果
名称 |
类型 |
必有 |
说明 |
status |
number |
是 |
状态码,0为正常,其它为异常,详细请参阅状态码说明 |
message |
string |
是 |
状态说明 |
count |
number |
是 |
本次搜索结果总数,另外本服务限制最多返回200条数据(data), 翻页(page_index)超过搜索结果总数返回空,未超过搜索总数但超过200条限制时,将返回最后一页数据。 |
request_id |
string |
是 |
本次请求的唯一标识,由系统自动生成,用于追查结果有异常时使用 |
data |
array |
是 |
搜索结果POI(地点)数组,每项为一个POI(地点)对象 |
|
id |
string |
是 |
POI(地点)唯一标识 |
|
title |
string |
是 |
POI(地点)名称 |
|
address |
string |
是 |
地址 |
|
tel |
string |
是 |
电话 |
|
category |
string |
是 |
POI(地点)分类 |
|
category_code |
number |
否 |
POI(地点)分类编码,设置added_fields=category_code时返回 |
|
type |
number |
是 |
POI类型,值说明:0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划 |
|
location |
object |
是 |
坐标 |
|
lat |
number |
是 |
纬度 |
|
lng |
number |
是 |
经度 |
|
ad_info |
object |
是 |
行政区划信息 |
|
adcode |
number |
是 |
行政区划代码,详见:行政区划代码说明 |
|
province |
string |
是 |
省 |
|
city |
string |
是 |
市,如果当前城市为省直辖县级区划,此字段会返回为空,由district字段返回。 注:省直辖县级区划adcode第3和第4位分别为9、0,如济源市adcode为419001 |
|
district |
string |
是 |
区 |
调用示例
//GET请求示例,注意参数值要进行URL编码
//矩形区域范围:boundary=rectangle(lat,lng<左下/西南>, lat,lng<右上/东北>)
https://apis.map.qq.com/ws/place/v1/search?boundary=rectangle(39.907293,116.368935,39.914996,116.379321)&keyword=美食&page_size=10&page_index=1&key=OB4BZ-D4W3U-*****
在线体验
多边形范围搜索
本接口提供基于多边形范围的地点搜索能力。
注:
本服务属于高级付费服务,如需试用请提交商务合作开通服务试用。
![](http://p.qpic.cn/lbsconsole/0/a09923ad3f6382ccdd0b2b41870a747f/0)
请求URL
https://apis.map.qq.com/ws/place/v1/search_by_polygon
请求参数
请求方式(Method): GET
参数 |
必填 |
说明 |
示例 |
key |
是 |
开发key:您可在控制台Key管理界面自行创建,且需要开启WebServiceAPI功能 |
key=OB4BZ-D4W3U-*** |
polygon |
是 |
多边形区域: 1. 格式为lat,lng;lat,lng… 2. 支持凸多边形及凹多边形,多边形不可自相交 4. 面积<30平方公里(引擎评估中) 5. 目前多边形不支持支持跨城市 |
polygon=39.932512,116.355515;39.933697,116.434650;39.913291,116.435509;39.913555,116.356201 |
keyword |
是 |
搜索关键字,长度最大96个字节,注:keyword仅支持检索一个。 API采用UTF-8字符编码,1个英文字符占用1个字节,1个中文字符占3个字节,具体请参阅相关技术资料) |
keyword=美食 |
filter |
否 |
筛选条件 1. 指定分类筛选,语句格式为:category=分类名1,分类名2 分类词数量建议不超过5个,支持设置分类编码(支持的分类请参考:POI分类表) 2. 排除指定分类,语句格式为:category<>分类名1,分类名2分类词数量建议不超过5个,支持设置分类编码(支持的分类请参考:POI分类表) |
搜索指定分类filter=category=公交站 搜索多个分类filter=category=大学,中学 排除指定分类 filter=category<>商务楼宇 注意参数值要进行url编码) |
get_subpois |
否 |
是否返回子地点,如大厦停车场、出入口等取值: 0 [默认]不返回 1 返回 |
get_subpois=1 |
page_size |
否 |
每页条目数,最大限制为20条,默认为10条 |
page_size=10 |
page_index |
否 |
页码,默认第1页 |
page_index=1 |
output |
否 |
返回值类型:json、jsonp |
output=jsonp |
callback |
否 |
回调函数 |
callback=cb |
响应结果
名称 | 类型 | 必填 | 说明 |
status | number | 是 | 状态码,0为正常,其它为异常,详细请参阅状态码说明 |
message | string | 是 | 状态说明 |
count | number | 是 | 本次搜索结果总数,另外本服务限制最多返回200条数据(data), 翻页(page_index)超过搜索结果总数返回空,未超过搜索总数但超过200条限制时,将返回最后一页数据。 |
request_id | string | 是 | 本次请求的唯一标识,由系统自动生成,用于追查结果有异常时使用 |
data | array | 是 | 搜索结果POI(地点)数组,每项为一个POI(地点)对象 |
| id | string | 是 | POI(地点)唯一标识 |
| title | string | 是 | POI(地点)名称 |
| address | string | 是 | 地址 |
| tel | string | 是 | 电话 |
| category | string | 是 | POI(地点)分类 |
| type | number | 是 | POI类型,值说明:0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划 |
| location | object | 是 | 坐标 |
| lat | number | 是 | 纬度 |
| lng | number | 是 | 经度 |
| _distance | number | 是 | 距离,单位: 米,在周边搜索、城市范围搜索传入定位点时返回 |
| ad_info | object | 是 | 行政区划信息 |
| adcode | number | 是 | 行政区划代码,详见:行政区划代码说明 |
| province | string | 是 | 省 |
| city | string | 是 | 市,如果当前城市为省直辖县级区划,此字段会返回为空,由district字段返回。 注:省直辖县级区划adcode第3和第4位分别为9、0,如济源市adcode为419001 |
| district | string | 是 | 区 |
sub_pois | array | 否 | 子地点列表,仅在输入参数get_subpois=1时返回 |
| parent_id | string | 是 | 主地点ID,对应data中的地点ID |
id | string | 是 | 地点唯一标识 |
title | string | 是 | 地点名称 |
tel | string | 是 | 电话 |
category | string | 是 | POI(地点)分类 |
type | number | 是 | POI类型,值说明:0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划 |
address | string | 是 | 地址 |
location | object | 是 | 坐标 |
| lat | number | 是 | 纬度 |
lng | number | 是 | 经度 |
ad_info | object | 是 | 行政区划信息 |
| adcode | number | 是 | 行政区划代码,详见:行政区划代码说明 |
province | string | 是 | 省 |
city | string | 是 | 市,如果当前城市为省直辖县级区划,此字段会返回为空,由district字段返回。 注:省直辖县级区划adcode第3和第4位分别为9、0,如济源市adcode为419001 |
district | string | 是 | 区 |
调用示例
//GET请求示例,注意参数值要进行URL编码
https://apis.map.qq.com/ws/place/v1/search_by_polygon?polygon=39.932512,116.355515;39.933697,116.434650;39.913291,116.435509;39.913555,116.356201&keyword=公园&key=OB4BZ-D4W3U-*****
{
"status": 0,
"message": "Success",
"request_id": "29b9247f970b4d7290f0f65e91a2d5af",
"count": 109,
"data": [
{
"id": "18004506485022383500",
"title": "景山公园",
"address": "北京市西城区景山西街44号",
"category": "旅游景点:国家级景点",
"location": {
"lat": 39.925841,
"lng": 116.39677
},
"ad_info": {
"adcode": 110102,
"province": "北京市",
"city": "北京市",
"district": "西城区"
},
"tel": "010-64044071",
"type": 0
},
}
]
}
周边推荐(explore)
只需提供搜索中心点及半径(无须关键词),即可搜索获取周边高热度地点,
一般用于发送位置、门店签到等场景,自动为用户提供备选地点列表
![](http://p.qpic.cn/lbsconsole/0/2e516313fcb229c0d1366f42abdefeed/0)
请求URL
https://apis.map.qq.com/ws/place/v1/explore
请求参数
请求方式(Method): GET
参数 |
必填 |
说明 |
示例 |
key |
是 |
开发密钥(Key) |
key=OB4BZ-D4W3U-*** |
boundary |
是 |
格式: boundary=nearby(lat,lng,radius[, auto_extend]) 子参数: lat,lng:搜索中心点的经纬度,纬度在前,经度在后 radius:搜索半径,单位:米,取值范围:200到1000 auto_extend:[可选] 当前范围无结果时,是否自动扩大范围,取值: 0 不扩大 1 [默认] 自动扩大范围(依次按照按1公里、2公里、5公里,最大到全城市范围搜索) |
boundary=nearby(28.681114,115.918377,1000,1) |
policy |
否 |
搜索策略,可选值: 1 [默认]地点签到场景,针对用户签到的热门 地点进行优先排序。 2 位置共享场景,用于发送位置、位置分享等场景的热门地点优先排序 |
policy=1 |
filter |
否 |
筛选条件,支持指定分类筛选,语句格式为: category=分类名1,分类名2 分类词数量建议不超过5个(支持的分类请参考:POI分类表) |
搜索指定分类 filter=category=公交车站 分类编码:filter=category=271013 搜索多个分类 filter=category=大学,中学 分类编码:filter=category= 241000,241100 (注意参数值要进行url编码) |
orderby |
否 |
排序,支持按距离由近到远排序,取值:_distance 说明:周边搜索默认排序会综合考虑距离、权重等多方面因素,而设置按距离排序后则仅考虑距离远近,一些低权重的地点可能因距离近排在前面 |
orderby=_distance |
address_format |
否 |
地址格式,可选值:short,返回不包含省市区的短地址 (缺省则为包含省市区的标准地址) |
address_format=short |
page_size |
否 |
每页条目数,最大限制为20条,默认为10条 |
page_size=10 |
page_index |
否 |
第x页,默认第1页 |
page_index=2 |
output |
否 |
返回格式: 支持JSON/JSONP,默认JSON |
output=json |
callback |
否 |
JSONP方式回调函数 |
callback=function1 |
响应结果
名称 |
类型 |
必有 |
说明 |
status |
number |
是 |
状态码,0为正常,其它为异常,详细请参阅状态码说明 |
message |
string |
是 |
状态说明 |
count |
number |
是 |
本次搜索结果总数,另外本服务限制最多返回200条数据(data), 翻页(page_index)超过搜索结果总数 或 最大200条限制时,将返回最后一页数据。 |
request_id |
string |
是 |
本次请求的唯一标识,由系统自动生成,用于追查结果有异常时使用 |
data |
array |
是 |
搜索结果POI(地点)数组,每项为一个POI(地点)对象 |
|
id |
string |
是 |
POI(地点)唯一标识 |
|
title |
string |
是 |
POI(地点)名称 |
|
address |
string |
是 |
地址 |
|
category |
string |
是 |
POI(地点)分类 |
|
location |
object |
是 |
坐标 |
|
lat |
number |
是 |
纬度 |
|
lng |
number |
是 |
经度 |
|
_distance |
number |
是 |
与boundary传入的经纬度的距离,单位: 米 |
|
ad_info |
object |
是 |
行政区划信息 |
|
adcode |
number |
是 |
行政区划代码,详见:行政区划代码说明 |
|
province |
string |
是 |
省 |
|
city |
string |
是 |
市,如果当前城市为省直辖县级区划,city与district字段均会返回此城市 注:省直辖县级区划adcode第3和第4位分别为9、0,如济源市adcode为419001 |
|
district |
string |
是 |
区 |
调用示例
//GET请求
//周边推荐:boundary=nearby(lat,lng<中心坐标>,radius<半径/米>)
https://apis.map.qq.com/ws/place/v1/explore?boundary=nearby(40.040394,116.273523,1000)&policy=1&page_size=10&page_index=1&key=OB4BZ-D4W3U-*****
在线体验
周边推荐(here)
与explore相似,只需提供搜索中心点及半径(无须关键词),即可搜索获取周边高热度地点,
但本接口侧重于以地标+主要的路+近距离POI为主,着力描述当前位置,同时提供到家场景(如创建收货地址)、出行场景的地点推荐。
![](http://p.qpic.cn/lbsconsole/0/09903b0319326512a589540202554e35/0)
本服务属于高级服务,如需接入请在官网工单系统提交工单申请开通调用权限。
请求URL
https://apis.map.qq.com/ws/place/v1/here
请求参数
请求方式(Method): GET
参数 |
必填 |
说明 |
示例 |
key |
是 |
开发密钥(Key) |
key=OB4BZ-D4W3U-*** |
boundary |
是 |
格式: boundary=nearby(lat,lng,radius[, auto_extend]) 子参数: lat,lng:搜索中心点的经纬度,纬度在前,经度在后 radius:搜索半径,单位:米,取值范围:10到1000 |
boundary=nearby(28.681114,115.918377,1000) |
policy |
否 |
搜索策略: policy=1[默认] 以地标+主要的路+近距离POI为主,着力描述当前位置; policy=2 到家场景:筛选合适收货的POI,并会细化收货地址,精确到楼栋; policy=3 出行场景:过滤掉车辆不易到达的POI(如一些景区内POI),增加道路出入口、交叉口、大区域出入口类POI,排序会根据真实API大用户的用户点击自动优化。 |
policy=1 |
filter |
否 |
筛选条件,支持指定分类筛选,语句格式为: category=分类名1,分类名2 分类词数量建议不超过5个(支持的分类请参考:POI分类表) |
搜索指定分类 filter=category=公交站 搜索多个分类 filter=category=美食,购物 |
address_format |
否 |
地址格式,可选值:short,返回不包含省市区的短地址 (缺省则为包含省市区的标准地址) |
address_format=short |
page_size |
否 |
每页条目数,最大限制为20条,,默认为10条 |
page_size=10 |
page_index |
否 |
第x页,默认第1页 |
page_index=2 |
output |
否 |
返回格式: 支持JSON/JSONP,默认JSON |
output=json |
callback |
否 |
JSONP方式回调函数 |
callback=function1 |
响应结果
名称 |
类型 |
必有 |
说明 |
status |
number |
是 |
状态码,0为正常,其它为异常,详细请参阅状态码说明 |
message |
string |
是 |
状态说明 |
count |
number |
是 |
本次搜索结果总数,另外本服务限制最多返回200条数据(data), 翻页(page_index)超过搜索结果总数 或 最大200条限制时,将返回最后一页数据。 |
request_id |
string |
是 |
本次请求的唯一标识,由系统自动生成,用于追查结果有异常时使用 |
data |
array |
是 |
搜索结果POI(地点)数组,每项为一个POI(地点)对象 |
|
id |
string |
是 |
POI(地点)唯一标识 |
|
title |
string |
是 |
POI(地点)名称 |
|
address |
string |
是 |
地址 |
|
category |
string |
是 |
POI(地点)分类 |
|
location |
object |
是 |
坐标 |
|
lat |
number |
是 |
纬度 |
|
lng |
number |
是 |
经度 |
|
_distance |
number |
是 |
与boundary传入的经纬度的距离,单位: 米 |
|
ad_info |
object |
是 |
行政区划信息 |
|
adcode |
number |
是 |
行政区划代码,详见:行政区划代码说明 |
|
province |
string |
是 |
省 |
|
city |
string |
是 |
市,如果当前城市为省直辖县级区划,city与district字段均会返回此城市 注:省直辖县级区划adcode第3和第4位分别为9、0,如济源市adcode为419001 |
|
district |
string |
是 |
区 |
调用示例
//GET请求
//周边推荐:boundary=nearby(lat,lng<中心坐标>,radius<半径/米>)
https://apis.map.qq.com/ws/place/v1/here?boundary=nearby(40.040394,116.273523,1000)&policy=1&page_size=10&page_index=1&key=OB4BZ-D4W3U-*****
在线体验
ID查询(detail)
请求URL
https://apis.map.qq.com/ws/place/v1/detail
请求参数
请求方式(Method): GET
参数 |
必填 |
说明 |
示例 |
key |
是 |
开发密钥(Key) |
key=OB4BZ-D4W3U-***** |
id |
是 |
腾讯地图POI(地点)唯一标识,支持多poiid检索,最大支持10个,用英文逗号分隔 |
id=6621879543162709731 |
output |
否 |
返回格式: 支持JSON/JSONP,默认JSON |
output=json |
callback |
否 |
JSONP方式回调函数 |
callback=function1 |
响应结果
名称 |
类型 |
必有 |
说明 |
status |
number |
是 |
状态码,0为正常,其它为异常,详细请参阅状态码说明 |
message |
string |
是 |
状态说明 |
count |
number |
是 |
本次搜索结果总数 |
request_id |
string |
是 |
本次请求的唯一标识,由系统自动生成,用于追查结果有异常时使用 |
data |
array |
是 |
搜索结果POI(地点)数组,每项为一个POI(地点)对象 |
|
id |
string |
是 |
POI(地点)唯一标识 |
|
title |
string |
是 |
POI(地点)名称 |
|
address |
string |
是 |
地址 |
|
tel |
string |
是 |
电话 |
|
category |
string |
是 |
POI(地点)分类 |
|
type |
number |
是 |
POI类型,值说明:0:普通POI / 1:公交车站 / 2:地铁站 / 3:公交线路 / 4:行政区划 |
|
location |
object |
是 |
坐标 |
|
lat |
number |
是 |
纬度 |
|
lng |
number |
是 |
经度 |
|
ad_info |
object |
是 |
行政区划信息 |
|
adcode |
number |
是 |
行政区划代码,详见:行政区划代码说明 |
|
province |
string |
是 |
省 |
|
city |
string |
是 |
市,如果当前城市为省直辖县级区划,此字段会返回为空,由district字段返回。 注:省直辖县级区划adcode第3和第4位分别为9、0,如济源市adcode为419001 |
|
district |
string |
是 |
区/县,当type(POI类型)为3(公交线路)时,district由city补全 |
调用示例
//GET请求
//查询ID为6621879543162709731的地点信息
https://apis.map.qq.com/ws/place/v1/detail?id=6621879543162709731&key=OB4BZ-D4W3U-*****
在线体验