浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
圆形区域检索参数
第1行: 第1行:
 
{{webapi-sidebar}}
 
{{webapi-sidebar}}
==产品介绍==
+
<div class="labels"><div class="interiorNav"><div class="interiorLI">服务介绍</div><div class="interiorLI">服务文档</div><div class="interiorLI">使用指南</div><div class="interiorLI">常见问题</div><div class="interiorLI">更新日志</div><div class="interiorLI">资源下载</div></div></div><div class="contents"><div class="navRemark"><div class="handpointto">内容(服务介绍)</div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">地点检索服务</div></div><div class="serve-explain-text">
Place API 是一类简单的接口,用于返回查询某个区域的某类POI数据,且提供单个POI的详情查询服务,用户可以使用C#、C++、Java等开发语言发送请求且接收json、xml的数据。<br>
+
地点检索服务(又名Place API)是一类Web API接口服务;<br/>服务提供多种场景的地点(POI)检索功能,包括城市检索、周边检索、矩形区域检索。开发者可通过接口获取地点(POI)基础或详细地理信息。
Place API 已全面支持HTTP/HTTPS两种请求形式。后文介绍中以HTTP请求为例。
+
</div><div class="bluetitle"><div class="services-title-text">功能介绍</div></div><div class="serveintor-min"><div class="serveintortxt"><div class="serveintorleft"><div class="serveintoor-title">行政区划区域检索</div>
==坐标系说明==
+
开发者可通过该功能,检索某一行政区划内(目前最细到城市级别)的地点信息。
WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。
+
</div><div class="serveintorright">
 
+
http://mapopen-pub-webserviceapi.bj.bcebos.com/images/place1.png
 
+
</div></div><div class="serveintortxt"><div class="serveintorleft"><div class="serveintoor-title">圆形区域检索</div>
GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
+
开发者可设置圆心和半径,检索圆形区域内的地点信息(常用于周边检索场景)。
 
+
</div><div class="serveintorright">
 
+
http://mapopen-pub-webserviceapi.bj.bcebos.com/images/place2.png
BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标
+
</div></div><div class="serveintortxt"><div class="serveintorleft"><div class="serveintoor-title">矩形区域检索</div>
 
+
开发者可设置检索区域左下角和右上角坐标,检索坐标对应矩形内的地点信息(常用于手机或PC端地图视野内检索)
 
+
</div><div class="serveintorright">
Place API默认输入输出坐标类型为百度坐标(bd09ll),同时可通过参数("coord_type","ret_coordtype")控制输入输出坐标类型。
+
http://mapopen-pub-webserviceapi.bj.bcebos.com/images/place3.png
 
+
</div></div><div class="serveintortxt"><div class="serveintorleft"><div class="serveintoor-title">地点详情检索</div>
输入坐标支持以上三种坐标系,输出坐标支持-国测局坐标(GCJ02)和百度坐标(BD09)
+
不同于以上三种检索功能。地点详情检索针对指定POI,检索其相关的详情信息。开发者可以通过三种区域检索(或其他服务)功能,获取POI&nbsp;id。使用“地点详情检索”功能,传入id,即可检索POI详情信息,如评分、营业时间等(不同类型POI对应不同类别详情数据)。
 
+
</div><div class="serveintorright">
 
