产品服务
解决方案
文档与支持
定价
为什么选择百度地图
登录

文档全面上新

更科技的视觉体验，更高效的页面结构，快前往体验吧！

体验新版
（→‎poi周边搜索）
 
（未显示3个用户的32个中间版本）
第1行： 第1行：
 
{{cloud-sidebar}}
 
{{cloud-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></div><div class="contents"><div class="navRemark"><div class="handpointto">内容（服务介绍）</div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">云检索服务V3</div></div><div class="serve-explain-text">
−
==poi周边搜索==
+
云检索是一类Web API接口服务； 通过该服务，用户可对云存储中存储的自定义地理数据进行多场景的检索。 包含：周边检索，矩形检索，本地检索和详情检索。<br/><span style="color:#FF0000;">云检索服务V3将在近期停止新用户接入，已在使用云检索V3服务的用户仍可正常访问服务。<br/>V3版服务文档也将在近期下线，请接入服务的用户做好备份。</span>
−
 
+
</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>
−
周边检索是指以一点为中心（中心点通过location参数指定），搜索中心点附近指定距离范围（搜索半径通过radius参数指定）内的POI点。检索时可通过tags参数指定检索的类型；通过sortby参数进行检索结果的排序（支持多字段排序）；filter参数可以完成对指定数据范围的筛选。
+
用户可以一点为中心（中心点通过location参数指定），搜索中心点附近指定距离范围（搜索半径通过radius参数指定）内的POI点。检索时可通过tags参数指定检索的类型；通过sortby参数进行检索结果的排序（支持多字段排序）；filter参数可以完成对指定数据范围的筛选。
−
 
+
</div><div class="serveintorright">
−
例：搜索以“116.395884,39. 932154”为中心，1000米范围内价格在200到300的饭店，并将搜索结果按照距离和价格的升序排序。
+
http://mapopen-pub-webserviceapi.bj.bcebos.com/images/geosearch1.png
−
 
+
</div></div><div class="serveintortxt"><div class="serveintorleft"><div class="serveintoor-title">云存储数据矩形区域检索</div>
−
<source>
+
矩形检索是指可检索指定矩形范围内的poi信息，检索区域通过bounds参数设定的矩形的左下角和右上角的经纬度坐标来确定。检索时可通过tags参数指定检索类型；检索结果可通过sortby参数进行排序（支持多字段排序）；可通过filter参数筛选出指定的数据范围的结果。
−
http://api.map.baidu.com/geosearch/v3/nearby?ak=您的ak&geotable_id=****&location=116.395884,39.932154&radius=1000&tags=酒店&sortby=distance:1|price:1&filter=price:200,300
+
</div><div class="serveintorright">
−
</source>
+
http://mapopen-pub-webserviceapi.bj.bcebos.com/images/geosearch2.png
−
 
+
</div></div><div class="serveintortxt"><div class="serveintorleft"><div class="serveintoor-title">云存储数据本地检索</div>
−
'''请求url'''
+
本地检索是指可检索指定区域范围内的poi信息，区域通过region参数来设定，可以是全国范围也可以是小范围的如海淀区。检索时可通过tags参数指定检索类型；通过sortby参数对检索结果进行排序（支持多字段排序）；filter参数可以完成对指定数据范围的筛选。
−
 
+
</div><div class="serveintorright">
−
<source>
+
http://mapopen-pub-webserviceapi.bj.bcebos.com/images/geosearch3.png
−
http://api.map.baidu.com/geosearch/v3/nearby // GET请求
+
</div></div><div class="serveintortxt"><div class="serveintorleft"><div class="serveintoor-title">云存储数据详情检索</div>
−
</source>
+
用户可通过该功能，根据云存储数据表中的数据id，检索对应数据详情。
−
 
+
</div><div class="serveintorright">
−
'''请求参数'''
+
http://mapopen-pub-webserviceapi.bj.bcebos.com/images/geosearch4.png
 +
</div></div></div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">接口功能介绍<br/></div></div><div class="separate-title service-page-anchor">周边检索</div><div class="serve-explain-text"><div class="code-template"><pre class="get-url-pre">http://api.map.baidu.com/geosearch/v3/nearby?ak=您的ak&geotable_id=****&location=116.395884,39.932154&radius=1000&tags=酒店&sortby=distance:1|price:1&filter=price:200,300 //GET请求</pre>
 +
</div></div><div class="separate-title">请求参数</div>
 
{|
 
{|
 
|-
 
|-
−
!width="80" | 参数名
+
! width="80" | 参数名
−
!width="100" | 参数含义
+
! width="100" | 参数含义
−
!width="80" | 类型
+
! width="80" | 类型
−
!width="100" | 格式
+
! width="100" | 格式
−
!width="250" | 备注
+
! width="250" | 备注
 
|-
 
|-
−
|ak
+
| ak
−
|access_key
+
| access_key
−
|string(50)
+
| string(50)
−
|字符串
+
| 字符串
−
|必须
+
| 必选
 
|-
 
|-
−
|geotable_id
+
| geotable_id
−
|geotable主键
+
| geotable主键
−
|uint32
+
| uint32
−
|数字
+
| 数字
−
|必须
+
| 必选
 
|-
 
|-
−
|q
+
| q
−
|检索关键字
+
| 检索关键字
−
|string(45)
+
| string(45)
−
|任意汉字或数字，英文字母，可以为空字符
+
| 任意汉字或数字，英文字母，可以为空字符
−
|必须
+
| 可选
 
|-
 
|-
−
|location
+
| location
−
|检索的中心点
+
| 检索的中心点
−
|string(25)
+
| string(25)
−
|逗号分隔的经纬度
+
| 逗号分隔的经纬度
−
|必须
+
| 必选
 
样例：116.4321,38.76623
 
样例：116.4321,38.76623
 +
 
|-
 
|-
−
|coord_type
+
| coord_type
−
|坐标系
+
| 坐标系
−
|uint32
+
| uint32
−
|数字
+
| 数字
−
|可选
+
| 可选
−
3代表百度经纬度坐标系统
+
3代表百度经纬度坐标系统 4代表百度墨卡托系统
−
4代表百度墨卡托系统
+
 
 
|-
 
|-
−
|radius
+
| radius
−
|检索半径
+
| 检索半径
−
|uint32
+
| uint32
−
|单位为米，默认为1000
+
| 单位为米，默认为1000
−
|可选
+
| 可选
 
样例：500
 
样例：500
 +
 
|-
 
|-
−
|tags
+
| tags
−
|标签
+
| 标签
−
|string(45)
+
| string(45)
−
|空格分隔的多字符串
+
| 空格分隔的多字符串
−
|可选
+
| 可选
 
样例：美食 小吃
 
样例：美食 小吃
 +
 
|-
 
|-
−
|sortby
+
| sortby
−
|排序字段
+
| 排序字段
−
|string
+
| string
−
|“|”分隔的多个检索条件。
+
| ”分隔的多个检索条件。
−
格式为sortby={key1}:value1|{key2:val2|key3:val3}。
+
格式为sortby={key1:value1}&#124;{key2:val2}&#124;{key3:val3}。 最多支持16个字段排序 {keyname}:1 升序 {keyname}:-1 降序 以下keyname为系统预定义的： distance 距离排序 weight 权重排序
−
最多支持16个字段排序
+
 
−
{keyname}:1 升序
+
| 可选
−
{keyname}:-1 降序
+
默认为按weight排序 如果需要自定义排序则指定排序字段 样例：按照价格由便宜到贵排序 sortby=price:1
−
以下keyname为系统预定义的：
+
−
distance 距离排序
+
−
weight 权重排序
+
−
|可选
+
−
默认为按weight排序
+
−
如果需要自定义排序则指定排序字段
+
−
样例：按照价格由便宜到贵排序
+
−
sortby=price:1
+
  
 
|-
 
|-
−
|filter
+
| filter
−
|过滤条件
+
| 过滤条件
−
|string(50)
+
| string(50)
−
||竖线分隔的多个key-value对
+
| 竖线分隔的多个key-value对
−
key为筛选字段的名称(存储服务中定义)
+
key为筛选字段的名称(存储服务中定义) 支持连续区间或者离散区间的筛选： a:连续区间 key:value1,value2 b:离散区间 key:[value1,value2,value3,...]
−
支持连续区间或者离散区间的筛选：
+
 
−
a:连续区间 key:value1,value2
+
| 可选
−
b:离散区间 key:[value1,value2,value3,...]
+
样例: a:连续区间 样例：筛选价格为9.99到19.99并且生产时间为2013年的项 price:9.99,19.99&#124;time:2012,2012 b:离散区间 筛选价格为8,9,13，并且生产时间为2013年的项 price:[8,9,13]&#124;time:2012,2012 注：符号为英文半角中括号
−
|可选
+
 
−
样例:
+
−
a:连续区间
+
−
样例：筛选价格为9.99到19.99并且生产时间为2013年的项
+
−
price:9.99,19.99|time:2012,2012
+
−
b:离散区间
+
−
筛选价格为8,9,13，并且生产时间为2013年的项
+
−
price:[8,9,13]|time:2012,2012
+
−
注：符号为英文半角中括号
+
 
|-
 
|-
−
|page_index
+
| page_index
−
|分页索引
+
| 分页索引
−
|uint32
+
| uint32
−
|当前页标，从0开始
+
| 当前页标，从0开始
−
|可选
+
| 可选
 
默认为0
 
默认为0
 +
 
|-
 
|-
−
|page_size
+
| page_size
−
|分页数量
+
| 分页数量
−
|uint32
+
| uint32
−
|当前页面最大结果数
+
| 当前页面最大结果数
−
|可选
+
| 可选
 
默认为10，最多为50
 
默认为10，最多为50
 +
 
|-
 
|-
−
|callback
+
| callback
−
|回调函数
+
| 回调函数
−
|string(20)
+
| string(20)
−
|js回调函数
+
| js回调函数
−
|可选
+
| 可选
 
|-
 
|-
−
|sn
+
| sn
−
|用户的权限签名
+
| 用户的权限签名
−
|string(50)
+
| string(50)
−
|
+
|  
−
|可选
+
| 可选
 
|}
 
|}
−
 
+
<div class="separate-title">返回结果参数</div>
−
'''响应参数（json格式）'''
+
−
 
+
 
{|
 
{|
 
|-
 
|-
−
!width="150" colspan="2"| 参数名
+
! width="150" colspan="2" | 参数名
−
!width="120" | 参数含义
+
! width="120" | 参数含义
−
!width="120" | 类型
+
! width="120" | 类型
−
!width="250" | 备注
+
! width="250" | 备注
 
|-
 
|-
−
|colspan="2"|status
+
| colspan="2" | status
−
|状态码
+
| 状态码
−
|int32
+
| int32
−
|0表示成功，其他值详见状态码说明
+
| 0表示成功，其他值详见状态码说明
 
|-
 
|-
−
|colspan="2"|size
+
| colspan="2" | size
−
|分页参数，当前页返回数量
+
| 分页参数，当前页返回数量
−
|int32
+
| int32
 
|  
 
|  
 
|-
 
|-
−
|colspan="2"|total
+
| colspan="2" | total
−
|分页参数，所有召回数量
+
| 分页参数，所有召回数量
−
|int32
+
| int32
 
|  
 
|  
 
|-
 
|-
−
| rowspan="13" width="70"| contents
+
| rowspan="13" width="70" | contents
−
|uid
+
| uid
−
|数据id
+
| 数据id
−
|string
+
| string
 
|  
 
|  
 
|-
 
|-
−
|geotable_id
+
| geotable_id
−
|geotable_id
+
| geotable_id
−
|string
+
| string
 
|  
 
|  
 
|-
 
|-
−
|title
+
| title
−
|poi名称
+
| poi名称
−
|string
+
| string
 
|  
 
|  
 
|-
 
|-
−
|adderss
+
| address
−
|poi地址
+
| poi地址
−
|string
+
| string
 
|  
 
|  
 
|-
 
|-
−
|province
+
| province
−
|poi所属省
+
| poi所属省
−
|string(20)
+
| string(20)
 
|  
 
|  
 
|-
 
|-
−
|city
+
| city
−
|poi所属城市
+
| poi所属城市
−
|string(20)
+
| string(20)
 
|  
 
|  
 
|-
 
|-
−
|district
+
| district
−
|poi所属区
+
| poi所属区
−
|string(20)
+
| string(20)
 
|  
 
|  
 
|-
 
|-
−
|coord_type
+
| coord_type
−
|坐标系定义
+
| 坐标系定义
−
|int32
+
| int32
−
|可选
+
| 可选
−
3代表百度经纬度坐标系统
+
3代表百度经纬度坐标系统 4代表百度墨卡托系统
−
4代表百度墨卡托系统
+
 
 
|-
 
|-
−
|location
+
| location
−
|经纬度
+
| 经纬度
−
|array
+
| array
 
|  
 
|  
 
|-
 
|-
−
|tags
+
| tags
−
|poi的标签
+
| poi的标签
−
|string
+
| string
 
|  
 
|  
 
|-
 
|-
−
|distance
+
| distance
−
|距离
+
| 距离，单位为米
−
|int32
+
| int32
 
|  
 
|  
 
|-
 
|-
−
|weight
+
| weight
−
|权重
+
| 权重
−
|int32
+
| int32
 
|  
 
|  
 
|-
 
|-
−
|{column}
+
| {column}
−
|自定义列
+
| 自定义列
−
|自定义类型
+
| 自定义类型
−
|自定义列/値，云存储未添加値时不返回
+
| 自定义列/値，云存储未添加値时不返回
 
|}
 
|}
−
 
+
<div class="separate-title">服务示例</div>
−
'''请求响应示例 '''
+
http://lbsyun.baidu.com/static/img/geosearch-1.jpg
−
 
+
<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/geosearch/v3/bound?ak=您的ak&geotable_id=****bounds=116.30,36.20;117.30,37.20 &sortby=price:1&tags=酒店&filer=price:200,300 //GET请求</pre>
−
http://developer.baidu.com/map/static/img/geosearch-1.jpg
+
</div></div><div class="separate-title">请求参数</div>
−
 
+
−
==poi本地检索==
+
−
 
+
−
本地检索是指可检索指定区域范围内的poi信息，区域通过region参数来设定，可以是全国范围也可以是小范围的如海淀区。检索时可通过tags参数指定检索类型；通过sortby参数对检索结果进行排序（支持多字段排序）；filter参数可以完成对指定数据范围的筛选。
+
−
 
+
−
例：搜索北京范围内的价格在200到300之间的酒店并将搜索结果按照距离和价格降序排序。
+
−
 
+
−
 
+
−
<source>
+
−
http://api.map.baidu.com/geosearch/v3/local?region=北京&ak=您的ak&geotable_id=****&tags=酒店&sortby=distance:1|price:1 &filter=price:200,300
+
−
</source>
+
−
 
+
−
 
+
−
'''2.1 请求url'''
+
−
 
+
−
 
+
−
<source>
+
−
http://api.map.baidu.com/geosearch/v3/local // GET请求
+
−
</source>
+
−
 
+
−
 
+
−
'''2.2 请求参数'''
+
 
{|
 
{|
 
|-
 
|-
−
!参数名
+
! width="80" | 参数名
−
!参数含义
+
! width="100" | 参数含义
−
!类型
+
! width="80" | 类型
−
!格式
+
! width="100" | 格式
−
!备注
+
! width="250" | 备注
 
|-
 
|-
−
|ak
+
| ak
−
|access_key
+
| access_key
−
|string(50)
+
| string(50)
−
|字符串
+
| 字符串
−
|必须
+
| 必选
 
|-
 
|-
−
|geotable_id
+
| geotable_id
−
|geotable主键
+
| geotable主键
−
|uint32
+
| uint32
−
|数字
+
| 数字
−
|必须
+
| 必选
 
|-
 
|-
−
|q
+
| q
−
|检索关键字
+
| 检索关键字
−
|string(45)
+
| string(45)
−
|任意汉字或数字，英文字母，可以为空字符
+
| 任意汉字或数字，英文字母，可以为空字符
−
|必须
+
| 必选
 
|-
 
|-
−
|coord_type
+
| bounds
−
|坐标系
+
| 矩形区域
−
|uint32
+
| String(25)
−
|数字
+
| 左下角和右上角的经纬度坐标点。2个点用;号分隔
−
|可选
+
| 必选
−
3代表百度经纬度坐标系统
+
样例：116.30,36.20;117.30,37.20
−
4代表百度墨卡托系统
+
 
−
|-
+
−
|region
+
−
|检索区域名称
+
−
|String(25)
+
−
|市或区的名字，如北京市，海淀区。
+
−
|可选,此接口推荐填写该参数
+
−
否则，默认按照全国范围来检索
+
 
|-
 
|-
−
|tags
+
| tags
−
|标签
+
| 标签
−
|string(45)
+
| string(45)
−
|空格分隔的多字符串
+
| 空格分隔的多字符串
−
|可选
+
| 可选
 
样例：美食 小吃
 
样例：美食 小吃
 +
 
|-
 
|-
−
|sortby
+
| coord_type
−
|排序字段
+
| 坐标系
−
|string
+
| unit32
−
|“|”分隔的多个检索条件。
+
| 数字
−
格式为sortby={key1}:value1|{key2:val2|key3:val3}。
+
| 可选
−
最多支持16个字段排序
+
3代表百度经纬度坐标系统 4代表百度墨卡托系统
−
{keyname}:1 升序
+
−
{keyname}:-1 降序
+
−
以下keyname为系统预定义的：
+
−
distance 距离排序
+
−
weight 权重排序
+
−
|可选
+
−
默认为按weight排序
+
−
如果需要自定义排序则指定排序字段
+
−
样例：按照价格由便宜到贵排序
+
−
sortby=price:1
+
  
 
|-
 
|-
−
|filter
+
| sortby
−
|过滤条件
+
| 排序字段
−
|string(50)
+
| string
−
||竖线分隔的多个key-value对
+
| ”分隔的多个检索条件。<br/>格式为：sortby={key1}:value1&#124;{key2:val2&#124;key3:val3}。<br/>最多支持16个字段排序<br/>{keyname}:1 升序<br/>{keyname}:-1 降序<br/>系统预定义的keyname：weight 权重排序
−
key为筛选字段的名称(存储服务中定义)
+
| 可选<br/>默认为按weight排序<br/>如果需要自定义排序则指定排序字段<br/>样例：按照价格由便宜到贵排序<br/>sortby=price:1
−
支持连续区间或者离散区间的筛选：
+
−
a:连续区间 key:value1,value2
+
−
b:离散区间 key:[value1,value2,value3,...]
+
−
|可选
+
−
样例:
+
−
a:连续区间
+
−
样例：筛选价格为9.99到19.99并且生产时间为2013年的项
+
−
price:9.99,19.99|time:2012,2012
+
−
b:离散区间
+
−
筛选价格为8,9,13，并且生产时间为2013年的项
+
−
price:[8,9,13]|time:2012,2012
+
−
注：符号为英文半角中括号
+
 
|-
 
|-
−
|page_index
+
| filter
−
|分页索引
+
| 过滤条件
−
|uint32
+
| string(50)
−
|当前页标，从0开始
+
| 竖线分隔的多个key-value对key为筛选字段的名称(存储服务中定义)<br/>支持连续区间或者离散区间的筛选：<br/>a:连续区间 key:value1,value2<br/>b:离散区间 key:[value1,value2,value3,...]
−
|可选
+
| 可选
 +
样例: a:连续区间 样例：筛选价格为9.99到19.99并且生产时间为2013年的项 price:9.99,19.99&#124;time:2012,2012 b:离散区间 筛选价格为8,9,13，并且生产时间为2013年的项 price:[8,9,13]&#124;time:2012,2012 注：符号为英文半角中括号
 +
 
 +
|-
 +
| page_index
 +
| 分页索引
 +
| uint32
 +
| 当前页标，从0开始
 +
| 可选
 
默认为0
 
默认为0
 +
 
|-
 
|-
−
|page_size
+
| page_size
−
|分页数量
+
| 分页数量
−
|uint32
+
| uint32
−
|当前页面最大结果数
+
| 当前页面最大结果数
−
|可选
+
| 可选
 
默认为10，最多为50
 
默认为10，最多为50
 +
 
|-
 
|-
−
|callback
+
| callback
−
|回调函数
+
| 回调函数
−
|string(20)
+
| string(20)
−
|js回调函数
+
| js回调函数
−
|可选
+
| 可选
 
|-
 
|-
−
|sn
+
| sn
−
|用户的权限签名
+
| 用户的权限签名
−
|string(50)
+
| string(50)
−
|
+
|  
−
|可选
+
| 可选
 
|}
 
|}
−
'''2.3 响应参数（json格式）'''
+
<div class="separate-title">返回结果参数</div>
 
{|
 
{|
 
|-
 
|-
−
!参数名
+
! width="150" colspan="2" | 参数名
−
!参数含义
+
! width="150" | 参数含义
−
!类型
+
! width="120" | 类型
−
!备注
+
! width="200" | 备注
 
|-
 
|-
−
|status
+
| colspan="2" | status
−
|状态码
+
| 状态码
−
|int32
+
| int32
−
|0表示成功，其他值详见状态码说明
+
| 0表示成功，其他值详见状态码说明
 
|-
 
|-
−
|size
+
| colspan="2" | size
−
|分页参数，当前页返回数量
+
| 分页参数，当前页返回数量
−
|int32
+
| int32
 
|  
 
|  
 
|-
 
|-
−
|total
+
| colspan="2" | total
−
|分页参数，所有召回数量
+
| 分页参数，所有召回数量
−
|int32
+
| int32
 
|  
 
|  
 
|-
 
|-
−
|contents
+
| rowspan="13" | contents
−
|poi结果列表
+
| uid
−
|array
+
| 数据id
 +
| string
 
|  
 
|  
 
|-
 
|-
−
|uid
+
| geotable_id
−
|数据id
+
| geotable_id
−
|string
+
| string
 
|  
 
|  
 
|-
 
|-
−
|geotable_id
+
| title
−
|geotable_id
+
| poi名称
−
|string
+
| string
 
|  
 
|  
 
|-
 
|-
−
|title
+
| address
−
|poi名称
+
| poi地址
−
|string
+
| string
 
|  
 
|  
 
|-
 
|-
−
|adderss
+
| province
−
|poi地址
+
| poi所属省
−
|string
+
| string(20)
 
|  
 
|  
 
|-
 
|-
−
|province
+
| city
−
|poi所属省
+
| poi所属城市
−
|string(20)
+
| string(20)
 
|  
 
|  
 
|-
 
|-
−
|city
+
| district
−
|poi所属城市
+
| poi所属区
−
|string(20)
+
| string(20)
 
|  
 
|  
 
|-
 
|-
−
|district
+
| location
−
|poi所属区
+
| 经纬度
−
|string(20)
+
| array
 
|  
 
|  
 
|-
 
|-
−
|location
+
| coord_type
−
|经纬度
+
| 坐标系定义
−
|array
+
| int32
 +
| 3代表百度经纬度坐标系统，4代表百度墨卡托系统
 +
|-
 +
| tags
 +
| poi的标签
 +
| string
 
|  
 
|  
 
|-
 
|-
−
|coord_type
+
| distance
−
|坐标系定义
+
| 距离，单位为米
−
|int32
+
| int32
−
|可选
+
−
3代表百度经纬度坐标系统
+
−
4代表百度墨卡托系统
+
−
|-
+
−
|tags
+
−
|poi的标签
+
−
|string
+
−
|多个tag用空格分隔
+
−
|-
+
−
|distance
+
−
|距离
+
−
|int32
+
 
|  
 
|  
 
|-
 
|-
−
|weight
+
| weight
−
|权重
+
| 权重
−
|int32
+
| int32
 
|  
 
|  
 
|-
 
|-
−
|{column}
+
| {column}
−
|自定义列
+
| 自定义列
−
|自定义类型
+
| 自定义类型
−
|自定义列/値，云存储未添加値时不返回
+
| 自定义列/値，云存储未添加値时不返回
 
|}
 
|}
−
'''2.4 请求响应示例 '''
+
<div class="separate-title">服务示例</div>
−
==poi矩形检索==
+
http://lbsyun.baidu.com/static/img/geosearch-3.jpg
−
 
+
<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/geosearch/v3/local?region=北京&ak=您的ak&geotable_id=****&tags=酒店&sortby=distance:1|price:1 &filter=price:200,300 //GET请求</pre>
−
矩形检索是指可检索指定矩形范围内的poi信息，检索区域通过bounds参数设定的矩形的左下角和右上角的经纬度坐标来确定。检索时可通过tags参数指定检索类型；检索结果可通过sortby参数进行排序（支持多字段排序）；可通过filter参数筛选出指定的数据范围的结果。
+
</div></div><div class="separate-title">请求参数</div>
−
 
+
−
例：搜索以“116.30,36.20”为左下角以“117.30,37.20”为右上角的矩形范围内的价格在200到300之间的酒店并将搜索结果按照距离和价格降序排序。
+
−
 
+
−
 
+
−
<source>
+
−
http://api.map.baidu.com/geosearch/v3/bound?ak=您的ak&geotable_id=****bounds=116.30,36.20;117.30,37.20 &sortby=distance:1|price:1&tags=酒店&filer=price:200,300
+
−
</source>
+
−
 
+
−
 
+
−
'''3.1 请求url'''
+
−
 
+
−
 
+
−
<source>
+
−
http://api.map.baidu.com/geosearch/v3/bound // GET请求
+
−
</source>
+
−
 
+
−
 
+
−
'''3.2 请求参数'''
+
 
{|
 
{|
 
|-
 
|-
−
!参数名
+
! width="80" | 参数名
−
!参数含义
+
! width="100" | 参数含义
−
!类型
+
! width="80" | 类型
−
!格式
+
! width="100" | 格式
−
!备注
+
! width="250" | 备注
 
|-
 
|-
−
|ak
+
| ak
−
|access_key
+
| access_key
−
|string(50)
+
| string(50)
−
|字符串
+
| 字符串
−
|必须
+
| 必选
 
|-
 
|-
−
|geotable_id
+
| geotable_id
−
|geotable主键
+
| geotable主键
−
|uint32
+
| uint32
−
|数字
+
| 数字
−
|必须
+
| 必选
 
|-
 
|-
−
|q
+
| q
−
|检索关键字
+
| 检索关键字
−
|string(45)
+
| string(45)
−
|任意汉字或数字，英文字母，可以为空字符
+
| 任意汉字或数字，英文字母，可以为空字符
−
|必须
+
| 必选
 
|-
 
|-
−
|bounds
+
| coord_type
−
|矩形区域
+
| 坐标系
−
|String(25)
+
| uint32
−
|左下角和右上角的经纬度坐标点。2个点用;号分隔
+
| 数字
−
|必须
+
| 可选
−
样例：116.30,36.20;117.30,37.20
+
3代表百度经纬度坐标系统 4代表百度墨卡托系统
 +
 
 +
|-
 +
| region
 +
| 检索区域名称
 +
| String(25)
 +
| 市或区的名字，如北京市，海淀区。
 +
| 可选,此接口推荐填写该参数
 +
否则，默认按照全国范围来检索
 +
 
 
|-
 
|-
−
|tags
+
| tags
−
|标签
+
| 标签
−
|string(45)
+
| string(45)
−
|空格分隔的多字符串
+
| 空格分隔的多字符串
−
|可选
+
| 可选
 
样例：美食 小吃
 
样例：美食 小吃
 +
 
|-
 
|-
−
|coord_type
+
| sortby
−
|坐标系
+
| 排序字段
−
|unit32
+
| string
−
|数字
+
| ”分隔的多个检索条件。
−
|可选
+
格式为sortby={key1}:value1&#124;{key2:val2&#124;key3:val3}。 最多支持16个字段排序 {keyname}:1 升序 {keyname}:-1 降序 以下keyname为系统预定义的： distance 距离排序 weight 权重排序
−
3代表百度经纬度坐标系统
+
 
−
4代表百度墨卡托系统
+
|  
 +
可选 默认为按weight排序 如果需要自定义排序则指定排序字段 样例：按照价格由便宜到贵排序 sortby=price:1
 +
 
 
|-
 
|-
−
|sortby
+
| filter
−
|排序字段
+
| 过滤条件
−
|string
+
| string(50)
−
|“|”分隔的多个检索条件。
+
| 竖线分隔的多个key-value对
−
格式为sortby={key1}:value1|{key2:val2|key3:val3}。
+
key为筛选字段的名称(存储服务中定义) 支持连续区间或者离散区间的筛选： a:连续区间 key:value1,value2 b:离散区间 key:[value1,value2,value3,...]
−
最多支持16个字段排序
+
 
−
{keyname}:1 升序
+
| 可选
−
{keyname}:-1 降序
+
样例: a:连续区间 样例：筛选价格为9.99到19.99并且生产时间为2013年的项 price:9.99,19.99&#124;time:2012,2012 b:离散区间 筛选价格为8,9,13，并且生产时间为2013年的项 price:[8,9,13]&#124;time:2012,2012 注：符号为英文半角中括号
−
以下keyname为系统预定义的：
+
−
distance 距离排序
+
−
weight 权重排序
+
−
|可选
+
−
默认为按weight排序
+
−
如果需要自定义排序则指定排序字段
+
−
样例：按照价格由便宜到贵排序
+
−
sortby=price:1
+
  
 
|-
 
|-
−
|filter
+
| page_index
−
|过滤条件
+
| 分页索引
−
|string(50)
+
| uint32
−
||竖线分隔的多个key-value对
+
| 当前页标，从0开始
−
key为筛选字段的名称(存储服务中定义)
+
| 可选
−
支持连续区间或者离散区间的筛选：
+
−
a:连续区间 key:value1,value2
+
−
b:离散区间 key:[value1,value2,value3,...]
+
−
|可选
+
−
样例:
+
−
a:连续区间
+
−
样例：筛选价格为9.99到19.99并且生产时间为2013年的项
+
−
price:9.99,19.99|time:2012,2012
+
−
b:离散区间
+
−
筛选价格为8,9,13，并且生产时间为2013年的项
+
−
price:[8,9,13]|time:2012,2012
+
−
注：符号为英文半角中括号
+
−
|-
+
−
|page_index
+
−
|分页索引
+
−
|uint32
+
−
|当前页标，从0开始
+
−
|可选
+
 
默认为0
 
默认为0
 +
 
|-
 
|-
−
|page_size
+
| page_size
−
|分页数量
+
| 分页数量
−
|uint32
+
| uint32
−
|当前页面最大结果数
+
| 当前页面最大结果数
−
|可选
+
| 可选
 
默认为10，最多为50
 
默认为10，最多为50
 +
 
|-
 
|-
−
|callback
+
| callback
−
|回调函数
+
| 回调函数
−
|string(20)
+
| string(20)
−
|js回调函数
+
| js回调函数
−
|可选
+
| 可选
 
|-
 
|-
−
|sn
+
| sn
−
|用户的权限签名
+
| 用户的权限签名
−
|string(50)
+
| string(50)
−
|
+
|  
−
|可选
+
| 可选
 
|}
 
|}
−
'''3.3 响应参数（json格式）'''
+
<div class="separate-title">返回结果参数</div>
 
{|
 
{|
 
|-
 
|-
−
!参数名
+
! width="150" colspan="2" | 参数名
−
!参数含义
+
! width="150" | 参数含义
−
!类型
+
! width="120" | 类型
−
!备注
+
! width="200" | 备注
 
|-
 
|-
−
|status
+
| colspan="2" | status
−
|状态码
+
| 状态码
−
|int32
+
| int32
−
|0表示成功，其他值详见状态码说明
+
| 0表示成功，其他值详见状态码说明
 
|-
 
|-
−
|size
+
| colspan="2" | size
−
|分页参数，当前页返回数量
+
| 分页参数，当前页返回数量
−
|int32
+
| int32
 
|  
 
|  
 
|-
 
|-
−
|total
+
| colspan="2" | total
−
|分页参数，所有召回数量
+
| 分页参数，所有召回数量
−
|int32
+
| int32
 
|  
 
|  
 
|-
 
|-
−
|contents
+
| rowspan="13" | contents
−
|poi结果列表
+
| uid
−
|array
+
| 数据id
 +
| string
 
|  
 
|  
 
|-
 
|-
−
|uid
+
| geotable_id
−
|数据id
+
| geotable_id
−
|string
+
| string
 
|  
 
|  
 
|-
 
|-
−
|geotable_id
+
| title
−
|geotable_id
+
| poi名称
−
|string
+
| string
 
|  
 
|  
 
|-
 
|-
−
|title
+
| address
−
|poi名称
+
| poi地址
−
|string
+
| string
 
|  
 
|  
 
|-
 
|-
−
|adderss
+
| province
−
|poi地址
+
| poi所属省
−
|string
+
| string(20)
 
|  
 
|  
 
|-
 
|-
−
|province
+
| city
−
|poi所属省
+
| poi所属城市
−
|string(20)
+
| string(20)
 
|  
 
|  
 
|-
 
|-
−
|city
+
| district
−
|poi所属城市
+
| poi所属区
−
|string(20)
+
| string(20)
 
|  
 
|  
 
|-
 
|-
−
|district
+
| location
−
|poi所属区
+
| 经纬度
−
|string(20)
+
| array
 
|  
 
|  
 
|-
 
|-
−
|location
+
| coord_type
−
|经纬度
+
| 坐标系定义
−
|array
+
| int32
−
|  
+
| 可选
 +
3代表百度经纬度坐标系统 4代表百度墨卡托系统
 +
 
 
|-
 
|-
−
|coord_type
+
| tags
−
|坐标系定义
+
| poi的标签
−
|int32
+
| string
−
|3代表百度经纬度坐标系统，4代表百度墨卡托系统
+
| 多个tag用空格分隔
 
|-
 
|-
−
|tags
+
| distance
−
|poi的标签
+
| 距离，单位为米
−
|string
+
| int32
 
|  
 
|  
 
|-
 
|-
−
|distance
+
| weight
−
|距离
+
| 权重
−
|int32
+
| int32
 
|  
 
|  
 
|-
 
|-
−
|weight
+
| {column}
−
|权重
+
| 自定义列
−
|int32
+
| 自定义类型
−
|
+
| 自定义列/値，云存储未添加値时不返回
−
|-
+
−
|{column}
+
−
|自定义列
+
−
|自定义类型
+
−
|自定义列/値，云存储未添加値时不返回
+
 
|}
 
|}
−
'''3.4 请求响应示例 '''
+
<div class="separate-title">服务示例</div>
−
==poi详情检索==
+
http://lbsyun.baidu.com/static/img/geosearch-2.jpg
−
 
+
−
'''4.1 请求url'''
+
−
 
+
  
−
<source>
 
−
http://api.map.baidu.com/geosearch/v3/detail/{uid} // GET请求
 
−
</source>
 
  
−
 
+
<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/geosearch/v3/detail/{uid} //GET请求</pre>
−
注意：uid为poi点的id值
+
</div></div><div class="separate-title">请求参数</div>
−
 
+
−
'''4.2 请求参数'''
+
 
{|
 
{|
 
|-
 
|-
−
!参数名
+
! width="100" | 参数名
−
!参数含义
+
! width="120" | 参数含义
−
!类型
+
! width="120" | 类型
−
!备注
+
! width="250" | 备注
 
|-
 
|-
−
|ak
+
| ak
−
|access_key
+
| access_key
−
|string(50)
+
| string(50)
−
|必须
+
| 必选
 
|-
 
|-
−
|geotable_id
+
| geotable_id
−
|geotable表主键
+
| geotable表主键
−
|int32
+
| int32
−
|必选
+
| 必选
 
|-
 
|-
−
|coord_type
+
| coord_type
−
|坐标系
+
| 坐标系
−
|uint32
+
| uint32
−
|可选
+
| 可选
−
3代表百度经纬度坐标系统
+
3代表百度经纬度坐标系统 4代表百度墨卡托系统
−
4代表百度墨卡托系统
+
 
 
|-
 
|-
−
|sn
+
| sn
−
|用户的权限签名
+
| 用户的权限签名
−
|string(50)
+
| string(50)
−
|可选
+
| 可选
 
|}
 
|}
−
'''4.3 响应参数（json格式）'''
+
<div class="separate-title">返回结果参数</div>
 
{|
 
{|
 
|-
 
|-
−
!参数名
+
! width="150" colspan="2" | 参数名
−
!参数含义
+
! width="150" | 参数含义
−
!类型
+
! width="120" | 类型
−
!备注
+
! width="200" | 备注
 
|-
 
|-
−
|status
+
| colspan="2" | status
−
|状态码
+
| 状态码
−
|int32
+
| int32
−
|0代表成功，其它取值含义另行说明
+
| 0代表成功，其它取值含义另行说明
 
|-
 
|-
−
|size
+
| colspan="2" | size
−
|分页参数，当前页返回数量
+
| 分页参数，当前页返回数量
−
|int32
+
| int32
 
|  
 
|  
 
|-
 
|-
−
|total
+
| colspan="2" | total
−
|分页参数，所有召回数量
+
| 分页参数，所有召回数量
−
|int32
+
| int32
 
|  
 
|  
 
|-
 
|-
−
|contents
+
| rowspan="13" | contents
−
|poi结果列表
+
| uid
−
|array
+
| 数据id
−
|
+
| string
−
|-
+
−
|uid
+
−
|数据id
+
−
|string
+
 
|  
 
|  
 
|-
 
|-
−
|geotable_id
+
| geotable_id
−
|geotable_id
+
| geotable_id
−
|string
+
| string
 
|  
 
|  
 
|-
 
|-
−
|title
+
| title
−
|Poi地址
+
| Poi地址
−
|string
+
| string
 
|  
 
|  
 
|-
 
|-
−
|adderss
+
| address
−
|poi名称
+
| poi名称
−
|string
+
| string
 
|  
 
|  
 
|-
 
|-
−
|province
+
| province
−
|poi所属省
+
| poi所属省
−
|string
+
| string
 
|  
 
|  
 
|-
 
|-
−
|city
+
| city
−
|poi所属城市
+
| poi所属城市
−
|string(20)
+
| string(20)
 
|  
 
|  
 
|-
 
|-
−
|district
+
| district
−
|poi所属区
+
| poi所属区
−
|string(20)
+
| string(20)
 
|  
 
|  
 
|-
 
|-
−
|location
+
| location
−
|经纬度
+
| 经纬度
−
|array
+
| array
 
|  
 
|  
 
|-
 
|-
−
|coord_type
+
| coord_type
−
|坐标系定义
+
| 坐标系定义
−
|int32
+
| int32
−
|3代表百度经纬度坐标系统，4代表百度墨卡托系统
+
| 3代表百度经纬度坐标系统，4代表百度墨卡托系统
 
|-
 
|-
−
|tags
+
| tags
−
|poi的标签
+
| poi的标签
−
|string
+
| string
 
|  
 
|  
 
|-
 
|-
−
|distance
+
| distance
−
|距离
+
| 距离，单位为米
−
|int32
+
| int32
 
|  
 
|  
 
|-
 
|-
−
|weight
+
| weight
−
|权重
+
| 权重
−
|int32
+
| int32
 
|  
 
|  
 
|-
 
|-
−
|{column}
+
| {column}
−
|自定义列
+
| 自定义列
−
|自定义类型
+
| 自定义类型
−
|自定义列/値，云存储未添加値时不返回
+
| 自定义列/値，云存储未添加値时不返回
 
|}
 
|}
−
'''4.4 请求响应示例 '''
+
<div class="separate-title">服务示例</div>
−
 
+
http://lbsyun.baidu.com/static/img/geosearch-4.jpg
−
'''状态码说明'''
+
<div class="bluetitle"><div class="services-title-text">状态码<br/></div></div>
 
{|
 
{|
 
|-
 
|-
−
|0
+
! width="100" | 状态码
−
|成功
+
! width="200" | 定义
 +
! width="300" | 注释
 
|-
 
|-
−
|1
+
| 0
−
|服务器内部错误
+
| 正常
 +
|  
 
|-
 
|-
−
|2
+
| 1
−
|请求参数非法
+
| 服务器内部错误
 +
| 该服务响应超时或系统内部错误，请留下联系方式
 
|-
 
|-
−
|3
+
| 10
−
|权限校验失败
+
| 上传内容超过8M
 +
| Post上传数据不能超过8M
 
|-
 
|-
−
|4
+
| 101
−
|配额校验失败
+
| AK参数不存在
 +
| 请求消息没有携带AK参数
 
|-
 
|-
−
|5
+
| 102
−
|ak不存在或者非法
+
| MCODE参数不存在，mobile类型mcode参数必需
 +
| 对于Mobile类型的应用请求需要携带mcode参数，该错误码代表服务器没有解析到mcode
 
|-
 
|-
−
|101
+
| 200
−
|服务禁用
+
| APP不存在，AK有误请检查再重试
 +
| 根据请求的ak，找不到对应的APP
 
|-
 
|-
−
|102
+
| 201
−
|不通过白名单或者安全码不对
+
| APP被用户自己禁用，请在控制台解禁
−
|}
+
|  
−
'''权限配额相关的部分错误码：'''
+
−
{|
+
 
|-
 
|-
−
|202-205、210、233
+
| 202
−
|无请求权限
+
| APP被管理员删除
 +
| 恶意APP被管理员删除
 
|-
 
|-
−
|231
+
| 203
−
|用户uid，ak不存在
+
| APP类型错误
 +
| 当前API控制台支持Server(类型1), Mobile(类型2, 新版控制台区分为Mobile_Android(类型21)及Mobile_IPhone（类型22））及Browser（类型3），除此之外其他类型认为是APP类型错误
 
|-
 
|-
−
|232
+
| 210
−
|用户、ak被封禁
+
| APP IP校验失败
 +
| 在申请SERVER类型应用的时候选择IP校验，需要填写IP白名单，如果当前请求的IP地址不在IP白名单或者不是0.0.0.0/0就认为IP校验失败
 
|-
 
|-
−
|233
+
| 211
−
|sn签名计算错误
+
| APP SN校验失败
 +
| SERVER类型APP有两种校验方式IP校验和SN校验，当用户请求的SN和服务端计算出来的SN不相等的时候提示SN校验失败
 
|-
 
|-
−
|210
+
| 220
−
|权限资源不存在
+
| APP Referer校验失败
 +
| 浏览器类型的APP会校验referer字段是否存且切在referer白名单里面，否则返回该错误码
 
|-
 
|-
−
|345
+
| 230
−
|分钟配额超额
+
| APP Mcode码校验失败
 +
| 服务器能解析到mcode，但和数据库中不一致，请携带正确的mcode
 
|-
 
|-
−
|346
+
| 240
−
|月配额超额
+
| APP 服务被禁用
 +
| 用户在API控制台中创建或设置某APP的时候禁用了某项服务
 
|-
 
|-
−
|347
+
| 250
−
|年配额超额
+
| 用户不存在
 +
| 根据请求的user_id, 数据库中找不到该用户的信息，请携带正确的user_id
 
|-
 
|-
−
|348
+
| 251
−
|永久配额超额无请求权限
+
| 用户被自己删除
 +
| 该用户处于未激活状态
 
|-
 
|-
−
|355
+
| 252
−
|日配额超额
+
| 用户被管理员删除
 +
| 恶意用户被加入黑名单
 
|-
 
|-
−
|350
+
| 260
−
|配额资源不存在
+
| 服务不存在
 +
| 服务器解析不到用户请求的服务名称
 +
|-
 +
| 261
 +
| 服务被禁用
 +
| 该服务已下线
 +
|-
 +
| 301
 +
| 永久配额超限，限制访问
 +
| 配额超限，如果想增加配额请[http://lbsyun.baidu.com/index.php?title=open/help_index 联系我们]
 +
|-
 +
| 302
 +
| 天配额超限，限制访问
 +
| 配额超限，如果想增加配额请[http://lbsyun.baidu.com/index.php?title=open/help_index 联系我们]
 +
|-
 +
| 401
 +
| 当前并发量已经超过约定并发配额，限制访问
 +
| 并发控制超限，请控制并发量或[http://lbsyun.baidu.com/index.php?title=open/help_index 联系我们]
 +
|-
 +
| 402
 +
| 当前并发量已经超过约定并发配额，并且服务总并发量也已经超过设定的总并发配额，限制访问
 +
| 并发控制超限，请控制并发量或[http://lbsyun.baidu.com/index.php?title=open/help_index 联系我们]
 
|}
 
|}
 +
</div><div class="navRemark"><div class="handpointto">内容（使用指南）</div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">使用方法</div></div><div class="devguide"><div class="leftborderbg" style="height:1500px;"></div><div class="devguideorder"><span>1</span>申请百度账号</div><div class="devguidecenter">百度地图开放平台所有服务申请均需在登录百度账号前提下进行。使用服务前请先申请注册百度账号。 [https://passport.baidu.com/v2/?reg&tt=1495093911000&gid=8931E63-8868-4768-BCA2-ECD56CFB963B&tpl=mn&u=https://www.baidu.com/ 点此申请]</div><div class="devguideorder"><span>2</span>申请成为百度开发者</div><div class="devguidecenter">登录百度账号后，请申请百度地图开放平台开发者，即可开始使用相关服务。 [http://lbsyun.baidu.com/apiconsole/key 点此申请]</div><div class="devguideorder"><span>3</span>获取服务密钥（ak）</div><div class="devguidecenter">发送服务请求，需使用ak参数进行鉴权（必选）。发送服务请求前需先创建ak。 [http://lbsyun.baidu.com/apiconsole/key/create 点此创建]</div><div class="devguideorder"><span>4</span>使用云存储服务，创建位置数据表</div><div class="devguidecenter">使用云地理编码解析自定义地理数据，首先需使用[http://lbsyun.baidu.com/index.php?title=lbscloud/api/geodata 云存储]服务，创建位置数据表，编辑自定义地址数据。创建数据表成功，获取位置数据表id（geotable_id）</div><div class="devguideorder"><span>5</span>拼写请求URL，使用服务获取结果<br/></div><div class="devguidecenter">拼写请求URL，使用geotable_id，解析位置数据表中的自定义地址数据。</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;"
 +
|-
 +
| style="text-align: center; width: 91px;" | '''字符集合'''
 +
| style="width: 823px; text-align: center;" | '''字符'''
 +
|-
 +
| 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/>
 +
| style="width: 823px;" | &nbsp;! * ' ( )&nbsp;;&nbsp;: @ & = + $ , /&nbsp;?&nbsp;% # [ ]<br/>
 +
|}
 +
 +
如果中文参数中使用URL保留字字符的字面意思，例如：region关键字取值为"?北京"，检索关键字包含一个问号，此问号也必须进行编码。<br/><br/>附注：
 +
 +
{{bluepoint}}javascript中一般采用encodeURIComponent函数对特殊字符进行编码。
 +
 +
{{bluepoint}}Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
 +
 +
{{bluepoint}}C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
 +
 +
{{bluepoint}}php中可以使用函数urlencode对特殊字符进行编码。
 +
<div class="bluetitle"><div class="services-title-text">坐标系说明</div></div>
 +
{{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>
 +
<div class="bluetitle"><div class="services-title-text">服务使用限制</div></div>服务相关配额及并发请求限制请访问[http://lbsyun.baidu.com/apiconsole/auth/privilege 开发者权益]页面查看。</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、我已在云存储服务中存储数据，为何无法在云检索服务中检索？</div>
 +
请检查请求URL中，geotable_id是否正确传值，是否对应云储存中存储数据的数据表ID。<br/>请检索用于存储数据的云存储服务版本号。目前云存储服务分V4和V3两个版本，两个版本数据互不相同，需要使用对应版本的云检索服务才能完成检索。
 +
</div><div class="serve-explain-text"><div class="serveintoor-title">2、为什么设置筛选条件后，召回的poi实际数量与统计字段统计的数量不匹配？</div>
 +
服务已知问题。目前云检索先召回数据表所有poi，然后根据检索条件过滤数据。<br/>数据统计发生在第一步，故会出现统计不准确badcase。我们会在后期优化这一问题。
 +
</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">
 +
2013年10月24日
 +
 +
V2.0
 +
</div><div class="timeversions">
 +
2014年11月7日
 +
 +
V2.1
 +
</div><div class="timeversions intro">
 +
2014年1月20日
 +
 +
V3.0
 +
</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">
 +
提高位置检索的实时性和稳定性
 +
 +
优化TAG过滤和文件检索的方式和性能
 +
 +
优化增加geohash空间索引和地域索引，进一步提升空间检索性能
 +
 +
优化独立存储和检索空间，从建库到检索支持开发者数据计算的无干扰运营
 +
</div></div><div class="updatebox"><div class="bluetitle"><div class="services-title-text">功能更新</div></div><div class="serve-explain-text">
 +
请求参数：新增可选参数“coord_type”
 +
 +
响应参数下，新增返回参数“coord_type”，值为2种，3代表经纬度坐标系统，4代表墨卡托系统。
 +
</div></div><div class="updatebox"><div class="bluetitle"><div class="services-title-text">产品上线</div></div><div class="serve-explain-text">LBS.云检索：支持对属性值为离散数值类型的POI的筛选。</div></div></div></div><div class="navRemark"><div class="handpointto">内容（资源下载）</div></div><div class="txtstyle2"><div class="serve-explain-text"><br/></div></div></div></div>

2019年5月30日 (四) 11:13的最后版本

服务介绍
服务文档
使用指南
常见问题
更新日志
内容（服务介绍）
云检索服务V3

云检索是一类Web API接口服务； 通过该服务，用户可对云存储中存储的自定义地理数据进行多场景的检索。 包含：周边检索，矩形检索，本地检索和详情检索。
云检索服务V3将在近期停止新用户接入，已在使用云检索V3服务的用户仍可正常访问服务。
V3版服务文档也将在近期下线，请接入服务的用户做好备份。

功能介绍
云存储数据周边检索

用户可以一点为中心（中心点通过location参数指定），搜索中心点附近指定距离范围（搜索半径通过radius参数指定）内的POI点。检索时可通过tags参数指定检索的类型；通过sortby参数进行检索结果的排序（支持多字段排序）；filter参数可以完成对指定数据范围的筛选。

geosearch1.png

云存储数据矩形区域检索

矩形检索是指可检索指定矩形范围内的poi信息，检索区域通过bounds参数设定的矩形的左下角和右上角的经纬度坐标来确定。检索时可通过tags参数指定检索类型；检索结果可通过sortby参数进行排序（支持多字段排序）；可通过filter参数筛选出指定的数据范围的结果。

geosearch2.png

云存储数据本地检索

本地检索是指可检索指定区域范围内的poi信息，区域通过region参数来设定，可以是全国范围也可以是小范围的如海淀区。检索时可通过tags参数指定检索类型；通过sortby参数对检索结果进行排序（支持多字段排序）；filter参数可以完成对指定数据范围的筛选。

geosearch3.png

云存储数据详情检索

用户可通过该功能，根据云存储数据表中的数据id，检索对应数据详情。

geosearch4.png

接口功能介绍
周边检索
http://api.map.baidu.com/geosearch/v3/nearby?ak=您的ak&geotable_id=****&location=116.395884,39.932154&radius=1000&tags=酒店&sortby=distance:1|price:1&filter=price:200,300 //GET请求
请求参数
参数名 参数含义 类型 格式 备注
ak access_key string(50) 字符串 必选
geotable_id geotable主键 uint32 数字 必选
q 检索关键字 string(45) 任意汉字或数字，英文字母，可以为空字符 可选
location 检索的中心点 string(25) 逗号分隔的经纬度 必选

样例：116.4321,38.76623

coord_type 坐标系 uint32 数字 可选

3代表百度经纬度坐标系统 4代表百度墨卡托系统

radius 检索半径 uint32 单位为米，默认为1000 可选

样例：500

tags 标签 string(45) 空格分隔的多字符串 可选

样例：美食 小吃

sortby 排序字段 string ”分隔的多个检索条件。

格式为sortby={key1:value1}|{key2:val2}|{key3:val3}。 最多支持16个字段排序 {keyname}:1 升序 {keyname}:-1 降序 以下keyname为系统预定义的： distance 距离排序 weight 权重排序

可选

默认为按weight排序 如果需要自定义排序则指定排序字段 样例：按照价格由便宜到贵排序 sortby=price:1

filter 过滤条件 string(50) 竖线分隔的多个key-value对

key为筛选字段的名称(存储服务中定义) 支持连续区间或者离散区间的筛选： a:连续区间 key:value1,value2 b:离散区间 key:[value1,value2,value3,...]

可选

样例: a:连续区间 样例：筛选价格为9.99到19.99并且生产时间为2013年的项 price:9.99,19.99|time:2012,2012 b:离散区间 筛选价格为8,9,13，并且生产时间为2013年的项 price:[8,9,13]|time:2012,2012 注：符号为英文半角中括号

page_index 分页索引 uint32 当前页标，从0开始 可选

默认为0

page_size 分页数量 uint32 当前页面最大结果数 可选

默认为10，最多为50

callback 回调函数 string(20) js回调函数 可选
sn 用户的权限签名 string(50) 可选
返回结果参数
参数名 参数含义 类型 备注
status 状态码 int32 0表示成功，其他值详见状态码说明
size 分页参数，当前页返回数量 int32
total 分页参数，所有召回数量 int32
contents uid 数据id string
geotable_id geotable_id string
title poi名称 string
address poi地址 string
province poi所属省 string(20)
city poi所属城市 string(20)
district poi所属区 string(20)
coord_type 坐标系定义 int32 可选

3代表百度经纬度坐标系统 4代表百度墨卡托系统

location 经纬度 array
tags poi的标签 string
distance 距离，单位为米 int32
weight 权重 int32
{column} 自定义列 自定义类型 自定义列/値，云存储未添加値时不返回
服务示例

geosearch-1.jpg

矩形检索
http://api.map.baidu.com/geosearch/v3/bound?ak=您的ak&geotable_id=****bounds=116.30,36.20;117.30,37.20 &sortby=price:1&tags=酒店&filer=price:200,300 //GET请求
请求参数
参数名 参数含义 类型 格式 备注
ak access_key string(50) 字符串 必选
geotable_id geotable主键 uint32 数字 必选
q 检索关键字 string(45) 任意汉字或数字，英文字母，可以为空字符 必选
bounds 矩形区域 String(25) 左下角和右上角的经纬度坐标点。2个点用;号分隔 必选

样例：116.30,36.20;117.30,37.20

tags 标签 string(45) 空格分隔的多字符串 可选

样例：美食 小吃

coord_type 坐标系 unit32 数字 可选

3代表百度经纬度坐标系统 4代表百度墨卡托系统

sortby 排序字段 string ”分隔的多个检索条件。
格式为：sortby={key1}:value1|{key2:val2|key3:val3}。
最多支持16个字段排序
{keyname}:1 升序
{keyname}:-1 降序
系统预定义的keyname：weight 权重排序 		可选
默认为按weight排序
如果需要自定义排序则指定排序字段
样例：按照价格由便宜到贵排序
sortby=price:1
filter 过滤条件 string(50) 竖线分隔的多个key-value对key为筛选字段的名称(存储服务中定义)
支持连续区间或者离散区间的筛选：
a:连续区间 key:value1,value2
b:离散区间 key:[value1,value2,value3,...] 		可选

样例: a:连续区间 样例：筛选价格为9.99到19.99并且生产时间为2013年的项 price:9.99,19.99|time:2012,2012 b:离散区间 筛选价格为8,9,13，并且生产时间为2013年的项 price:[8,9,13]|time:2012,2012 注：符号为英文半角中括号

page_index 分页索引 uint32 当前页标，从0开始 可选

默认为0

page_size 分页数量 uint32 当前页面最大结果数 可选

默认为10，最多为50

callback 回调函数 string(20) js回调函数 可选
sn 用户的权限签名 string(50) 可选
返回结果参数
参数名 参数含义 类型 备注
status 状态码 int32 0表示成功，其他值详见状态码说明
size 分页参数，当前页返回数量 int32
total 分页参数，所有召回数量 int32
contents uid 数据id string
geotable_id geotable_id string
title poi名称 string
address poi地址 string
province poi所属省 string(20)
city poi所属城市 string(20)
district poi所属区 string(20)
location 经纬度 array
coord_type 坐标系定义 int32 3代表百度经纬度坐标系统，4代表百度墨卡托系统
tags poi的标签 string
distance 距离，单位为米 int32
weight 权重 int32
{column} 自定义列 自定义类型 自定义列/値，云存储未添加値时不返回
服务示例

geosearch-3.jpg

本地检索
http://api.map.baidu.com/geosearch/v3/local?region=北京&ak=您的ak&geotable_id=****&tags=酒店&sortby=distance:1|price:1 &filter=price:200,300 //GET请求
请求参数
参数名 参数含义 类型 格式 备注
ak access_key string(50) 字符串 必选
geotable_id geotable主键 uint32 数字 必选
q 检索关键字 string(45) 任意汉字或数字，英文字母，可以为空字符 必选
coord_type 坐标系 uint32 数字 可选

3代表百度经纬度坐标系统 4代表百度墨卡托系统

region 检索区域名称 String(25) 市或区的名字，如北京市，海淀区。 可选,此接口推荐填写该参数

否则，默认按照全国范围来检索

tags 标签 string(45) 空格分隔的多字符串 可选

样例：美食 小吃

sortby 排序字段 string ”分隔的多个检索条件。

格式为sortby={key1}:value1|{key2:val2|key3:val3}。 最多支持16个字段排序 {keyname}:1 升序 {keyname}:-1 降序 以下keyname为系统预定义的： distance 距离排序 weight 权重排序

可选 默认为按weight排序 如果需要自定义排序则指定排序字段 样例：按照价格由便宜到贵排序 sortby=price:1

filter 过滤条件 string(50) 竖线分隔的多个key-value对

key为筛选字段的名称(存储服务中定义) 支持连续区间或者离散区间的筛选： a:连续区间 key:value1,value2 b:离散区间 key:[value1,value2,value3,...]

可选

样例: a:连续区间 样例：筛选价格为9.99到19.99并且生产时间为2013年的项 price:9.99,19.99|time:2012,2012 b:离散区间 筛选价格为8,9,13，并且生产时间为2013年的项 price:[8,9,13]|time:2012,2012 注：符号为英文半角中括号

page_index 分页索引 uint32 当前页标，从0开始 可选

默认为0

page_size 分页数量 uint32 当前页面最大结果数 可选

默认为10，最多为50

callback 回调函数 string(20) js回调函数 可选
sn 用户的权限签名 string(50) 可选
返回结果参数
参数名 参数含义 类型 备注
status 状态码 int32 0表示成功，其他值详见状态码说明
size 分页参数，当前页返回数量 int32
total 分页参数，所有召回数量 int32
contents uid 数据id string
geotable_id geotable_id string
title poi名称 string
address poi地址 string
province poi所属省 string(20)
city poi所属城市 string(20)
district poi所属区 string(20)
location 经纬度 array
coord_type 坐标系定义 int32 可选

3代表百度经纬度坐标系统 4代表百度墨卡托系统

tags poi的标签 string 多个tag用空格分隔
distance 距离，单位为米 int32
weight 权重 int32
{column} 自定义列 自定义类型 自定义列/値，云存储未添加値时不返回
服务示例

geosearch-2.jpg


详情检索
http://api.map.baidu.com/geosearch/v3/detail/{uid} //GET请求
请求参数
参数名 参数含义 类型 备注
ak access_key string(50) 必选
geotable_id geotable表主键 int32 必选
coord_type 坐标系 uint32 可选

3代表百度经纬度坐标系统 4代表百度墨卡托系统

sn 用户的权限签名 string(50) 可选
返回结果参数
参数名 参数含义 类型 备注
status 状态码 int32 0代表成功，其它取值含义另行说明
size 分页参数，当前页返回数量 int32
total 分页参数，所有召回数量 int32
contents uid 数据id string
geotable_id geotable_id string
title Poi地址 string
address poi名称 string
province poi所属省 string
city poi所属城市 string(20)
district poi所属区 string(20)
location 经纬度 array
coord_type 坐标系定义 int32 3代表百度经纬度坐标系统，4代表百度墨卡托系统
tags poi的标签 string
distance 距离，单位为米 int32
weight 权重 int32
{column} 自定义列 自定义类型 自定义列/値，云存储未添加値时不返回
服务示例

geosearch-4.jpg

状态码
状态码 定义 注释
0 正常
1 服务器内部错误 该服务响应超时或系统内部错误，请留下联系方式
10 上传内容超过8M Post上传数据不能超过8M
101 AK参数不存在 请求消息没有携带AK参数
102 MCODE参数不存在，mobile类型mcode参数必需 对于Mobile类型的应用请求需要携带mcode参数，该错误码代表服务器没有解析到mcode
200 APP不存在，AK有误请检查再重试 根据请求的ak，找不到对应的APP
201 APP被用户自己禁用，请在控制台解禁
202 APP被管理员删除 恶意APP被管理员删除
203 APP类型错误 当前API控制台支持Server(类型1), Mobile(类型2, 新版控制台区分为Mobile_Android(类型21)及Mobile_IPhone（类型22））及Browser（类型3），除此之外其他类型认为是APP类型错误
210 APP IP校验失败 在申请SERVER类型应用的时候选择IP校验，需要填写IP白名单，如果当前请求的IP地址不在IP白名单或者不是0.0.0.0/0就认为IP校验失败
211 APP SN校验失败 SERVER类型APP有两种校验方式IP校验和SN校验，当用户请求的SN和服务端计算出来的SN不相等的时候提示SN校验失败
220 APP Referer校验失败 浏览器类型的APP会校验referer字段是否存且切在referer白名单里面，否则返回该错误码
230 APP Mcode码校验失败 服务器能解析到mcode，但和数据库中不一致，请携带正确的mcode
240 APP 服务被禁用 用户在API控制台中创建或设置某APP的时候禁用了某项服务
250 用户不存在 根据请求的user_id, 数据库中找不到该用户的信息，请携带正确的user_id
251 用户被自己删除 该用户处于未激活状态
252 用户被管理员删除 恶意用户被加入黑名单
260 服务不存在 服务器解析不到用户请求的服务名称
261 服务被禁用 该服务已下线
301 永久配额超限，限制访问 配额超限，如果想增加配额请联系我们
302 天配额超限，限制访问 配额超限，如果想增加配额请联系我们
401 当前并发量已经超过约定并发配额，限制访问 并发控制超限，请控制并发量或联系我们
402 当前并发量已经超过约定并发配额，并且服务总并发量也已经超过设定的总并发配额，限制访问 并发控制超限，请控制并发量或联系我们
内容（使用指南）
使用方法
1申请百度账号
百度地图开放平台所有服务申请均需在登录百度账号前提下进行。使用服务前请先申请注册百度账号。 点此申请
2申请成为百度开发者
登录百度账号后，请申请百度地图开放平台开发者，即可开始使用相关服务。 点此申请
3获取服务密钥（ak）
发送服务请求，需使用ak参数进行鉴权（必选）。发送服务请求前需先创建ak。 点此创建
4使用云存储服务，创建位置数据表
使用云地理编码解析自定义地理数据，首先需使用云存储服务，创建位置数据表，编辑自定义地址数据。创建数据表成功，获取位置数据表id（geotable_id）
5拼写请求URL，使用服务获取结果
拼写请求URL，使用geotable_id，解析位置数据表中的自定义地址数据。
编码说明

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）

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

服务使用限制
服务相关配额及并发请求限制请访问开发者权益页面查看。
内容（常见问题）
服务常见问题
1、我已在云存储服务中存储数据，为何无法在云检索服务中检索？

请检查请求URL中，geotable_id是否正确传值，是否对应云储存中存储数据的数据表ID。
请检索用于存储数据的云存储服务版本号。目前云存储服务分V4和V3两个版本，两个版本数据互不相同，需要使用对应版本的云检索服务才能完成检索。

2、为什么设置筛选条件后，召回的poi实际数量与统计字段统计的数量不匹配？

服务已知问题。目前云检索先召回数据表所有poi，然后根据检索条件过滤数据。
数据统计发生在第一步，故会出现统计不准确badcase。我们会在后期优化这一问题。

内容（更新日志）

2013年10月24日

V2.0

2014年11月7日

V2.1

2014年1月20日

V3.0


功能更新

提高位置检索的实时性和稳定性

优化TAG过滤和文件检索的方式和性能

优化增加geohash空间索引和地域索引，进一步提升空间检索性能

优化独立存储和检索空间，从建库到检索支持开发者数据计算的无干扰运营

功能更新

请求参数：新增可选参数“coord_type”

响应参数下，新增返回参数“coord_type”，值为2种，3代表经纬度坐标系统，4代表墨卡托系统。

产品上线
LBS.云检索：支持对属性值为离散数值类型的POI的筛选。
内容（资源下载）

取自“http://lbsyun.baidu.com/index.php?title=lbscloud/api/geosearch&oldid=13010”

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

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

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消