WebService API / 开发指南 / 地点搜索

正在跳转至目标页，请稍后…

概述

   提供多种搜索功能：

  • 指定城市/区域搜索：如在北京搜索景点。新增高级参数：支持获取车站、机场、园区等较大范围地点的子点和出入口热度，辅助用户选择准确目的地。
  • 周边搜索：如，搜索颐和园附近半径500米内的酒店（一个圆形范围）；
  • 矩形范围搜索：在地图应用中，往往用于视野内搜索，因为显示地图的区域是个矩形。
  • 多边形范围搜索：自定义多边形范围进行地点搜索，由此您可以更好地控制搜索范围的准确性。
  • 周边推荐：只需提供中心点及半径（无须关键词），即可搜索获取周边高热度地点，一般用于发送位置、地点签到等场景，自动为用户提供备选地点列表
  • id查询POI信息：通过POI ID查询POI信息

周边搜索

请求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-*****

在线体验

boundary
page_size
page_index
keyword
key请在实际请求时传入您的key
apptag
反馈




城市/区域搜索




请求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




返回子点热度
否
支持获取车站、机场、园区等较大范围地点的子点和出入口热度，辅助用户选择准确目的地。
本参数属于高级付费参数，如需试用请提交商务合作开通试用。






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的搜索结果在各城市无明显权重特别高的时，将返回各城市搜索结果数量的统计数，您可以将此统计结果展示给用户，供用户缩小城市范围，再次发起搜索使用。








名称
类型
必有
说明






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-*****





在线体验


boundary
page_size
page_index
keyword
filter
key请在实际请求时传入您的key


apptag
反馈


调用示例：按城市统计结果




//GET请求示例，注意参数值要进行URL编码

https://apis.map.qq.com/ws/place/v1/search?boundary=region(全国)&keyword=博物馆&key=OB4BZ-D4W3U-*****




在线体验


boundary
keyword
key请在实际请求时传入您的key
apptag
反馈




矩形范围(屏幕视野内)搜索




请求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-*****




在线体验


boundary
page_size
page_index
keyword
key请在实际请求时传入您的key
apptag
反馈




多边形范围搜索


本接口提供基于多边形范围的地点搜索能力。

注：

本服务属于高级付费服务，如需试用请提交商务合作开通服务试用。




请求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）


只需提供搜索中心点及半径（无须关键词），即可搜索获取周边高热度地点，
一般用于发送位置、门店签到等场景，自动为用户提供备选地点列表




请求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-*****




在线体验


boundary
page_size
page_index
policy
key请在实际请求时传入您的key
apptag
反馈




周边推荐（here）


与explore相似，只需提供搜索中心点及半径（无须关键词），即可搜索获取周边高热度地点，


但本接口侧重于以地标+主要的路+近距离POI为主，着力描述当前位置，同时提供到家场景（如创建收货地址）、出行场景的地点推荐。





本服务属于高级服务，如需接入请在官网工单系统提交工单申请开通调用权限。


请求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-*****




在线体验


boundary
page_size
page_index
policy
key请在实际请求时传入您的key
反馈




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-*****




在线体验


id
key请在实际请求时传入您的key
apptag
反馈


 

              这篇文章对您解决问题是否有帮助？
            
 
已解决  
 

              未解决