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

文档全面上新

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

体验新版
第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">云地理编码服务</div></div><div class="serve-explain-text">
−
 
+
云地理编码是一类Web API接口服务；<br/>结合[http://lbsyun.baidu.com/index.php?title=webapi/guide/webservice-geocoding 地理编码服务]和LBS.[http://lbsyun.baidu.com/index.php?title=lbscloud/api/geodata 云存储]服务，将用户存储的自定义地址数据解析成对应坐标，同时解析地址构成（省、市、区、街道）。<br/>用户可不依赖百度地图地址库，实现将自定义地址解析为指定坐标的功能。
−
地理编码（Geocoding V3.0）又称云地理编码（cloudgc），即在原有地理编码服务基础上，增加了个性化Geocoding服务。用户可在云端新增、修改自定义地址信息（需在请求中添加geotable_id参数，关联用户自定义的位置数据表，详见：http://lbsyun.baidu.com/index.php?title=lbscloud/api/geodata ），关联真实的业务场景位置，同时训练出更准确的位置坐标信息。
+
</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>
−
 
+
输入结构化地址：「北京市海淀区科技园1号楼二单元」<br/>通过百度自有地址数据解析结果为：“lat:41.055743,lng:116.308243”<br/>用户根据真实场景，在云端将坐标训练为：“lat:41.056743,lng:116.308243”
−
云地理编码已全面支持HTTP/HTTPS两种请求形式。后文介绍中以HTTP请求为例。
+
</div><div class="serveintorright">
−
 
+
http://mapopen-pub-webserviceapi.bj.bcebos.com/images/geoGC1.png
−
== 使用方法 ==
+
</div></div><div class="serveintortxt"><div class="serveintorleft"><div class="serveintoor-title">提供个性化地址解析</div>
−
 
+
输入结构化地址：「北京市海淀区科技园1号楼二单元」<br/>地址数据解析结果为：“lat:41.055743,lng:116.308243”<br/>用户为方便对地址管理，在云端将该坐标地址信息修改为“西二旗服务中心”<br/>之后，用户可请求“西二旗服务中心”地址，获取对应坐标。
−
第一步：[http://lbsyun.baidu.com/apiconsole/key/create 申请ak]（即获取密钥），若无百度账号则首先需要注册百度账号。
+
</div><div class="serveintorright">
−
 
+
http://mapopen-pub-webserviceapi.bj.bcebos.com/images/geoGC2.png
−
第二步：在位置数据表中新建、修改位置数据。（详见：http://lbsyun.baidu.com/index.php?title=lbscloud/api/geodata ）
+
</div></div><div class="serveintortxt"><div class="serveintorleft"><div class="serveintoor-title">解析结构化的地址构成</div>
−
 
+
用户输入结构化地址：「北京市海淀区软件园南街科技园1号楼2单元。」<br/>通过云地理编码服务，解析出地址构成：<br/>省：北京市；<br/>市：北京市；<br/>区：海淀区；<br/>街：软件园南街；
−
第三步：拼写发送HTTP/HTTPS请求的url，注意需使用第一步申请的ak&第二步中的geotable_id（未添加geotable_id，则调用普通地理编码服务）。
+
</div><div class="serveintorright">
−
 
+
http://mapopen-pub-webserviceapi.bj.bcebos.com/images/geoGC3.png
−
第四步：接收HTTP/HTTPS请求返回的数据（支持json格式）。
+
</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/cloudgc/v1?geotable_id=******&address=北京市海淀区营业网点&city=北京&ak=你的ak //GET请求</pre>
−
 
+
</div></div><div class="separate-title">请求参数</div>
−
== 服务内容 ==
+
−
 
+
−
'''服务地址：
+
−
 
+
−
<div style="margin:0 0 0 20px;width:740px;height:36px;background:#F2F2F2;font-family: '微软雅黑 Regular', '微软雅黑';font-size: 14px;color: #006600;line-height: 22px;padding:2px 0;">
+
−
<nowiki>
+
−
http://api.map.baidu.com/cloudgc/v1
+
−
</nowiki>
+
−
</div>
+
−
 
+
−
'''组成说明：
+
−
 
+
−
<div style="width:710px;height:36px;color: #006600;padding: 0 15px;background: #F2F2F2;margin: 0 0 0 20px;line-height: 36px;font-family: '微软雅黑 Regular', '微软雅黑';">域名：api.map.baidu.com &nbsp;&nbsp;&nbsp;&nbsp; 服务名：cloudgc  &nbsp;&nbsp;&nbsp;&nbsp;  服务版本号：v1</div>
+
−
 
+
−
== 请求参数 ==
+
−
 
+
 
{|
 
{|
−
!width="100" |  参数
 
−
!width="150" |  是否必须
 
−
!width="100" |  默认值
 
−
!width="100" |  格式举例
 
−
!width="200" |  含义
 
 
|-
 
|-
−
|address
+
! width="80" | 参数名
−
|是
+
! width="80" style="width: 337px;" | 参数含义
−
|无
+
! width="80" style="width: 51px;" | 类型
−
|北京市海淀区上地十街10号
+
! width="180" style="width: 207px;" | 举例
−
|地址
+
! width="180" style="width: 125px;" | 默认值
 +
! width="180" style="width: 71px;" | 是否必须<br/>
 
|-
 
|-
−
|city
+
| address
−
|否
+
| style="width: 319px;" | 待解析的地址。最多支持84个字节。<br/>
−
|无
+
| style="width: 33px;" | string
−
|北京市
+
| style="width: 189px;" | 北京市海淀区上地十街10号
−
|目标城市偏向
+
| style="width: 107px;" | 无
 +
| style="width: 53px;" | '''是'''
 
|-
 
|-
−
|geotable_id
+
| city
−
|否
+
| style="width: 319px;" | 地址所在的城市名。用于指定上述地址所在的城市，当多个城市都有上述地址时，该参数起到过滤作用，但不限制坐标召回城市。
−
|无
+
| style="width: 33px;" | string
−
|144316
+
| style="width: 189px;" | 北京市
−
|geotable id，与ak配合鉴权，若填写则激活个性化GC服务（可新增、修改自定义地址信息），自定义数据的管理与维护详见：http://lbsyun.baidu.com/index.php?title=lbscloud/api/geodata
+
| style="width: 107px;" | 无<br/>
 +
| style="width: 53px;" | 否<br/>
 
|-
 
|-
−
|ak
+
| geotable_id
−
|是
+
| style="width: 319px;" | 用户使用[http://lbsyun.baidu.com/index.php?title=lbscloud/api/geodata 云存储]服务，存储自定义数据时生成的数据表ID。与ak配合鉴权。<br/>若填写则激活个性化GC服务（对指定geotable_id<br/>数据表中地址进行解析）<br/>[http://lbsyun.baidu.com/index.php?title=lbscloud/api/geodata 自定义数据的管理与维护介绍]
−
|无
+
| style="width: 33px;" | int
−
|cO3seSdq***XGxpXD8VObPGvXNcwcW04
+
| style="width: 189px;" | 144316
−
|用户申请注册的key
+
| style="width: 107px;" | 无
 +
| style="width: 53px;" | 否
 
|-
 
|-
−
|sn
+
| ak
−
|否
+
| style="width: 319px;" | 用户申请注册的key（服务鉴权秘钥）&nbsp;[http://lbsyun.baidu.com/apiconsole/key/create 申请ak]
−
|无
+
| style="width: 33px;" | string
−
|
+
| style="width: 189px;" | E4805d16520de693a3fe70
−
|若用户所用ak的校验方式为sn校验时该参数必须。
+
| style="width: 107px;" | 无
 +
| style="width: 53px;" | '''是'''<br/>
 
|-
 
|-
−
|callback
+
| 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/>
−
|将json格式的返回值通过callback函数返回以实现jsonp功能
+
| style="width: 107px;" | 无
 +
| style="width: 53px;" | 否<br/>
 +
|-
 +
| output
 +
| style="width: 319px;" | 输出格式为json或者xml
 +
| style="width: 33px;" | string
 +
| style="width: 189px;" | json或xml
 +
| style="width: 107px;" | xml
 +
| style="width: 53px;" | 否<br/>
 +
|-
 +
| callback
 +
| style="width: 319px;" | 将json格式的返回值通过callback函数返回以实现jsonp功能
 +
| style="width: 33px;" | string
 +
| style="width: 189px;" | callback=showLocation(JavaScript函数名)
 +
| style="width: 107px;" | 无
 +
| style="width: 53px;" | 否<br/>
 
|}
 
|}
−
 
+
<div class="separate-title">返回结果参数</div>
−
 
+
−
对于address字段可能会出现中文或其它一些特殊字符（如：空格），对于类似的字符要进行编码处理，编码成 UTF-8 字符的二字符十六进制值，凡是不在下表中的字符都要进行编码。
+
−
 
+
−
 
+
 
{|
 
{|
−
!width="100" |  字符集合
 
−
!width="700" |  字符
 
 
|-
 
|-
−
|URL非保留字
+
! width="100" rowspan="1" colspan="2" style="width: 141px;" | 名称<br/>
−
|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 - _ . ~
+
! width="100" style="width: 698px;" | 含义
 +
! width="500" style="width: 106px;" | 类型
 
|-
 
|-
−
|URL保留字
+
| rowspan="1" colspan="2" style="width: 123px;" | status<br/>
−
|! * ' ( ) ; : @ & = + $ , / ? % # [ ]
+
| style="width: 680px;" | 返回结果状态值， 成功返回0
 +
| style="width: 88px;" | int
 +
|-
 +
| colspan="2" style="width: 123px;" | source<br/>
 +
| style="width: 680px;" | 解析结果的来源，百度（baidu）、用户自定义（custom）<br/>
 +
| style="width: 88px;" | string
 +
|-
 +
| rowspan="1" colspan="2" style="width: 123px;" | location<br/>
 +
| style="width: 680px;" | lat（纬度）&lng（经度）
 +
| style="width: 88px;" | float
 +
|-
 +
| colspan="2" style="width: 123px;" | bound<br/>
 +
| style="width: 680px;" | 百位置坐标误差范围[左下角纬度经度];[右上角纬度度]，如："29.595089,105.048917;29.595874,105.049815"<br/>
 +
| style="width: 88px;" | float
 +
|-
 +
| colspan="2" style="width: 123px;" | formatted_address<br/>
 +
| style="width: 680px;" | 百度地址结构化字符，格式：省市区街道门牌<br/>
 +
| style="width: 88px;" | string
 +
|-
 +
| colspan="2" style="width: 123px;" | custom_address<br/>
 +
| style="width: 680px;" | 用户自定义的地址<br/>
 +
| style="width: 88px;" | string<br/>
 +
|-
 +
| style="width: 48px;" | address_components<br/>
 +
| style="width: 54px;" | province<br/>
 +
| style="width: 680px;" | 省<br/>
 +
| style="width: 88px;" | string<br/>
 +
|-
 +
| style="width: 48px;" | <br/>
 +
| style="width: 54px;" | city
 +
| style="width: 680px;" | 城市
 +
| style="width: 88px;" | string
 +
|-
 +
| style="width: 48px;" | <br/>
 +
| style="width: 54px;" | district
 +
| style="width: 680px;" | 区县
 +
| style="width: 88px;" | string
 +
|-
 +
| 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;" | level<br/>
 +
| style="width: 680px;" | 解析结果的地址级别，省、城市、区县，如果解析到POI或门牌号，则level为POI类型、道路等<br/>
 +
| style="width: 88px;" | string<br/>
 +
|-
 +
| rowspan="1" colspan="2" style="width: 123px;" | precise<br/>
 +
| style="width: 680px;" | 1.x表示精确坐标，0.x表示模糊坐标，x表示匹配区域的精度范围大小，用户自定义地址默认为2<br/>大于5表示误差小于1000m，x大于8表示误差小于100m
 +
| style="width: 88px;" | float
 
|}
 
|}
 +
<div class="separate-title">服务示例</div>
 +
以下为解析百度数据（基础地理编码服务）的返回值<br/>http://wiki.lbsyun.baidu.com/cms/lbscloud/baidu.PNG<br/><br/>以下为使用云地理编码解析用户在云存储中创建的自定义地址，得到的返回值。<br/>（用户在云存储中创建了一个地址同样为北京市海淀区上地十街10号的地点，赋予了一个自定义坐标。服务中关联geotable_id后，解析的地址坐标为用户自定义。）<br/>http://wiki.lbsyun.baidu.com/cms/lbscloud/custom.PNG
 +
</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/>附注：
  
−
1、javascript中一般采用encodeURIComponent函数对特殊字符进行编码；
+
{{bluepoint}}javascript中一般采用encodeURIComponent函数对特殊字符进行编码。
  
−
2、Java中可以使用函数URLEncoder.encode对特殊字符进行编码；
+
{{bluepoint}}Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
  
−
3、C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码；
+
{{bluepoint}}C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
  
−
4、php中可以使用函数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>
 +
{{bluepoint}}每个开发者账号每天调用“云地理编码服务”API 服务的总次数（即配额）是有限的。
  
 +
{{bluepoint}}每个开发者账号每天调用“云地理编码服务”API 服务的总次数（即并发量）是有限的。
  
−
'''请求示例
+
{{bluepoint}}若需要更高配额和并发量，请申请开发者认证以获取更高配额和更及时的技术支持。
  
−
<div style="margin:0 0 0 20px;width:740px;height:50px;background:#F2F2F2;font-family: '微软雅黑 Regular', '微软雅黑';font-size: 14px;color: #006600;line-height: 20px;padding:2px 0;">
+
{{bluepoint}}同一个账号下的HTTP/HTTPS请求，配额，并发共享。
−
<nowiki>
+
−
http://api.map.baidu.com/cloudgc/v1?ak=hQqM******rLhbc74OVGlqZ8&geotable_id=******&address=北京市海淀区上地十街10号&city=北京
+
−
</nowiki>
+
−
</div>
+
  
−
'''请求含义
 
  
−
<div style="margin:0 0 0 20px;width:740px;height:50px;background:#F2F2F2;font-family: '微软雅黑 Regular', '微软雅黑';font-size: 14px;color: #006600;line-height: 20px;padding:2px 0;">
 
−
发出一个结构化地址为”北京市海淀区上地十街10号“的请求，目标城市偏向为北京。解析该地址对应的地理坐标&地址构成。
 
−
</div>
 
  
−
== 返回结果字段 ==
+
'''配额及默认并发量说明如下'''
−
 
+
<div class="tablecenter">
−
'''状态字段'''
+
 
{|
 
{|
−
!width="170" |  字段
 
−
!width="100" |  字段
 
−
!width="700" |  含义
 
 
|-
 
|-
−
|source
+
! width="220" | 分类
−
|
+
! width="270" | 未认证
−
|解析结果的来源，百度（baidu）、用户自定义（custom）
+
! width="220" | 个人认证
 +
! width="270" | 企业认证
 
|-
 
|-
−
|location
+
| 日配额（次）
−
|
+
| 2,000
−
|Lat（纬度）&lng（经度）
+
| 2,000
 +
| 100,000
 
|-
 
|-
−
|bound
+
| 分钟并发数（次/分钟）
−
|
+
| 1,200
−
|百位置坐标误差范围[左下角纬度经度];[右上角纬度度]，如："29.595089,105.048917;29.595874,105.049815"
+
| 1,200
−
|-
+
| 6,000
−
|formatted_address
+
−
|
+
−
|百度地址结构化字符，格式：省市区道路
+
−
|-
+
−
|custom_address
+
−
|
+
−
|用户自定义的地址
+
−
|-
+
−
|address_components
+
−
|province
+
−
|省
+
−
|-
+
−
|
+
−
|city
+
−
|城市
+
−
|-
+
−
|
+
−
|district
+
−
|区县
+
−
|-
+
−
|
+
−
|street
+
−
|道路
+
−
|-
+
−
|
+
−
|level
+
−
|解析结果的地址级别，省、城市、区县，如果解析到POI或门牌号，则level为POI类型、道路等
+
−
|-
+
−
|precise
+
−
|
+
−
|1.x表示精确坐标，0.x表示模糊坐标，x表示匹配区域的精度范围大小，用户自定义地址默认为2<br>大于5表示误差小于1000m，x大于8表示误差小于100m
+
 
|}
 
|}
 +
</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、使用云地理编码服务可以不加“geotable_id”参数吗？</div>
 +
可以。如果不添加“geotable_id”,则使用百度地图门址库，对请求中的地址进行解析。<br/>解析结果坐标和普通地理编码服务相同。
 +
</div><div class="serve-explain-text"><div class="serveintoor-title">2、云地理编码只能解析自定义的地址数据吗？</div>
 +
地址数据指云存储中数据表address字段，具体内容可自定义，不严格要求。<br/>如果在云存储中，地点address参数存储数据“西二旗服务点”，且赋值坐标点，使用云地理编码服务，即可解析“西二旗服务点”，获得对应地点坐标。
 +
</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年8月10日
  
−
注：返回结果中，数据源为baidu，则最多返回3条；数据源为custom，返回数量不限。
+
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>
−
http://wiki.lbsyun.baidu.com/cms/lbscloud/baidu.PNG
+
−
 
+
−
数据源为custom（个性化Geocoding服务）
+
−
 
+
−
http://wiki.lbsyun.baidu.com/cms/lbscloud/custom.PNG
+

2017年10月26日 (四) 05:48的版本

服务介绍
服务文档
使用指南
常见问题
更新日志
内容（服务介绍）
云地理编码服务

云地理编码是一类Web API接口服务；
结合地理编码服务和LBS.云存储服务，将用户存储的自定义地址数据解析成对应坐标，同时解析地址构成（省、市、区、街道）。
用户可不依赖百度地图地址库，实现将自定义地址解析为指定坐标的功能。

功能介绍
训练更准确的位置坐标

输入结构化地址：「北京市海淀区科技园1号楼二单元」
通过百度自有地址数据解析结果为：“lat:41.055743,lng:116.308243”
用户根据真实场景，在云端将坐标训练为：“lat:41.056743,lng:116.308243”

geoGC1.png

提供个性化地址解析

输入结构化地址：「北京市海淀区科技园1号楼二单元」
地址数据解析结果为：“lat:41.055743,lng:116.308243”
用户为方便对地址管理，在云端将该坐标地址信息修改为“西二旗服务中心”
之后，用户可请求“西二旗服务中心”地址，获取对应坐标。

geoGC2.png

解析结构化的地址构成

用户输入结构化地址：「北京市海淀区软件园南街科技园1号楼2单元。」
通过云地理编码服务，解析出地址构成：
省：北京市；
市：北京市；
区：海淀区；
街：软件园南街；

geoGC3.png

接口功能介绍
http://api.map.baidu.com/cloudgc/v1?geotable_id=******&address=北京市海淀区营业网点&city=北京&ak=你的ak //GET请求
请求参数
参数名 参数含义 类型 举例 默认值 是否必须
address 待解析的地址。最多支持84个字节。
 string 北京市海淀区上地十街10号 无 是
city 地址所在的城市名。用于指定上述地址所在的城市，当多个城市都有上述地址时，该参数起到过滤作用，但不限制坐标召回城市。 string 北京市 无
 否
geotable_id 用户使用云存储服务，存储自定义数据时生成的数据表ID。与ak配合鉴权。
若填写则激活个性化GC服务（对指定geotable_id
数据表中地址进行解析）
自定义数据的管理与维护介绍 		int 144316 无 否
ak 用户申请注册的key（服务鉴权秘钥） 申请ak string E4805d16520de693a3fe70 无 是
sn 若用户所用ak的校验方式为sn校验时该参数必须 
sn生成 		string
无 否
output 输出格式为json或者xml string json或xml xml 否
callback 将json格式的返回值通过callback函数返回以实现jsonp功能 string callback=showLocation(JavaScript函数名) 无 否
返回结果参数
名称
 含义 类型
status
 返回结果状态值， 成功返回0 int
source
 解析结果的来源，百度（baidu）、用户自定义（custom）
 string
location
 lat（纬度）&lng（经度） float
bound
 百位置坐标误差范围[左下角纬度经度];[右上角纬度度]，如："29.595089,105.048917;29.595874,105.049815"
 float
formatted_address
 百度地址结构化字符，格式：省市区街道门牌
 string
custom_address
 用户自定义的地址
 string
address_components
 province
 省
 string

 city 城市 string

district 区县 string

street
 道路
 string

 level
 解析结果的地址级别，省、城市、区县，如果解析到POI或门牌号，则level为POI类型、道路等
 string
precise
 1.x表示精确坐标，0.x表示模糊坐标，x表示匹配区域的精度范围大小，用户自定义地址默认为2
大于5表示误差小于1000m，x大于8表示误差小于100m 		float
服务示例

以下为解析百度数据（基础地理编码服务）的返回值
baidu.PNG

以下为使用云地理编码解析用户在云存储中创建的自定义地址，得到的返回值。
（用户在云存储中创建了一个地址同样为北京市海淀区上地十街10号的地点，赋予了一个自定义坐标。服务中关联geotable_id后，解析的地址坐标为用户自定义。）
custom.PNG

内容（使用指南）
使用方法
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）

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

服务配额

每个开发者账号每天调用“云地理编码服务”API 服务的总次数（即配额）是有限的。

每个开发者账号每天调用“云地理编码服务”API 服务的总次数（即并发量）是有限的。

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

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


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

分类 未认证 个人认证 企业认证
日配额（次） 2,000 2,000 100,000
分钟并发数（次/分钟） 1,200 1,200 6,000
内容（常见问题）
服务常见问题
1、使用云地理编码服务可以不加“geotable_id”参数吗？

可以。如果不添加“geotable_id”,则使用百度地图门址库，对请求中的地址进行解析。
解析结果坐标和普通地理编码服务相同。

2、云地理编码只能解析自定义的地址数据吗？

地址数据指云存储中数据表address字段，具体内容可自定义，不严格要求。
如果在云存储中，地点address参数存储数据“西二旗服务点”，且赋值坐标点，使用云地理编码服务，即可解析“西二旗服务点”，获得对应地点坐标。

内容（更新日志）

2016年8月10日

V1.0


产品上线
全新云地理编码服务V1.0发布。
取自“http://lbsyun.baidu.com/index.php?title=lbscloud/cloudgc/explain&oldid=9001”

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

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

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消