浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

文档全面上新

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

体验新版
(清空页面)
 
第1行: 第1行:
{{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">云逆地理编码服务</div></div><div class="serve-explain-text">
 
云逆地理编码是一类Web API接口服务;<br/>结合[http://lbsyun.baidu.com/index.php?title=webapi/guide/webservice-geocoding 逆][http://lbsyun.baidu.com/index.php?title=webapi/guide/webservice-geocoding 地理编码服务]和LBS.[http://lbsyun.baidu.com/index.php?title=lbscloud/api/geodata 云存储]服务,通过使用自定义的POI数据,对坐标进行个性化位置描述。<br/><span style="color:#FF0000;">云逆地理编码服务将在近期停止新用户接入,已在使用云逆地理编码服务的用户仍可正常访问服务。<br/>服务文档也将在近期下线,请接入服务的用户做好备份。</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>
 
普通逆地理编码服务中,解析坐标所在行政区划,同时召回周边权重较高的POI数据用于位置描述。<br/>云逆地理编码服务中,用户可使用在云存储中管理的自定义地点数据,对坐标进行个性化的位置描述。
 
</div><div class="serveintorright">
 
http://mapopen-pub-webserviceapi.bj.bcebos.com/images/geoRGC1.png
 
</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="code-template"><pre class="get-url-pre">http://api.map.baidu.com/cloudrgc/v1?location=40.055,116.308&geotable_id=135675&coord_type=bd09ll&ak=你的ak //GET请求</pre>
 
</div></div><div class="separate-title">请求参数</div>
 
{|
 
|-
 
! width="80" | 参数名
 
! width="80" style="width: 337px;" | 参数含义
 
! width="80" style="width: 51px;" | 类型
 
! width="180" style="width: 207px;" | 举例
 
! width="180" style="width: 125px;" | 默认值
 
! width="180" style="width: 71px;" | 是否必须<br/>
 
|-
 
| location
 
| style="width: 319px;" | 待解析的坐标,格式:纬度,经度。<br/>
 
| style="width: 33px;" | float
 
| style="width: 189px;" | 40.047,116.313
 
| style="width: 107px;" | 无
 
| style="width: 53px;" | '''是'''
 
|-
 
| geotable_id
 
| style="width: 319px;" | 用户使用[http://lbsyun.baidu.com/index.php?title=lbscloud/api/geodata 云存储]服务,存储自定义数据时生成的数据表ID。与ak配合鉴权。<br/>使用个性化逆地理编码服务必须(使用指定geotable_id数据表中地理数据对坐标进行位置描述)<br/>[http://lbsyun.baidu.com/index.php?title=lbscloud/api/geodata 自定义数据的管理与维护介绍]
 
| style="width: 33px;" | int
 
| style="width: 189px;" | 144316
 
| style="width: 107px;" | 无
 
| style="width: 53px;" | '''是'''
 
|-
 
| extensions<br/>
 
| style="width: 319px;" | 扩展信息控制。<br/>是否返回扩展信息:默认不返回,extensions=pois时返回pois和custom_pois<br/>
 
| style="width: 33px;" | string
 
| style="width: 189px;" | pois<br/>
 
| style="width: 107px;" | 无
 
| style="width: 53px;" | 否
 
|-
 
| coord_type<br/>
 
| style="width: 319px;" | 输入坐标的坐标系:<br/>bd09ll(百度经纬度坐标)、gcj02ll(国测局经纬度坐标)、wgs84ll(wgs84经纬度坐标)<br/>
 
| style="width: 33px;" | string
 
| style="width: 189px;" | gcj02ll<br/>
 
| style="width: 107px;" | bd09ll<br/>
 
| style="width: 53px;" | 否<br/>
 
|-
 
| ak
 
| style="width: 319px;" | 用户申请注册的key(服务鉴权秘钥)&nbsp;[http://lbsyun.baidu.com/apiconsole/key/create 申请ak]
 
| style="width: 33px;" | string
 
| style="width: 189px;" | E4805d16520de693a3fe70
 
| style="width: 107px;" | 无
 
| style="width: 53px;" | '''是'''<br/>
 
|-
 
| sn
 
| style="width: 319px;" | '''若用户所用ak的校验方式为sn校验时该参数必须'''&nbsp;<br/>[http://lbsyun.baidu.com/index.php?title=lbscloud/api/appendix sn生成]
 
| style="width: 33px;" | string
 
| style="width: 189px;" | <br/>
 
| style="width: 107px;" | 无
 
| style="width: 53px;" | 否<br/>
 
|-
 
| timestamp
 
| style="width: 319px;" | 鉴权时间戳,配合ak鉴权
 
| style="width: 33px;" | string
 
| style="width: 189px;" | <br/>
 
| style="width: 107px;" | 无
 
| style="width: 53px;" | 否<br/>
 
|}
 
<div class="separate-title">返回结果参数</div>
 
{|
 
|-
 
! width="100" rowspan="1" colspan="2" style="width: 141px;" | 名称<br/>
 
! width="100" style="width: 698px;" | 含义
 
! width="500" style="width: 106px;" | 类型
 
|-
 
| rowspan="1" colspan="2" style="width: 123px;" | status<br/>
 
| style="width: 680px;" | 返回结果状态值, 成功返回0
 
| style="width: 88px;" | int
 
|-
 
| style="width: 48px;" | location
 
| style="width: 54px;" | lat<br/>
 
| style="width: 680px;" | 纬度<br/>
 
| style="width: 88px;" | float
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | lng<br/>
 
| style="width: 680px;" | 经度<br/>
 
| style="width: 88px;" | float<br/>
 
|-
 
| style="width: 48px;" | address_component<br/>
 
| style="width: 54px;" | country<br/>
 
| style="width: 680px;" | 国家<br/>
 
| style="width: 88px;" | string<br/>
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | province<br/>
 
| style="width: 680px;" | 省<br/>
 
| style="width: 88px;" | string<br/>
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | city<br/>
 
| style="width: 680px;" | 城市<br/>
 
| style="width: 88px;" | string<br/>
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | district<br/>
 
| style="width: 680px;" | 区、县<br/>
 
| style="width: 88px;" | string<br/>
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | street<br/>
 
| style="width: 680px;" | 街道<br/>
 
| style="width: 88px;" | string<br/>
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | street_number<br/>
 
| style="width: 680px;" | 街道门牌号<br/>
 
| style="width: 88px;" | string<br/>
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | admin_area_code<br/>
 
| style="width: 680px;" | 行政区划代码<br/>
 
| style="width: 88px;" | int
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | country_code<br/>
 
| style="width: 680px;" | 国家代码<br/>
 
| style="width: 88px;" | int
 
|-
 
| style="width: 48px;" rowspan="1" colspan="2" | formatted_address<br/>
 
| style="width: 680px;" | 地址结构化描述<br/>
 
| style="width: 88px;" | string<br/>
 
|-
 
| style="width: 48px;" | pois<br/>
 
| style="width: 54px;" | name<br/>
 
| style="width: 680px;" | 名称<br/>
 
| style="width: 88px;" | string<br/>
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | id<br/>
 
| style="width: 680px;" | 百度地图POI ID<br/>
 
| style="width: 88px;" | string<br/>
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | address<br/>
 
| style="width: 680px;" | 地址
 
| style="width: 88px;" | string
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | tag
 
| style="width: 680px;" | 分类标签
 
| style="width: 88px;" | string
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | location<br/>
 
| style="width: 680px;" | 坐标<br/>
 
| style="width: 88px;" | float<br/>
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | direction<br/>
 
| style="width: 680px;" | 请求点相对于返回点的方向<br/>
 
| style="width: 88px;" | string<br/>
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | distance<br/>
 
| style="width: 680px;" | 与位置点的距离<br/>
 
| style="width: 88px;" | int
 
|-
 
| style="width: 48px;" | custom_pois<br/>
 
| style="width: 54px;" | name<br/>
 
| style="width: 680px;" | 名称<br/>
 
| style="width: 88px;" | string<br/>
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | address<br/>
 
| style="width: 680px;" | 地址<br/>
 
| style="width: 88px;" | string<br/>
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | tag<br/>
 
| style="width: 680px;" | 分类标签<br/>
 
| style="width: 88px;" | string<br/>
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | location<br/>
 
| style="width: 680px;" | 坐标<br/>
 
| style="width: 88px;" | float<br/>
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | direction<br/>
 
| style="width: 680px;" | 请求点相对于返回点的方向<br/>
 
| style="width: 88px;" | string<br/>
 
|-
 
| style="width: 48px;" | <br/>
 
| style="width: 54px;" | distance<br/>
 
| style="width: 680px;" | 与位置点的距离<br/>
 
| style="width: 88px;" | int<br/>
 
|-
 
| colspan="2" style="width: 123px;" | custom_location_description<br/>
 
| style="width: 680px;" | 用户定义位置描述<br/>
 
| style="width: 88px;" | string<br/>
 
|-
 
| rowspan="1" colspan="2" style="width: 123px;" | recommended_location_description<br/>
 
| style="width: 680px;" | 推荐的位置描述(结合custom_pois和pois计算推荐结果)
 
| style="width: 88px;" | float
 
|}
 
</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>获取服务[http://lbsyun.baidu.com/apiconsole/key/create 密钥](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}}云逆地理编码服务V3版默认输入输出坐标类型为百度坐标(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>{{bluepoint}}服务相关配额及并发请求限制请访问[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>
 
目前仅支持判断坐标点是否在百度母库某面状位置数据中(同普通逆地理编码服务)。暂时不支持自定义面状数据点面判断。我们有计划在17年末单独推出基于云存储V4服务的点面判断服务,请留意平台动态。
 
</div><div class="serve-explain-text"><div class="serveintoor-title">2、云逆地理编码支持自定义行政区划数据描述吗?</div>
 
不支持。目前仅支持与自定义位置数据关联,实现坐标周边自定义POI位置描述场景需求。
 
</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 intro">
 
2016年3月20日
 
 
V1.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">全新云逆地理编码服务V1.0发布。</div></div></div></div></div></div>
 

2022年11月14日 (一) 16:37的最后版本

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

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

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消