|
|
| 第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 地理编码服务]和LBS.[http://lbsyun.baidu.com/index.php?title=lbscloud/api/geodata 云存储]服务，将用户存储的自定义地址数据解析成对应坐标，同时解析地址构成（省、市、区、街道）。<br/>用户可不依赖百度地图地址库，实现将自定义地址解析为指定坐标的功能。<br/><span style="color:#FF0000;">云地理编码服务将在近期停止新用户接入，已在使用云地理编码服务的用户仍可正常访问服务。<br/>服务文档也将在近期下线，请接入服务的用户做好备份。<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>
| |
| − | 输入结构化地址：「北京市海淀区科技园1号楼二单元」<br/>通过百度自有地址数据解析结果为：“lat:41.055743,lng:116.308243”<br/>用户根据真实场景，在云端将坐标训练为：“lat:41.056743,lng:116.308243”
| |
| − | </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/>之后，用户可请求“西二旗服务中心”地址，获取对应坐标。
| |
| − | </div><div class="serveintorright">
| |
| − | http://mapopen-pub-webserviceapi.bj.bcebos.com/images/geoGC2.png
| |
| − | </div></div><div class="serveintortxt"><div class="serveintorleft"><div class="serveintoor-title">解析结构化的地址构成</div>
| |
| − | 用户输入结构化地址：「北京市海淀区软件园南街科技园1号楼2单元。」<br/>通过云地理编码服务，解析出地址构成：<br/>省：北京市；<br/>市：北京市；<br/>区：海淀区；<br/>街：软件园南街；
| |
| − | </div><div class="serveintorright">
| |
| − | http://mapopen-pub-webserviceapi.bj.bcebos.com/images/geoGC3.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/cloudgc/v1?geotable_id=******&address=北京市海淀区营业网点&city=北京&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/>
| |
| − | |-
| |
| − | | address
| |
| − | | style="width: 319px;" | 待解析的地址。最多支持84个字节。<br/>
| |
| − | | style="width: 33px;" | string
| |
| − | | style="width: 189px;" | 北京市海淀区上地十街10号
| |
| − | | style="width: 107px;" | 无
| |
| − | | style="width: 53px;" | '''是'''
| |
| − | |-
| |
| − | | city
| |
| − | | style="width: 319px;" | 地址所在的城市名。用于指定上述地址所在的城市，当多个城市都有上述地址时，该参数起到过滤作用，但不限制坐标召回城市。
| |
| − | | style="width: 33px;" | string
| |
| − | | style="width: 189px;" | 北京市
| |
| − | | style="width: 107px;" | 无<br/>
| |
| − | | style="width: 53px;" | 否<br/>
| |
| − | |-
| |
| − | | 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
| |
| − | | style="width: 189px;" | 144316
| |
| − | | style="width: 107px;" | 无
| |
| − | | style="width: 53px;" | 否
| |
| − | |-
| |
| − | | ak
| |
| − | | style="width: 319px;" | 用户申请注册的key（服务鉴权秘钥） [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校验时该参数必须''' <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/>
| |
| − | |-
| |
| − | | 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>
| |
| − | {|
| |
| − | |-
| |
| − | ! 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
| |
| − | |-
| |
| − | | 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;" | ! * ' ( ) ; : @ & = + $ , / ? % # [ ]<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>
| |
| − | 服务相关配额及并发请求限制请访问[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、使用云地理编码服务可以不加“geotable_id”参数吗？</div>可以。如果不添加“geotable_id”,则使用百度地图门址库，对请求中的地址进行解析。<br/>解析结果坐标和普通地理编码服务相同。</div><div class="serve-explain-text"><div class="serveintoor-title">2、云地理编码只能解析自定义的地址数据吗？</div>地址数据指云存储中数据表address字段，具体内容可自定义，不严格要求。如果在云存储中，地点address参数存储数据“西二旗服务点”，且赋值坐标点，使用云地理编码服务，即可解析“西二旗服务点”，获得对应地点坐标。</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日
| |
| − |
| |
| − | 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>
| |
NEW !