+
http://mapopen-pub-webserviceapi.bj.bcebos.com/images/place4.png
<p style="color:red">注意:不同类型坐标如需转换,请使用百度地图开放平台提供的[http://lbsyun.baidu.com/index.php?title=webapi/guide/changeposition 标准坐标转换接口]。请勿使用其他渠道提供的坐标转换方法,以免影响坐标转换精度。
+
</div></div></div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">接口功能介绍<br/></div></div><div class="serve-explain-text"><div class="serveintoor-title service-page-anchor">行政区划区域检索</div><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/place/v2/search?query=ATM机&tag=银行&region=北京&output=json&ak=您的ak //GET请求
 
+
</pre>
==功能介绍==
+
</div></div><div class="separate-title">请求参数</div>
Place API 提供区域检索POI服务与POI详情服务。
+
 
+
1. 区域检索POI服务提供三种区域检索方法:
+
 
+
{{bluepoint}}城市内检索(对应JavaScriptAPI的Search方法)
+
 
+
{{bluepoint}}矩形检索(对应JavaScript API的SearchInBound方法)
+
 
+
{{bluepoint}}圆形区域检索(对应JavaScript的SearchNearBy方法)。
+
 
+
2. POI详情服务提供查询单个POI的详情信息,如好评。
+
 
+
==使用说明==
+
 
+
'''使用限制:'''
+
 
+
{{bluepoint}}
+
使用Place API服务前,首先需要登录[http://lbsyun.baidu.com/apiconsole/key API控制台]申请密钥ak。
+
 
+
{{bluepoint}}
+
每个开发者账号每天调用Place API服务的总次数(即配额)是有限的。
+
 
+
{{bluepoint}}
+
每个开发者账号每分钟调用Place API服务的次数(即并发量)是有限的。
+
 
+
{{bluepoint}}
+
若需更高配额和并发量,请申请[http://lbsyun.baidu.com/apiconsole/auth 开发者认证]以获取更高配额和更及时的技术支持。
+
 
+
{{bluepoint}}
+
同一个帐号下的HTTP/HTTPS请求,配额、并发共享。
+
<br><br>
+
默认配额及并发量说明如下:
+
<table>
+
        <tr style="text-align: center;">
+
            <th style="text-align: center;" width="200"> 分类 </th>
+
            <th style="text-align: center;" width="200"> 未认证 </th>
+
            <th style="text-align: center;" width="200"> 个人认证 </th>
+
            <th style="text-align: center;" width="200"> 企业认证 </th>
+
        </tr>
+
        <tr style="text-align: center;">
+
            <td>日配额(次) </td>
+
            <td>2,000 </td>
+
            <td>30,000 </td>
+
            <td>300,000 </td>
+
        </tr>
+
        <tr style="text-align: center;">
+
            <td>分钟并发量(次/分钟) </td>
+
            <td>120 </td>
+
            <td>3,000 </td>
+
            <td>12,000 </td>
+
        </tr>
+
 
+
</table>
+
 
+
'''使用方法:'''
+
 
+
第一步,[http://lbsyun.baidu.com/apiconsole/key?application=key 申请密钥(ak)] ,作为访问服务的依据;
+
 
+
第二步,按照请求参数说明拼写发送HTTP/HTTPS请求的url,注意需使用第一步申请的ak;
+
 
+
第三步,接收返回的数据(json或xml格式)。
+
 
+
'''Hello, World示例:'''
+
 
+
以下是一个关于place API的简单示例,设置检索城市为北京,检索关键字为“饭店”,检索后返回10条数据。
+
 
+
<source>
+
http://api.map.baidu.com/place/v2/search?q=饭店&region=北京&output=json&ak=您的AK
+
</source>
+
 
+
==Place服务地址==
+
百度地图Place API服务地址:
+
 
+
<source>
+
http://api.map.baidu.com/place/v2/search //v2 place区域检索POI服务
+
 
+
http://api.map.baidu.com/place/v2/detail //v2 POI详情服务
+
 
+
</source>
+
 
+
组成说明:
+
 
+
{{bluepoint}}域名:api.map.baidu.com
+
 
+
{{bluepoint}}服务名:place
+
 
+
{{bluepoint}}服务版本号:较之前版本,v2版本新增参数。
+
 
+
{{bluepoint}}Place方法名:如search表示区域POI查询,detail表示POI详情。
+
 
+
==Place区域检索POI服务==
+
 
+
'''服务地址:'''
+
 
+
<source>
+
http://api.map.baidu.com/place/v2/search
+
</source>
+
 
+
===Place区域检索通用接口参数===
+
以下参数,适用于三种区域检索方法的Place API。
+
 
+
 
{|
 
{|
 
|-
 
|-
!width="96" |参数
+
! width="100" | 参数名
!width="70" |是否必须
+
! width="660" | 参数含义
!width="60" |默认值
+
! width="70" | 类型
!width="180" |格式举例
+
! width="50" style="width: 159px;" | 示例
!width="295" |含义
+
! width="100" style="width: 138px;" | 是否必须
 
|-
 
|-
|q(query)
+
| query
|
+
| 检索关键字。周边检索和矩形区域内检索支持多个关键字并集检索,不同关键字间以$符号分隔,最多支持10个关键字检索。如:”银行$酒店”
|
+
| string(45)
|中关村、ATM、百度大厦
+
| style="width: 141px;" | 天安门
|
+
| style="width: 120px;" | query和tag参数请求时至少传入一个
检索关键字,周边检索和矩形区域内检索支持多个关键字并集检索,不同关键字间以$符号分隔,最多支持10个关键字检索。如:”银行$酒店”。
+
 
|-
 
|-
|tag  
+
| tag
|
+
| 检索分类,与q组合进行检索,多个分类以","分隔<br/>[http://lbsyun.baidu.com/index.php?title=lbscloud/poitags POI分类])<br/>
|无
+
| string(50)
|日式烧烤/铁板烧、朝外大街
+
| style="width: 141px;" | 美食
|
+
| style="width: 120px;" | query和tag参数请求时至少传入一个
标签项,与q组合进行检索,以“,”分隔 <br>   [http://lbsyun.baidu.com/index.php?title=lbscloud/poitags 百度poi分类]
+
 
|-
 
|-
|output
+
| region
|
+
| 检索行政区划区域(增加区域内数据召回权重,如需严格限制召回数据在区域内,请搭配使用city_limit参数),可输入行政区划名或对应[http://wiki.lbsyun.baidu.com/cms/citycode/BaiduMap_cityCode_1102.zip cityCode]
|xml
+
| string(50)
|json或xml
+
| style="width: 141px;" | 北京、131
|
+
| style="width: 120px;" | 可选
输出格式为json或者xml
+
 
|-
 
|-
|scope
+
| city_limit
|
+
| 区域数据召回限制,为true时,仅召回region对应区域内数据。
|1
+
| string(50)
|1、2
+
| style="width: 141px;" | true、false
|
+
| style="width: 120px;" | 可选
检索结果详细程度。取值为1 或空,则返回基本信息;取值为2,返回检索POI详细信息
+
|-
|-  
+
| output
|filter
+
| 输出格式为json或者xml
|
+
| string(50)
|
+
| style="width: 141px;" | json或xml
|<nowiki>filter=industry_type:cater|
+
| style="width: 120px;" | 可选
sort_name:distance|sort_rule:1</nowiki>  
+
|-
|
+
| scope
检索过滤条件,当scope取值为2时,可以设置filter进行排序。
+
| 检索结果详细程度。取值为1 或空,则返回基本信息;取值为2,返回检索POI详细信息
 +
| string(50)
 +
| style="width: 141px;" | 1、2
 +
| style="width: 120px;" | 可选
 +
|-
 +
| filter
 +
| 检索过滤条件。当scope取值为2时,可以设置filter进行排序。
 +
industry_type:行业类型,注意:设置该字段可提高检索速度和过滤精度,取值有: hotel(宾馆);cater(餐饮);life(生活娱乐) sort_name:排序字段,根据industry_type字段的值而定。 1、industry_type为hotel时,sort_name取值有: default(默认);price(价格);total_score(好评);level(星级);health_score(卫生);distance(距离排序,只有周边检索有效) 2、industry_type为cater时,sort_name取值有: default(默认);taste_rating(口味);price(价格);overall_rating(好评);service_rating(服务);distance(距离排序,只有周边检索有效) 3、industry_type为life时,sort_name取值有: default(默认);price(价格);overall_rating(好评);comment_num(服务);distance(距离排序,只有周边检索有效)<br/>'''sort_rule''':排序规则:0(从高到低),1(从低到高)<br/>'''price_section''':价格区间<br/>'''groupon''':是否有团购:1(有),0(无)<br/>'''discount''':是否有打折:1(有),0(无)
  
{{bluepoint}}'''industry_type''':行业类型,注意:设置该字段可提高检索速度和过滤精度,取值有:
+
| string(50)
hotel(宾馆);cater(餐饮);life(生活娱乐)
+
| style="width: 141px;" | sort_name:distance&#124;sort_rule:1
 +
| style="width: 120px;" | 可选
 +
|-
 +
| coord_type
 +
| 坐标类型,1(wgs84ll即GPS经纬度),2(gcj02ll即国测局经纬度坐标),3(bd09ll即百度经纬度坐标),4(bd09mc即百度米制坐标)<br/>[http://lbsyun.baidu.com/index.php?title=coordinate 坐标详细说明]
 +
| int
 +
| style="width: 141px;" | 1、2、3(默认)、4
 +
| style="width: 120px;" | 可选
 +
|-
 +
| ret_coordtype
 +
| 可选参数,添加后POI返回国测局经纬度坐标<br/>[http://lbsyun.baidu.com/index.php?title=coordinate 坐标详细说明]
 +
| string(50)
 +
| style="width: 141px;" | gcj02ll
 +
| style="width: 120px;" | 可选
 +
|-
 +
| page_size
 +
| 单次召回POI数量,默认为10条记录,最大返回20条。多关键字检索时,返回的记录数为关键字个数*page_size。
 +
| int
 +
| style="width: 141px;" | 10
 +
| style="width: 120px;" | 可选
 +
|-
 +
| page_num
 +
| 分页页码,默认为0,0代表第一页,1代表第二页,以此类推。
 +
常与page_size搭配使用。
  
{{bluepoint}}'''sort_name''':排序字段,根据industry_type字段的值而定。
+
| int
 +
| style="width: 141px;" | 0、1、2
 +
| style="width: 120px;" | 可选
 +
|-
 +
| ak
 +
| 开发者的访问密钥,必填项。v2之前该属性为key。
 +
[http://lbsyun.baidu.com/apiconsole/key/create 申请秘钥]
  
1、industry_type为hotel时,sort_name取值有:
+
| string(50)
default(默认);price(价格);total_score(好评);level(星级);health_score(卫生);distance(距离排序,只有周边检索有效)
+
| style="width: 141px;" |
 +
| style="width: 120px;" | 必须
 +
|-
 +
| sn
 +
| 开发者的权限签名。
 +
[http://lbsyun.baidu.com/index.php?title=webapi/appendix Sn校验说明]
  
2、industry_type为cater时,sort_name取值有:
+
| string(50)
default(默认);taste_rating(口味);price(价格);overall_rating(好评);service_rating(服务);distance(距离排序,只有周边检索有效)
+
| style="width: 141px;" |
 +
| style="width: 120px;" | 可选,若开发者所用AK的校验方式为SN校验时该参数必须。
 +
|-
 +
| timestamp
 +
| 设置sn后该值必填。
 +
| string(50)
 +
| style="width: 141px;" |
 +
| style="width: 120px;" | 设置sn后该值必填。
 +
|}
  
3、industry_type为life时,sort_name取值有:
+
返回参数见下方页面内容
default(默认);price(价格);overall_rating(好评);comment_num(服务);distance(距离排序,只有周边检索有效)
+
  
{{bluepoint}} '''sort_rule''':排序规则:0(从高到低),1(从低到高)
 
  
{{bluepoint}} '''price_section''':价格区间
+
<div class="serve-explain-text"><div class="serveintoor-title service-page-anchor">周边检索</div><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/place/v2/search?query=银行&location=39.915,116.404&radius=2000&output=xml&ak=您的密钥 //GET请求
 +
</pre>
 +
</div></div><div class="separate-title">请求参数<br/></div>
 +
{|
 +
|-
 +
! width="100" | 参数名
 +
! width="610" | 参数含义
 +
! width="70" | 类型
 +
! width="100" | 示例
 +
! width="100" | 是否必须
 +
|-
 +
| query
 +
| 检索关键字。周边检索和矩形区域内检索支持多个关键字并集检索,不同关键字间以$符号分隔,最多支持10个关键字检索。如:”银行$酒店”
 +
| string(45)
 +
| 天安门
 +
| query和tag参数请求时至少传入一个
 +
|-
 +
| tag
 +
| 检索分类,与q组合进行检索,多个分类以","分隔<br/>([http://lbsyun.baidu.com/index.php?title=lbscloud/poitags POI分类])<br/>
 +
| string(50)
 +
| 美食
 +
| query和tag参数请求时至少传入一个
 +
|-
 +
| location
 +
| 周边检索中心点,不支持多个点
 +
| string(50)
 +
| 38.76623,116.43213
 +
lat&lt;纬度&gt;,lng&lt;经度&gt;
  
{{bluepoint}} '''groupon''':是否有团购:1(有),0(无)
+
| 必须
 
+
|-
{{bluepoint}} '''discount''':是否有打折:1(有),0(无)
+
| radius
 +
| 周边检索半径,单位为米。(当半径过大,超过中心点所在城市边界时,会变为城市范围检索,检索范围为中心点所在城市)
 +
| string(50)
 +
| 1000(默认)
 +
| 可选
 +
|-
 +
| radius_limit<br/>
 +
| 是否严格限定召回结果在设置检索半径范围内。true(是),false(否)。设置为true时会影响返回结果中total准确性及每页召回poi数量,我们会逐步解决此类问题。<br/>
 +
| string(50)<br/>
 +
| false
 +
| 可选<br/>
 +
|-
 +
| output
 +
| 输出格式为json或者xml
 +
| string(50)
 +
| json或xml
 +
| 可选
 +
|-
 +
| scope
 +
| 检索结果详细程度。取值为1 或空,则返回基本信息;取值为2,返回检索POI详细信息
 +
| string(50)
 +
| 1、2
 +
| 可选
 +
|-
 +
| filter
 +
| 检索过滤条件。当scope取值为2时,可以设置filter进行排序。
 +
industry_type:行业类型,注意:设置该字段可提高检索速度和过滤精度,取值有: hotel(宾馆);cater(餐饮);life(生活娱乐) sort_name:排序字段,根据industry_type字段的值而定。 1、industry_type为hotel时,sort_name取值有: default(默认);price(价格);total_score(好评);level(星级);health_score(卫生);distance(距离排序,只有周边检索有效) 2、industry_type为cater时,sort_name取值有: default(默认);taste_rating(口味);price(价格);overall_rating(好评);service_rating(服务);distance(距离排序,只有周边检索有效) 3、industry_type为life时,sort_name取值有: default(默认);price(价格);overall_rating(好评);comment_num(服务);distance(距离排序,只有周边检索有效)<br/>'''sort_rule''':排序规则:0(从高到低),1(从低到高)<br/>'''price_section''':价格区间<br/>'''groupon''':是否有团购:1(有),0(无)<br/>'''discount''':是否有打折:1(有),0(无)
  
 +
| string(50)
 +
| sort_name:distance&#124;sort_rule:1
 +
| 可选
 
|-
 
|-
|coord_type  
+
| coord_type
|
+
| 坐标类型,1(wgs84ll即GPS经纬度),2(gcj02ll即国测局经纬度坐标),3(bd09ll即百度经纬度坐标),4(bd09mc即百度米制坐标)<br/>[http://lbsyun.baidu.com/index.php?title=coordinate 坐标详细说明]
|3
+
| int
|1、2、3、4
+
| 1、2、3(默认)、4
|
+
| 可选
坐标类型,1(wgs84ll即GPS经纬度),2(gcj02ll即国测局经纬度坐标),3(bd09ll即百度经纬度坐标),4(bd09mc即百度米制坐标)
+
 
|-
 
|-
|ret_coordtype  
+
| ret_coordtype
|
+
| 可选参数,添加后POI返回国测局经纬度坐标<br/>[http://lbsyun.baidu.com/index.php?title=coordinate 坐标详细说明]
|
+
| string(50)
|gcj02ll
+
| gcj02ll
|
+
| 可选
可选参数,添加后POI返回国测局经纬度坐标
+
 
|-
 
|-
|page_size  
+
| page_size
|
+
| 单次召回POI数量,默认为10条记录,最大返回20条。多关键字检索时,返回的记录数为关键字个数*page_size。
|10
+
| int
|10  
+
| 10
|
+
| 可选
范围记录数量,默认为10条记录,最大返回20条。多关键字检索时,返回的记录数为关键字个数*page_size。
+
 
|-
 
|-
|page_num  
+
| page_num
|
+
| 分页页码,默认为0,0代表第一页,1代表第二页,以此类推。
|0
+
常与page_size搭配使用。
|0、1、2  
+
 
|
+
| int
分页页码,默认为0,0代表第一页,1代表第二页,以此类推。
+
| 0、1、2
 +
| 可选
 
|-
 
|-
|ak  
+
| ak
|
+
| 开发者的访问密钥,必填项。v2之前该属性为key。
|无
+
[http://lbsyun.baidu.com/apiconsole/key/create 申请秘钥]
|
+
 
|
+
| string(50)
用户的访问密钥,必填项。v2之前该属性为key。
+
|  
 +
| 必须
 
|-
 
|-
|sn  
+
| sn
|
+
| 开发者的权限签名。
|
+
[http://lbsyun.baidu.com/index.php?title=webapi/appendix Sn校验说明]
 +
 
 +
| string(50)
 
|  
 
|  
|
+
| 可选,若开发者所用AK的校验方式为SN校验时该参数必须。
用户的权限签名。
+
|-
|-  
+
| timestamp
|timestamp  
+
| 设置sn后该值必填。
|
+
| string(50)
|
+
 
|  
 
|  
|
+
| 设置sn后该值必填。
设置sn后该值必填。  
+
 
|}
 
|}
'''编码说明:'''
+
<div class="serve-explain-text"><div class="serveintoor-title service-page-anchor">矩形区域检索</div><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/place/v2/search?query=银行&bounds=39.915,116.404,39.975,116.414&output=json&ak={您的密钥} //GET请求
 
+
</pre>
对于query和region参数,因为这两个参数取值可以是中文或一些特殊字符(如:空格),举例:query可以取值“小吃”,region可以取值“北京”,为了避免提交到后台乱码,所以对于这2个参数值进行编码处理,编码成 UTF-8 字符的二字符十六进制值。 query和region参数取值时候,凡是不在下表中的字符都要进行编码。
+
</div></div><div class="separate-title">请求参数</div>
 
+
 
{|
 
{|
 
|-
 
|-
!width="74" |字符集合
+
! width="100" | 参数名
!width="500" |字符
+
! width="610" | 参数含义
 +
! width="70" | 类型
 +
! width="100" | 示例
 +
! width="100" | 是否必须
 
|-
 
|-
|URL非保留字
+
| query
|a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~
+
| 检索关键字。周边检索和矩形区域内检索支持多个关键字并集检索,不同关键字间以$符号分隔,最多支持10个关键字检索。如:”银行$酒店”
 +
| string(45)
 +
| 天安门
 +
| query和tag参数请求时至少传入一个
 
|-
 
|-
|URL保留字
+
| tag
|! * ' ( ) ; : @ & = + $ , / ? % # [ ]
+
| 检索分类,与q组合进行检索,多个分类以","分隔<br/>([http://lbsyun.baidu.com/index.php?title=lbscloud/poitags POI分类])<br/>
|}
+
| string(50)
如果query和region参数中使用URL保留字字符的字面意思,例如:query关键字取值为"?小吃",检索关键字包含一个问号,此问号也必须进行编码,"?"的16进制编码为"%3F",所以整个检索关键字"?小吃"编码后为"%3F%E5%B0%8F%E5%90%83"。
+
| 美食
 
+
| query和tag参数请求时至少传入一个
附注:
+
 
+
(1) javascript中一般采用encodeURIComponent函数对特殊字符进行编码。
+
 
+
(2) Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
+
 
+
(3) C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
+
 
+
(4) php中可以使用函数urlencode对特殊字符进行编码。
+
 
+
===Place检索示例:===
+
====城市内检索====
+
<source>
+
http://api.map.baidu.com/place/v2/search?query=银行&page_size=10&page_num=0&scope=1&region=北京&output=json&ak={您的密钥}
+
</source>
+
====矩形区域检索====
+
<source>
+
http://api.map.baidu.com/place/v2/search?query=美食&page_size=10&page_num=0&scope=1&bounds=39.915,116.404,39.975,116.414&output=json&ak={您的密钥}
+
</source>
+
====圆形区域检索====
+
<source>
+
http://api.map.baidu.com/place/v2/search?query=酒店&page_size=10&page_num=0&scope=1&location=39.915,116.404&radius=2000&output=json&ak={您的密钥}
+
 
+
//多关键词并集检索
+
http://api.map.baidu.com/place/v2/search?query=酒店$银行&scope=2&output=json&location=39.915,116.404&radius=2000&filter=sort_name:distance|sort_rule:1&ak={您的密钥}
+
</source>
+
 
+
===Place区域检索示例方法===
+
Place API根据支持检索的区域类型,提供城市内、矩形、圆形三种检索方法,使用说明如下:
+
 
+
====城市内检索请求参数====
+
 
+
{|
+
 
|-
 
|-
!width="96" |参数
+
| bounds
!width="70" |是否必须
+
| 检索矩形区域,多组坐标间以","分隔
!width="60" |默认值
+
| string(50)
!width="220" |格式举例
+
| 38.76623,116.43213,39.54321,116.46773 lat,lng(左下角坐标),lat,lng(右上角坐标)
!width="255" |含义
+
| 必须
 
|-
 
|-
|region
+
| output
|
+
| 输出格式为json或者xml
|
+
| string(50)
|北京、131、全国
+
| json或xml
|检索区域(市级以上行政区域),如果取值为“全国”或某省份,则返回指定区域的POI及数量。
+
| 可选
 
|-
 
|-
|city_limit
+
| scope
|
+
| 检索结果详细程度。取值为1 或空,则返回基本信息;取值为2,返回检索POI详细信息
|false
+
| string(50)
|  
+
| 1、2
|是否只返回指定region(城市)内的POI,true(是),false(否)。
+
| 可选
|}
+
|-
'''城市检索示例(返回json数据):'''
+
| filter
 
+
| 检索过滤条件。当scope取值为2时,可以设置filter进行排序。
<source>
+
industry_type:行业类型,注意:设置该字段可提高检索速度和过滤精度,取值有: hotel(宾馆);cater(餐饮);life(生活娱乐) sort_name:排序字段,根据industry_type字段的值而定。 1、industry_type为hotel时,sort_name取值有: default(默认);price(价格);total_score(好评);level(星级);health_score(卫生);distance(距离排序,只有周边检索有效) 2、industry_type为cater时,sort_name取值有: default(默认);taste_rating(口味);price(价格);overall_rating(好评);service_rating(服务);distance(距离排序,只有周边检索有效) 3、industry_type为life时,sort_name取值有: default(默认);price(价格);overall_rating(好评);comment_num(服务);distance(距离排序,只有周边检索有效)<br/>'''sort_rule''':排序规则:0(从高到低),1(从低到高)<br/>'''price_section''':价格区间<br/>'''groupon''':是否有团购:1(有),0(无)<br/>'''discount''':是否有打折:1(有),0(无)
http://api.map.baidu.com/place/v2/search?query=百度大厦&region=深圳&city_limit=true&output=json&ak={您的密钥}
+
</source>
+
  
====矩形区域检索参数====
+
| string(50)
 
+
| sort_name:distance&#124;sort_rule:1
{|
+
| 可选
 
|-
 
|-
!width="96" |参数
+
| coord_type
!width="70" |是否必须
+
| 坐标类型,1(wgs84ll即GPS经纬度),2(gcj02ll即国测局经纬度坐标),3(bd09ll即百度经纬度坐标),4(bd09mc即百度米制坐标)<br/>[http://lbsyun.baidu.com/index.php?title=coordinate 坐标详细说明]
!width="60" |默认值
+
| int
!width="220" |格式举例
+
| 1、2、3(默认)、4
!width="255" |含义
+
| 可选
 
|-
 
|-
|bounds(bds)  
+
| ret_coordtype
|
+
| 可选参数,添加后POI返回国测局经纬度坐标<br/>[http://lbsyun.baidu.com/index.php?title=coordinate 坐标详细说明]
|
+
| string(50)
|38.76623,116.43213,39.54321,116.46773 lat,lng(左下角坐标),lat,lng(右上角坐标)
+
| gcj02ll
|检索矩形区域
+
| 可选
|}
+
|-
'''矩形检索示例(返回json数据): '''
+
| page_size
 +
| 单次召回POI数量,默认为10条记录,最大返回20条。多关键字检索时,返回的记录数为关键字个数*page_size。
 +
| int
 +
| 10
 +
| 可选
 +
|-
 +
| page_num
 +
| 分页页码,默认为0,0代表第一页,1代表第二页,以此类推。
 +
常与page_size搭配使用。
  
<source>
+
| int
http://api.map.baidu.com/place/v2/search?query=银行&bounds=39.915,116.404,39.975,116.414&output=json&ak={您的密钥}
+
| 0、1、2
</source>
+
| 可选
 +
|-
 +
| ak
 +
| 开发者的访问密钥,必填项。v2之前该属性为key。
 +
[http://lbsyun.baidu.com/apiconsole/key/create 申请秘钥]
  
====圆形区域检索参数====
+
| string(50)
 +
|
 +
| 必须
 +
|-
 +
| sn
 +
| 开发者的权限签名。
 +
[http://lbsyun.baidu.com/index.php?title=webapi/appendix Sn校验说明]
  
 +
| string(50)
 +
|
 +
| 可选,若开发者所用AK的校验方式为SN校验时该参数必须。
 +
|-
 +
| timestamp
 +
| 设置sn后该值必填。
 +
| string(50)
 +
|
 +
| 设置sn后该值必填。
 +
|}
 +
<div class="separate-title">返回参数(行政区划区域检索、周边检索、矩形区域检索)</div>
 
{|
 
{|
 
|-
 
|-
!width="96" |参数
+
! width="80" colspan="2" | 名称
!width="70" |是否必须
+
! width="80" | 类型
!width="60" |默认值
+
! 说明
!width="220" |格式举例
+
!width="255" |含义 
+
 
|-
 
|-
|location
+
| colspan="2" | status
|
+
| Int
|
+
| 本次API访问状态,如果成功返回0,如果失败返回其他数字。(见服务状态码)
|38.76623,116.43213
+
lat<纬度>,lng<经度>
+
|周边检索中心点,不支持多个点
+
 
|-
 
|-
|radius(r)
+
| colspan="2" | message
|否
+
| string
|
+
| 对API访问状态值的英文说明,如果成功返回"ok",并返回结果字段,如果失败返回错误说明。
|2000
+
|周边检索半径,单位为米
+
 
|-
 
|-
|radius_limit
+
| colspan="2" | total
|
+
| int
|false
+
| POI检索总数,开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的,单次请求total最多为400。
|false、true
+
|-
|是否严格限定召回结果在设置检索半径范围内。true(是),false(否)。设置为true时会影响返回结果中total准确性及每页召回poi数量,我们会逐步解决此类问题。
+
| colspan="2" | name
 +
| string
 +
| poi名称
 +
|-
 +
| colspan="2" | location
 +
| object
 +
| poi经纬度坐标
 +
|-
 +
| rowspan="2" |
 +
| lat
 +
| float
 +
| 纬度值
 +
|-
 +
| lng
 +
| float
 +
| 经度值
 +
|-
 +
| colspan="2" | address
 +
| string
 +
| poi地址信息
 +
|-
 +
| colspan="2" | telephone
 +
| string
 +
| poi电话信息
 +
|-
 +
| colspan="2" | uid
 +
| string
 +
| poi的唯一标示
 +
|-
 +
| colspan="2" | street_id
 +
| string
 +
| 街景图id
 +
|-
 +
| colspan="2" | detail
 +
| string
 +
| 是否有详情页:1有,0没有
 +
|-
 +
| colspan="2" | detail_info
 +
| object
 +
| poi的扩展信息,仅当scope=2时,显示该字段,不同的poi类型,显示的detail_info字段不同。
 +
|-
 +
| rowspan="19" |
 +
| distance
 +
| int32
 +
| 距离中心点的距离,圆形区域检索时返回
 +
|-
 +
| type
 +
| string
 +
| 所属分类,如’hotel’、’cater’。
 +
|-
 +
| tag
 +
| string
 +
| 标签
 +
|-
 +
| detail_url
 +
| string
 +
| poi的详情页
 +
|-
 +
| price
 +
| string
 +
| poi商户的价格
 +
|-
 +
| shop_hours
 +
| string
 +
| 营业时间
 +
|-
 +
| overall_rating
 +
| string
 +
| 总体评分
 +
|-
 +
| taste_rating
 +
| string
 +
| 口味评分
 +
|-
 +
| service_rating
 +
| string
 +
| 服务评分
 +
|-
 +
| environment_rating
 +
| string
 +
| 环境评分
 +
|-
 +
| facility_rating
 +
| string
 +
| 星级(设备)评分
 +
|-
 +
| hygiene_rating
 +
| string
 +
| 卫生评分
 +
|-
 +
| technology_rating
 +
| string
 +
| 技术评分
 +
|-
 +
| image_num
 +
| string
 +
| 图片数
 +
|-
 +
| groupon_num
 +
| int
 +
| 团购数
 +
|-
 +
| discount_num
 +
| int
 +
| 优惠数
 +
|-
 +
| comment_num
 +
| string
 +
| 评论数
 +
|-
 +
| favorite_num
 +
| string
 +
| 收藏数
 +
|-
 +
| checkin_num
 +
| string
 +
| 签到数
 
|}
 
|}
'''圆形区域检索示例(返回xml数据):'''
+
<div class="serve-explain-text"><div class="serveintoor-title service-page-anchor">地点详情检索服务</div><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/place/v2/detail?uid=5a8fb739999a70a54207c130&output=json&scope=2&ak=您的密钥 //GET请求
 
+
</pre>
<source>
+
</div></div><div class="separate-title">请求参数</div>
http://api.map.baidu.com/place/v2/search?query=银行&location=39.915,116.404&radius=2000&output=xml&ak={您的密钥}
+
</source>
+
 
+
====Place API检索返回结果字段====
+
 
+
'''状态字段'''
+
 
+
 
{|
 
{|
 
|-
 
|-
!width="80"|名称
+
! 参数
!width="80" |类型
+
! 是否必须
!说明
+
! 默认值
 +
! 格式举例
 +
! 含义
 
|-
 
|-
|status
+
| uid
|Int
+
|
|本次API访问状态,如果成功返回0,如果失败返回其他数字。
+
|
 +
| ‘8ee4560cf91d160e6cc02cd7’
 +
| poi的uid
 
|-
 
|-
|message
+
| uids
|string
+
|
|对API访问状态值的英文说明,如果成功返回"ok",并返回结果字段,如果失败返回错误说明。
+
|
 +
| ‘8ee4560cf91d160e6cc02cd7’,‘5ffb1816cf771a226f476058’
 +
| uid的集合,最多可以传入10个uid,多个uid之间用英文逗号分隔。
 
|-
 
|-
|total
+
| output
|int
+
|
|检索总数,用户请求中设置了page_num字段才会出现total字段。当检索总数值大于760时,多次刷新同一请求得到total的值可能稍有不同,属于正常情况。
+
| xml
 +
| json或xml
 +
| 请求返回格式
 +
|-
 +
| scope
 +
| 是
 +
| 1
 +
| 1、2
 +
| 检索结果详细程度。取值为1 或空,则返回基本信息;取值为2,返回检索POI详细信息
 +
|-
 +
| ak
 +
| 是
 +
| 无
 +
| 您的ak
 +
| 开发者的访问密钥,必填项。v2之前该属性为key。
 +
|-
 +
| sn
 +
| 否
 +
| 无
 +
| [http://lbsyun.baidu.com/index.php?title=webapi/appendix Sn生成方法]
 +
| 开发者的权限签名。
 +
|-
 +
| timestamp
 +
| 否
 +
| 无
 +
|
 +
| 设置sn后该值必填。
 
|}
 
|}
'''结果字段(以结果集合里的一条数据为例,灰色表示扩展字段):'''
+
<div class="separate-title">返回参数(行政区划区域检索、周边检索、矩形区域检索、地点详情检索)</div>
 
+
 
{|
 
{|
 
|-
 
|-
!width="80" colspan="2"|名称
+
! width="80" colspan="2" | 名称
!width="80" |类型
+
! width="80" | 类型
!说明
+
! 说明
 
|-
 
|-
|colspan="2" |name
+
| colspan="2" | status
|string
+
| Int
|poi名称
+
| 本次API访问状态,如果成功返回0,如果失败返回其他数字。(见服务状态码)
 
|-
 
|-
|colspan="2" |location
+
| colspan="2" | message
|object
+
| string
|poi经纬度坐标
+
| 对API访问状态值的英文说明,如果成功返回"ok",并返回结果字段,如果失败返回错误说明。
 
|-
 
|-
|rowspan="2" |
+
| colspan="2" | total
|lat
+
| int
|float
+
| POI检索总数,开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的,单次请求total最多为400。
|纬度值
+
 
|-
 
|-
|lng
+
| colspan="2" | name
|float
+
| string
|经度值
+
| poi名称
 
|-
 
|-
|colspan="2" |address
+
| colspan="2" | location
|string
+
| object
|poi地址信息
+
| poi经纬度坐标
 
|-
 
|-
|colspan="2" |telephone
+
| rowspan="2" |  
|string
+
| lat
|poi电话信息
+
| float
 +
| 纬度值
 
|-
 
|-
|colspan="2" |uid
+
| lng
|string
+
| float
|poi的唯一标示
+
| 经度值
 
|-
 
|-
|colspan="2" |street_id
+
| colspan="2" | address
|string
+
| string
|街景图id
+
| poi地址信息
 
|-
 
|-
|colspan="2" |detail
+
| colspan="2" | telephone
|string
+
| string
|是否有详情页:1有,0没有
+
| poi电话信息
 
|-
 
|-
|colspan="2" |detail_info
+
| colspan="2" | uid
|object
+
| string
|poi的扩展信息,仅当scope=2时,显示该字段,不同的poi类型,显示的detail_info字段不同。
+
| poi的唯一标示
 
|-
 
|-
|rowspan="20" |
+
| colspan="2" | street_id
|distance
+
| string
|int32
+
| 街景图id
|距离中心点的距离,圆形区域检索时返回
+
 
|-
 
|-
|type
+
| colspan="2" | detail
|string
+
| string
|所属分类,如’hotel’、’cater’。
+
| 是否有详情页:1有,0没有
 
|-
 
|-
|tag
+
| colspan="2" | detail_info
|string
+
| object
|标签
+
| poi的扩展信息,仅当scope=2时,显示该字段,不同的poi类型,显示的detail_info字段不同。
 
|-
 
|-
|detail_url
+
| rowspan="19" |
|string
+
| distance
|poi的详情页
+
| int32
 +
| 距离中心点的距离,圆形区域检索时返回
 
|-
 
|-
|navi_location
+
| type
|float
+
| string
|poi的导航点坐标(一般为出入口)
+
| 所属分类,如’hotel’、’cater’。
 
|-
 
|-
|price
+
| tag
|string
+
| string
|poi商户的价格
+
| 标签
 
|-
 
|-
|shop_hours
+
| detail_url
|string
+
| string
|营业时间
+
| poi的详情页
 
|-
 
|-
|overall_rating
+
| price
|string
+
| string
|总体评分
+
| poi商户的价格
 
|-
 
|-
|taste_rating
+
| shop_hours
|string
+
| string
|口味评分
+
| 营业时间
 
|-
 
|-
|service_rating
+
| overall_rating
|string
+
| string
|服务评分
+
| 总体评分
 
|-
 
|-
|environment_rating
+
| taste_rating
|string
+
| string
|环境评分
+
| 口味评分
 
|-
 
|-
|facility_rating
+
| service_rating
|string
+
| string
|星级(设备)评分
+
| 服务评分
 
|-
 
|-
|hygiene_rating
+
| environment_rating
|string
+
| string
|卫生评分
+
| 环境评分
 
|-
 
|-
|technology_rating
+
| facility_rating
|string
+
| string
|技术评分
+
| 星级(设备)评分
 
|-
 
|-
|image_num
+
| hygiene_rating
|string
+
| string
|图片数
+
| 卫生评分
 
|-
 
|-
|groupon_num
+
| technology_rating
|int
+
| string
|团购数
+
| 技术评分
 
|-
 
|-
|discount_num
+
| image_num
|int
+
| string
|优惠数
+
| 图片数
 
|-
 
|-
|comment_num
+
| groupon_num
|string
+
| int
|评论数
+
| 团购数
 
|-
 
|-
|favorite_num
+
| discount_num
|string
+
| int
|收藏数
+
| 优惠数
 
|-
 
|-
|checkin_num
+
| comment_num
|string
+
| string
|签到数
+
| 评论数
 +
|-
 +
| favorite_num
 +
| string
 +
| 收藏数
 +
|-
 +
| checkin_num
 +
| string
 +
| 签到数
 
|}
 
|}
 
+
<br/><div class="bluetitle"><div class="services-title-text">服务状态码</div></div>
==Place详情检索服务==
+
 
+
'''服务地址:'''
+
 
+
<source>
+
http://api.map.baidu.com/place/v2/detail
+
</source>
+
 
+
提供查询某个POI点的详情信息,如好评,评价等。
+
 
+
'''请求参数说明:'''
+
 
+
 
{|
 
{|
 
|-
 
|-
!参数
+
! width="100" | 返回码
!是否必须
+
! width="200" | 英文描述
!默认值
+
! width="200" | 定义
!格式举例
+
! width="480" | 常见原因
!含义
+
 
|-
 
|-
|uid
+
| 0
|
+
| ok
|
+
| 正常
|‘8ee4560cf91d160e6cc02cd7’
+
| 服务请求正常召回
|poi的uid
+
 
|-
 
|-
|uids
+
| 2
|
+
| Parameter Invalid
|
+
| 请求参数非法
| ‘8ee4560cf91d160e6cc02cd7’,‘5ffb1816cf771a226f476058’
+
| 必要参数拼写错误或漏传(如query和tag请求中均未传入)
|uid的集合,最多可以传入10个uid,多个uid之间用英文逗号分隔。
+
 
|-
 
|-
|output
+
| 3
|
+
| Verify Failure
|xml
+
| 权限校验失败
|json或xml
+
|  
|请求返回格式
+
 
|-
 
|-
|scope
+
| 4
|
+
| Quota Failure
|1
+
| 配额校验失败
|1、2
+
| 服务当日调用次数已超限,请前往[http://lbsyun.baidu.com/apiconsole/quota API控制台]提升(请优先进行[http://lbsyun.baidu.com/apiconsole/auth 开发者认证])
|检索结果详细程度。取值为1 或空,则返回基本信息;取值为2,返回检索POI详细信息
+
 
|-
 
|-
|ak
+
| 5
|
+
| AK Failure
|
+
| ak不存在或者非法
|您的ak
+
| 未传入ak参数;ak已被删除(可前往[http://lbsyun.baidu.com/apiconsole/key/recycle 回收站]恢复);
|用户的访问密钥,必填项。v2之前该属性为key。
+
|}
 +
</div><div class="navRemark"><div class="handpointto">内容(使用指南)</div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">使用方法</div></div><div class="useguide"><div class="useguide_bg"></div><div class="useguide_li">
 +
<span>1</span> [https://passport.baidu.com/v2/?reg&tt=1494238640555&gid=E85D052-3B8B-45D0-9412-D0B861D79A5D&tpl=pp&u=https://passport.baidu.com/ 申请百度账号]
 +
</div><div class="useguide_li">
 +
<span>2</span> [http://lbsyun.baidu.com/apiconsole/key 申请成为百度开发者]
 +
</div><div class="useguide_li">
 +
<span>3</span> [http://lbsyun.baidu.com/apiconsole/key/create 获取服务密钥(ak)]
 +
</div><div class="useguide_li" style="margin-right:0;">
 +
<span>4</span> [http://passport.baidu.com 发送请求,使用服务]
 +
 
 +
 
 +
</div></div><div class="bluetitle"><div class="services-title-text">编码说明</div></div>
 +
API请求中需要用到中文或一些特殊字符的参数,如query、region等,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成UTF-8字符的二字符十六进制值,凡是不在下表中的字符都需要进行编码。
 +
 
 +
{| border="1" cellspacing="1" cellpadding="1" style="width: 957px;"
 
|-
 
|-
|sn
+
| style="text-align: center; width: 91px;" | '''字符集合'''
|
+
| style="width: 823px; text-align: center;" | '''字符'''
|
+
|
+
|用户的权限签名。
+
 
|-
 
|-
|timestamp
+
| style="text-align: center; width: 91px;" | URL非保留字<br/>
|
+
| style="width: 823px;" | a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~<br/>
|
+
|-
|  
+
| style="text-align: center; width: 91px;" | URL保留字<br/>
|设置sn后该值必填。
+
| style="width: 823px;" | &nbsp;! * ' ( )&nbsp;;&nbsp;: @ & = + $ , /&nbsp;?&nbsp;% # [ ]<br/>
 
|}
 
|}
  
'''返回值与Place API检索返回结果字段相同。'''
+
如果中文参数中使用URL保留字字符的字面意思,例如:region关键字取值为"?北京",检索关键字包含一个问号,此问号也必须进行编码。<br/><br/>附注:
  
'''服务示例:'''
+
{{bluepoint}}javascript中一般采用encodeURIComponent函数对特殊字符进行编码。
  
<source>
+
{{bluepoint}}Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
http://api.map.baidu.com/place/v2/detail?uid=5a8fb739999a70a54207c130&output=json&scope=2&ak={您的密钥}
+
</source>
+
  
'''返回值:'''
+
{{bluepoint}}C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
  
<source>
+
{{bluepoint}}php中可以使用函数urlencode对特殊字符进行编码。
{
+
<div class="bluetitle"><div class="services-title-text">坐标系说明</div></div>
    "status": 0,
+
{{bluepoint}}WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。<br/><br/>{{bluepoint}}GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。<br/><br/>{{bluepoint}}BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标<br/><br/>{{bluepoint}}Place Suggestion API默认输入输出坐标类型为百度坐标(BD09),同时可通过参数("coord_type","ret_coordtype")控制输入输出坐标类型。输入坐标支持以上三种坐标系,输出坐标支持-国测局坐标(GCJ02)和百度坐标(BD09)<br/><br/><span style="color:#FF0000;">注意:不同类型坐标如需转换,请使用百度地图开放平台提供的</span>[http://lbsyun.baidu.com/index.php?title=webapi/guide/changeposition 标准坐标转换接口]<span style="color:#FF0000;">。请勿使用其他渠道提供的坐标转换方法,以免影响坐标转换精度。</span>
    "message": "ok",
+
<div class="bluetitle"><div class="services-title-text">服务配额</div></div>
    "result": {
+
{{bluepoint}}每个开发者账号每天调用“地点检索”API 服务的总次数(即配额)是有限的。
        "name": "百度大厦员工食堂",
+
        "location": {
+
            "lng": 116.308022,
+
            "lat": 40.056892
+
        },
+
        "address": "海淀区上地十街10号(近辉煌国际)",
+
        "detail": 1,
+
        "uid": "5a8fb739999a70a54207c130",
+
        "detail_info": {
+
            "tag": "美食;其他",
+
            "detail_url": "http://api.map.baidu.com/place/detail?uid=5a8fb739999a70a54207c130&output=html&source=placeapi_v2",
+
            "navi_location":
+
            "lng": 116.30802189301,
+
            "lat": 40.056895239287
+
            },
+
            "type": "cater",
+
            "price": "11.0",
+
            "overall_rating": "4.0",
+
            "taste_rating": "4.0",
+
            "service_rating": "4.0",
+
            "environment_rating": "4.0",
+
            "image_num": "2",
+
            "comment_num": "8",
+
            "shop_hours": "早9点到晚8点",
+
            "atmosphere": "",
+
            "featured_service": "",
+
            "recommendation": "麻辣烫,烤鱼",
+
            "description": "门店介绍:"
+
        }
+
    }
+
}
+
</source>
+
  
==状态码附录==
+
{{bluepoint}}每个开发者账号每天调用“地点检索”API 服务的总次数(即并发量)是有限的。
 +
 
 +
{{bluepoint}}若需要更高配额和并发量,请[http://lbsyun.baidu.com/apiconsole/auth/check 申请开发者认证]以获取更高配额和更及时的技术支持。
 +
 
 +
{{bluepoint}}同一个账号下的HTTP/HTTPS请求,配额,并发共享。
 +
 
 +
 
 +
 
 +
'''配额及默认并发量说明如下'''
 +
<div class="tablecenter">
 
{|
 
{|
 
|-
 
|-
!width="80" |返回码
+
! width="220" | 分类
!width="180" |定义
+
! width="270" | 未认证
!width="448" |英文返回描述
+
! width="220" | 个人认证
 +
! width="270" | 企业认证
 
|-
 
|-
|0
+
| 日配额(次)
|正常
+
| 2,000
|ok
+
| 30,000
 +
| 300,000
 
|-
 
|-
|2
+
| 分钟并发数(次/分钟)
|请求参数非法
+
| 120
|Parameter Invalid
+
| 3,000
|-
+
| 12,000
|3
+
|权限校验失败
+
|Verify Failure
+
|-
+
|4
+
|配额校验失败
+
|Quota Failure
+
|-
+
|5
+
|ak不存在或者非法
+
|AK Failure
+
|-
+
|2xx
+
|无权限
+
|
+
|-
+
|3xx
+
|配额错误
+
|
+
 
|}
 
|}
 +
</div></div><div class="navRemark"><div class="handpointto">内容(常见问题)</div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">服务常见问题</div></div><div class="serve-explain-text"><div class="serveintoor-title">1、为什么有些POI在接口服务中检索不到?</div>
 +
出于数据保护目的,地点检索服务使用的数据非最新版。若有需求,请[http://lbsyun.baidu.com/index.php?title=open/help_index 联系我们]。<br/>【排查方法】同一地点,使用百度地图PC端或手机客户端能检索到,使用API接口无数据。<br/><br/>百度地图数据库中无该地点数据。请通过[http://i.map.baidu.com/api/page/poicorrect/addpoipc?city_id=131&business_trigger=7&poi_name=123452 POI纠错平台]上报,我们会尽快核实数据并添加上线。<br/>【排查方法】同一地点,使用百度地图PC端或手机客户端和API接口均无返回数据。<br/><br/>检索结果中,相关数据过多,接口结果未展示完全。请通过"page_size","page_num"字段控制数据返回数量和翻页操作。<br/>【排查方法】返回结果中,"total"参数值大于返回POI数量。
 +
</div><div class="serve-explain-text"><div class="serveintoor-title">2、为什么每次访问服务,最多只返回400条数据?</div>
 +
出于数据保护目的,单次访问服务最多同时返回400条数据。此限制无法修改。请根据实际需求,通过添加分类、设置范围等方式,缩小检索范围。
 +
</div><div class="serve-explain-text"><div class="serveintoor-title">3、为什么我设置了"region=北京",结果返回了其他城市的数据?</div>
 +
"region"参数表示检索城市偏重,会增加对应城市返回结果的权重,从而影响返回数据排序。但部分权重较高的其他城市地点,仍有可能召回(如:在北京检索"迪士尼",会返回上海数据)。<br/>若需要限制返回结果仅为"region"参数对应的城市数据,请在使用"region"参数时,同时加上"city_limit=true"参数。
 +
</div><div class="serve-explain-text"><div class="serveintoor-title">4、我能通过接口检索自己的地点数据吗?</div>
 +
地点检索API服务检索的数据为百度地图母库数据,若需要检索自己的业务地点数据,请使用[http://lbsyun.baidu.com/index.php?title=lbscloud LBS云服务].
 +
</div></div><div class="navRemark"><div class="handpointto">内容(更新日志)</div></div><div class="txtstyle2"><div class="updatedemo"><div class="uptitle"><div class="next timecut"></div><div class="prve timecut"></div><div class="updatetime"><div class="controlshow"><div class="timeversions">
 +
2012年3月8日
 +
 +
V1.0
 +
</div><div class="timeversions">
 +
2013年4月7日
 +
 +
V2.0
 +
</div><div class="timeversions">
 +
2013年5月9日
 +
 +
V2.1
 +
</div><div class="timeversions">
 +
2016年10月28日
  
==升级说明==
+
V2.2
{{bluepoint}}v2版本较之v1版本,功能更新详见[[:webapi/theupdatelog |更新日志]],且请求url参数:新增版本号“v2”,修改“key”为“ak”。V2不兼容v1版本的key,若需升级,请重新[http://lbsyun.baidu.com/apiconsole/key?application=key 获取密钥]。
+
</div><div class="timeversions intro">
 +
2017年1月10日
  
{{bluepoint}}若需查看v1文档,请访问“Place APIv1.0”。
+
V2.3
 +
</div><br/></div></div><div class="linellae"></div></div><div class="updatecenter"><div class="updatebox"><div class="bluetitle"><div class="services-title-text">产品发布</div></div><div class="serve-explain-text">地点检索服务V1.0正式上线</div></div><div class="updatebox"><div class="bluetitle"><div class="services-title-text">产品发布</div></div><div class="serve-explain-text">地点检索服务V2.0正式上线<br/><br/>1. 新增查询单个POI详情服务<br/><br/>2. 地点检索服务区域查询支持设置返回分页数及每页显示的POI数,较之v1版本,增加可返回的数据条目<br/><br/>3. 支持返回POI的扩展字段(如评分、价格、评论数等)。</div></div><div class="updatebox"><div class="bluetitle"><div class="services-title-text">新增功能</div></div><div class="serve-explain-text">开放团购API,支持城市内、矩形、圆形区域检索团购信息,且提供商家团购详情查询功能。</div></div><div class="updatebox"><div class="bluetitle"><div class="services-title-text">新增功能</div></div><div class="serve-explain-text">新增city_limit参数(行政区划检索范围限定功能)</div></div><div class="updatebox"><div class="bluetitle"><div class="services-title-text">新增功能</div></div><div class="serve-explain-text">新增"ret_coordtype=gcj02ll"参数,地点检索API服务全面支持国测局坐标</div></div><br/></div></div></div><div class="navRemark"><div class="handpointto">内容(资源下载)</div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">服务资源下载</div></div><div class="serve-explain-text"><div class="serveintoor-title">百度地图城市名称-中心点经纬度(cityCenter)关系对照</div>
 +
您可以通过此文件获知百度地图的全国各城市中心点(cityCenter)经纬度
 +
<div class="download-btn">[http://developer.baidu.com/map/static/doc/BaiduMap_cityCenter.zip 下载]</div><br/></div><div class="serve-explain-text"><div class="serveintoor-title">百度地图城市名称-城市代码(cityCode)关系对照</div>
 +
您可以通过此文件获知百度地图的全国各城市代码(cityCode)。 在使用百度地图API或SDK各种涉及citycode参数的服务时,您可参看此文件传入准确值,如JavaScript API的本地检索服务(根据cityCode获取本地检索结果)、Android SDK离线地图服务(根据cityCode,获取对应城市离线地图)等。<br/><font color="red">注意:cityCode为百度内部定义,已不再维护,请谨慎使用。</font>
 +
<div class="download-btn">[http://wiki.lbsyun.baidu.com/cms/citycode/BaiduMap_cityCode_1102.zip 下载]</div><br/></div><div class="serve-explain-text"><div class="serveintoor-title">百度地图POI行业分类(tag)</div>
 +
您可以通过此链接获知百度地图POI(兴趣点)的tag引导体系,辅助您检索POI。 如检索query为百度地图的tag“生活服务”,返回的检索结果即包含关键字为“生活服务”的POI、也包含tag为“生活服务”的POI,从而聚焦检索结果。
 +
<div class="download-btn">[http://lbsyun.baidu.com/index.php?title=lbscloud/poitags 查看]</div><br/></div></div></div>

2017年10月26日 (四) 06:52的版本

服务介绍
服务文档
使用指南
常见问题
更新日志
资源下载
地点检索服务

地点检索服务(又名Place API)是一类Web API接口服务;
服务提供多种场景的地点(POI)检索功能,包括城市检索、周边检索、矩形区域检索。开发者可通过接口获取地点(POI)基础或详细地理信息。

功能介绍
行政区划区域检索

开发者可通过该功能,检索某一行政区划内(目前最细到城市级别)的地点信息。

place1.png

圆形区域检索

开发者可设置圆心和半径,检索圆形区域内的地点信息(常用于周边检索场景)。

place2.png

矩形区域检索

开发者可设置检索区域左下角和右上角坐标,检索坐标对应矩形内的地点信息(常用于手机或PC端地图视野内检索)

place3.png

地点详情检索

不同于以上三种检索功能。地点详情检索针对指定POI,检索其相关的详情信息。开发者可以通过三种区域检索(或其他服务)功能,获取POI id。使用“地点详情检索”功能,传入id,即可检索POI详情信息,如评分、营业时间等(不同类型POI对应不同类别详情数据)。

place4.png

接口功能介绍
行政区划区域检索
http://api.map.baidu.com/place/v2/search?query=ATM机&tag=银行&region=北京&output=json&ak=您的ak //GET请求
请求参数
参数名 参数含义 类型 示例 是否必须
query 检索关键字。周边检索和矩形区域内检索支持多个关键字并集检索,不同关键字间以$符号分隔,最多支持10个关键字检索。如:”银行$酒店” string(45) 天安门 query和tag参数请求时至少传入一个
tag 检索分类,与q组合进行检索,多个分类以","分隔
POI分类
string(50) 美食 query和tag参数请求时至少传入一个
region 检索行政区划区域(增加区域内数据召回权重,如需严格限制召回数据在区域内,请搭配使用city_limit参数),可输入行政区划名或对应cityCode string(50) 北京、131 可选
city_limit 区域数据召回限制,为true时,仅召回region对应区域内数据。 string(50) true、false 可选
output 输出格式为json或者xml string(50) json或xml 可选
scope 检索结果详细程度。取值为1 或空,则返回基本信息;取值为2,返回检索POI详细信息 string(50) 1、2 可选
filter 检索过滤条件。当scope取值为2时,可以设置filter进行排序。

industry_type:行业类型,注意:设置该字段可提高检索速度和过滤精度,取值有: hotel(宾馆);cater(餐饮);life(生活娱乐) sort_name:排序字段,根据industry_type字段的值而定。 1、industry_type为hotel时,sort_name取值有: default(默认);price(价格);total_score(好评);level(星级);health_score(卫生);distance(距离排序,只有周边检索有效) 2、industry_type为cater时,sort_name取值有: default(默认);taste_rating(口味);price(价格);overall_rating(好评);service_rating(服务);distance(距离排序,只有周边检索有效) 3、industry_type为life时,sort_name取值有: default(默认);price(价格);overall_rating(好评);comment_num(服务);distance(距离排序,只有周边检索有效)
sort_rule:排序规则:0(从高到低),1(从低到高)
price_section:价格区间
groupon:是否有团购:1(有),0(无)
discount:是否有打折:1(有),0(无)

string(50) sort_name:distance|sort_rule:1 可选
coord_type 坐标类型,1(wgs84ll即GPS经纬度),2(gcj02ll即国测局经纬度坐标),3(bd09ll即百度经纬度坐标),4(bd09mc即百度米制坐标)
坐标详细说明
int 1、2、3(默认)、4 可选
ret_coordtype 可选参数,添加后POI返回国测局经纬度坐标
坐标详细说明
string(50) gcj02ll 可选
page_size 单次召回POI数量,默认为10条记录,最大返回20条。多关键字检索时,返回的记录数为关键字个数*page_size。 int 10 可选
page_num 分页页码,默认为0,0代表第一页,1代表第二页,以此类推。

常与page_size搭配使用。

int 0、1、2 可选
ak 开发者的访问密钥,必填项。v2之前该属性为key。

申请秘钥

string(50) 必须
sn 开发者的权限签名。

Sn校验说明

string(50) 可选,若开发者所用AK的校验方式为SN校验时该参数必须。
timestamp 设置sn后该值必填。 string(50) 设置sn后该值必填。

返回参数见下方页面内容


周边检索
http://api.map.baidu.com/place/v2/search?query=银行&location=39.915,116.404&radius=2000&output=xml&ak=您的密钥 //GET请求
请求参数
参数名 参数含义 类型 示例 是否必须
query 检索关键字。周边检索和矩形区域内检索支持多个关键字并集检索,不同关键字间以$符号分隔,最多支持10个关键字检索。如:”银行$酒店” string(45) 天安门 query和tag参数请求时至少传入一个
tag 检索分类,与q组合进行检索,多个分类以","分隔
POI分类
string(50) 美食 query和tag参数请求时至少传入一个
location 周边检索中心点,不支持多个点 string(50) 38.76623,116.43213

lat<纬度>,lng<经度>

必须
radius 周边检索半径,单位为米。(当半径过大,超过中心点所在城市边界时,会变为城市范围检索,检索范围为中心点所在城市) string(50) 1000(默认) 可选
radius_limit
是否严格限定召回结果在设置检索半径范围内。true(是),false(否)。设置为true时会影响返回结果中total准确性及每页召回poi数量,我们会逐步解决此类问题。
string(50)
false 可选
output 输出格式为json或者xml string(50) json或xml 可选
scope 检索结果详细程度。取值为1 或空,则返回基本信息;取值为2,返回检索POI详细信息 string(50) 1、2 可选
filter 检索过滤条件。当scope取值为2时,可以设置filter进行排序。

industry_type:行业类型,注意:设置该字段可提高检索速度和过滤精度,取值有: hotel(宾馆);cater(餐饮);life(生活娱乐) sort_name:排序字段,根据industry_type字段的值而定。 1、industry_type为hotel时,sort_name取值有: default(默认);price(价格);total_score(好评);level(星级);health_score(卫生);distance(距离排序,只有周边检索有效) 2、industry_type为cater时,sort_name取值有: default(默认);taste_rating(口味);price(价格);overall_rating(好评);service_rating(服务);distance(距离排序,只有周边检索有效) 3、industry_type为life时,sort_name取值有: default(默认);price(价格);overall_rating(好评);comment_num(服务);distance(距离排序,只有周边检索有效)
sort_rule:排序规则:0(从高到低),1(从低到高)
price_section:价格区间
groupon:是否有团购:1(有),0(无)
discount:是否有打折:1(有),0(无)

string(50) sort_name:distance|sort_rule:1 可选
coord_type 坐标类型,1(wgs84ll即GPS经纬度),2(gcj02ll即国测局经纬度坐标),3(bd09ll即百度经纬度坐标),4(bd09mc即百度米制坐标)
坐标详细说明
int 1、2、3(默认)、4 可选
ret_coordtype 可选参数,添加后POI返回国测局经纬度坐标
坐标详细说明
string(50) gcj02ll 可选
page_size 单次召回POI数量,默认为10条记录,最大返回20条。多关键字检索时,返回的记录数为关键字个数*page_size。 int 10 可选
page_num 分页页码,默认为0,0代表第一页,1代表第二页,以此类推。

常与page_size搭配使用。

int 0、1、2 可选
ak 开发者的访问密钥,必填项。v2之前该属性为key。

申请秘钥

string(50) 必须
sn 开发者的权限签名。

Sn校验说明

string(50) 可选,若开发者所用AK的校验方式为SN校验时该参数必须。
timestamp 设置sn后该值必填。 string(50) 设置sn后该值必填。
矩形区域检索
http://api.map.baidu.com/place/v2/search?query=银行&bounds=39.915,116.404,39.975,116.414&output=json&ak={您的密钥} //GET请求
请求参数
参数名 参数含义 类型 示例 是否必须
query 检索关键字。周边检索和矩形区域内检索支持多个关键字并集检索,不同关键字间以$符号分隔,最多支持10个关键字检索。如:”银行$酒店” string(45) 天安门 query和tag参数请求时至少传入一个
tag 检索分类,与q组合进行检索,多个分类以","分隔
POI分类
string(50) 美食 query和tag参数请求时至少传入一个
bounds 检索矩形区域,多组坐标间以","分隔 string(50) 38.76623,116.43213,39.54321,116.46773 lat,lng(左下角坐标),lat,lng(右上角坐标) 必须
output 输出格式为json或者xml string(50) json或xml 可选
scope 检索结果详细程度。取值为1 或空,则返回基本信息;取值为2,返回检索POI详细信息 string(50) 1、2 可选
filter 检索过滤条件。当scope取值为2时,可以设置filter进行排序。

industry_type:行业类型,注意:设置该字段可提高检索速度和过滤精度,取值有: hotel(宾馆);cater(餐饮);life(生活娱乐) sort_name:排序字段,根据industry_type字段的值而定。 1、industry_type为hotel时,sort_name取值有: default(默认);price(价格);total_score(好评);level(星级);health_score(卫生);distance(距离排序,只有周边检索有效) 2、industry_type为cater时,sort_name取值有: default(默认);taste_rating(口味);price(价格);overall_rating(好评);service_rating(服务);distance(距离排序,只有周边检索有效) 3、industry_type为life时,sort_name取值有: default(默认);price(价格);overall_rating(好评);comment_num(服务);distance(距离排序,只有周边检索有效)
sort_rule:排序规则:0(从高到低),1(从低到高)
price_section:价格区间
groupon:是否有团购:1(有),0(无)
discount:是否有打折:1(有),0(无)

string(50) sort_name:distance|sort_rule:1 可选
coord_type 坐标类型,1(wgs84ll即GPS经纬度),2(gcj02ll即国测局经纬度坐标),3(bd09ll即百度经纬度坐标),4(bd09mc即百度米制坐标)
坐标详细说明
int 1、2、3(默认)、4 可选
ret_coordtype 可选参数,添加后POI返回国测局经纬度坐标
坐标详细说明
string(50) gcj02ll 可选
page_size 单次召回POI数量,默认为10条记录,最大返回20条。多关键字检索时,返回的记录数为关键字个数*page_size。 int 10 可选
page_num 分页页码,默认为0,0代表第一页,1代表第二页,以此类推。

常与page_size搭配使用。

int 0、1、2 可选
ak 开发者的访问密钥,必填项。v2之前该属性为key。

申请秘钥

string(50) 必须
sn 开发者的权限签名。

Sn校验说明

string(50) 可选,若开发者所用AK的校验方式为SN校验时该参数必须。
timestamp 设置sn后该值必填。 string(50) 设置sn后该值必填。
返回参数(行政区划区域检索、周边检索、矩形区域检索)
名称 类型 说明
status Int 本次API访问状态,如果成功返回0,如果失败返回其他数字。(见服务状态码)
message string 对API访问状态值的英文说明,如果成功返回"ok",并返回结果字段,如果失败返回错误说明。
total int POI检索总数,开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的,单次请求total最多为400。
name string poi名称
location object poi经纬度坐标
lat float 纬度值
lng float 经度值
address string poi地址信息
telephone string poi电话信息
uid string poi的唯一标示
street_id string 街景图id
detail string 是否有详情页:1有,0没有
detail_info object poi的扩展信息,仅当scope=2时,显示该字段,不同的poi类型,显示的detail_info字段不同。
distance int32 距离中心点的距离,圆形区域检索时返回
type string 所属分类,如’hotel’、’cater’。
tag string 标签
detail_url string poi的详情页
price string poi商户的价格
shop_hours string 营业时间
overall_rating string 总体评分
taste_rating string 口味评分
service_rating string 服务评分
environment_rating string 环境评分
facility_rating string 星级(设备)评分
hygiene_rating string 卫生评分
technology_rating string 技术评分
image_num string 图片数
groupon_num int 团购数
discount_num int 优惠数
comment_num string 评论数
favorite_num string 收藏数
checkin_num string 签到数
地点详情检索服务
http://api.map.baidu.com/place/v2/detail?uid=5a8fb739999a70a54207c130&output=json&scope=2&ak=您的密钥 //GET请求
请求参数
参数 是否必须 默认值 格式举例 含义
uid ‘8ee4560cf91d160e6cc02cd7’ poi的uid
uids ‘8ee4560cf91d160e6cc02cd7’,‘5ffb1816cf771a226f476058’ uid的集合,最多可以传入10个uid,多个uid之间用英文逗号分隔。
output xml json或xml 请求返回格式
scope 1 1、2 检索结果详细程度。取值为1 或空,则返回基本信息;取值为2,返回检索POI详细信息
ak 您的ak 开发者的访问密钥,必填项。v2之前该属性为key。
sn Sn生成方法 开发者的权限签名。
timestamp 设置sn后该值必填。
返回参数(行政区划区域检索、周边检索、矩形区域检索、地点详情检索)
名称 类型 说明
status Int 本次API访问状态,如果成功返回0,如果失败返回其他数字。(见服务状态码)
message string 对API访问状态值的英文说明,如果成功返回"ok",并返回结果字段,如果失败返回错误说明。
total int POI检索总数,开发者请求中设置了page_num字段才会出现total字段。出于数据保护目的,单次请求total最多为400。
name string poi名称
location object poi经纬度坐标
lat float 纬度值
lng float 经度值
address string poi地址信息
telephone string poi电话信息
uid string poi的唯一标示
street_id string 街景图id
detail string 是否有详情页:1有,0没有
detail_info object poi的扩展信息,仅当scope=2时,显示该字段,不同的poi类型,显示的detail_info字段不同。
distance int32 距离中心点的距离,圆形区域检索时返回
type string 所属分类,如’hotel’、’cater’。
tag string 标签
detail_url string poi的详情页
price string poi商户的价格
shop_hours string 营业时间
overall_rating string 总体评分
taste_rating string 口味评分
service_rating string 服务评分
environment_rating string 环境评分
facility_rating string 星级(设备)评分
hygiene_rating string 卫生评分
technology_rating string 技术评分
image_num string 图片数
groupon_num int 团购数
discount_num int 优惠数
comment_num string 评论数
favorite_num string 收藏数
checkin_num string 签到数

服务状态码
返回码 英文描述 定义 常见原因
0 ok 正常 服务请求正常召回
2 Parameter Invalid 请求参数非法 必要参数拼写错误或漏传(如query和tag请求中均未传入)
3 Verify Failure 权限校验失败
4 Quota Failure 配额校验失败 服务当日调用次数已超限,请前往API控制台提升(请优先进行开发者认证
5 AK Failure ak不存在或者非法 未传入ak参数;ak已被删除(可前往回收站恢复);
使用方法
编码说明

API请求中需要用到中文或一些特殊字符的参数,如query、region等,为了避免提交到后台乱码,需要对这几个参数值进行编码处理,转换成UTF-8字符的二字符十六进制值,凡是不在下表中的字符都需要进行编码。

字符集合 字符
URL非保留字
a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~
URL保留字
 ! * ' ( ) ; : @ & = + $ , / ? % # [ ]

如果中文参数中使用URL保留字字符的字面意思,例如:region关键字取值为"?北京",检索关键字包含一个问号,此问号也必须进行编码。

附注:

javascript中一般采用encodeURIComponent函数对特殊字符进行编码。

Java中可以使用函数URLEncoder.encode对特殊字符进行编码。

C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。

php中可以使用函数urlencode对特殊字符进行编码。

坐标系说明

WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。

GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。

BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标

Place Suggestion API默认输入输出坐标类型为百度坐标(BD09),同时可通过参数("coord_type","ret_coordtype")控制输入输出坐标类型。输入坐标支持以上三种坐标系,输出坐标支持-国测局坐标(GCJ02)和百度坐标(BD09)

注意:不同类型坐标如需转换,请使用百度地图开放平台提供的标准坐标转换接口。请勿使用其他渠道提供的坐标转换方法,以免影响坐标转换精度。

服务配额

每个开发者账号每天调用“地点检索”API 服务的总次数(即配额)是有限的。

每个开发者账号每天调用“地点检索”API 服务的总次数(即并发量)是有限的。

若需要更高配额和并发量,请申请开发者认证以获取更高配额和更及时的技术支持。

同一个账号下的HTTP/HTTPS请求,配额,并发共享。


配额及默认并发量说明如下

分类 未认证 个人认证 企业认证
日配额(次) 2,000 30,000 300,000
分钟并发数(次/分钟) 120 3,000 12,000
服务常见问题
1、为什么有些POI在接口服务中检索不到?

出于数据保护目的,地点检索服务使用的数据非最新版。若有需求,请联系我们
【排查方法】同一地点,使用百度地图PC端或手机客户端能检索到,使用API接口无数据。

百度地图数据库中无该地点数据。请通过POI纠错平台上报,我们会尽快核实数据并添加上线。
【排查方法】同一地点,使用百度地图PC端或手机客户端和API接口均无返回数据。

检索结果中,相关数据过多,接口结果未展示完全。请通过"page_size","page_num"字段控制数据返回数量和翻页操作。
【排查方法】返回结果中,"total"参数值大于返回POI数量。

2、为什么每次访问服务,最多只返回400条数据?

出于数据保护目的,单次访问服务最多同时返回400条数据。此限制无法修改。请根据实际需求,通过添加分类、设置范围等方式,缩小检索范围。

3、为什么我设置了"region=北京",结果返回了其他城市的数据?

"region"参数表示检索城市偏重,会增加对应城市返回结果的权重,从而影响返回数据排序。但部分权重较高的其他城市地点,仍有可能召回(如:在北京检索"迪士尼",会返回上海数据)。
若需要限制返回结果仅为"region"参数对应的城市数据,请在使用"region"参数时,同时加上"city_limit=true"参数。

4、我能通过接口检索自己的地点数据吗?

地点检索API服务检索的数据为百度地图母库数据,若需要检索自己的业务地点数据,请使用LBS云服务.

2012年3月8日

V1.0

2013年4月7日

V2.0

2013年5月9日

V2.1

2016年10月28日

V2.2

2017年1月10日

V2.3


产品发布
地点检索服务V1.0正式上线
产品发布
地点检索服务V2.0正式上线

1. 新增查询单个POI详情服务

2. 地点检索服务区域查询支持设置返回分页数及每页显示的POI数,较之v1版本,增加可返回的数据条目

3. 支持返回POI的扩展字段(如评分、价格、评论数等)。
新增功能
开放团购API,支持城市内、矩形、圆形区域检索团购信息,且提供商家团购详情查询功能。
新增功能
新增city_limit参数(行政区划检索范围限定功能)
新增功能
新增"ret_coordtype=gcj02ll"参数,地点检索API服务全面支持国测局坐标

服务资源下载
百度地图城市名称-中心点经纬度(cityCenter)关系对照

您可以通过此文件获知百度地图的全国各城市中心点(cityCenter)经纬度


百度地图城市名称-城市代码(cityCode)关系对照

您可以通过此文件获知百度地图的全国各城市代码(cityCode)。 在使用百度地图API或SDK各种涉及citycode参数的服务时,您可参看此文件传入准确值,如JavaScript API的本地检索服务(根据cityCode获取本地检索结果)、Android SDK离线地图服务(根据cityCode,获取对应城市离线地图)等。
注意:cityCode为百度内部定义,已不再维护,请谨慎使用。


百度地图POI行业分类(tag)

您可以通过此链接获知百度地图POI(兴趣点)的tag引导体系,辅助您检索POI。 如检索query为百度地图的tag“生活服务”,返回的检索结果即包含关键字为“生活服务”的POI、也包含tag为“生活服务”的POI,从而聚焦检索结果。


  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消