| （未显示1个用户的82个中间版本） | |||
| 第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"> | <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"> | ||
| − | + | 全球逆地理编码服务是一类Web API接口服务；<br/>'''逆地理编码服务'''提供将坐标点（经纬度）转换为对应位置信息（如所在行政区划，周边地标点分布）功能。<br/>服务同时支持全球行政区划位置描述及周边地标POI数据召回（包括中国在内的全球200多个国家地区）；<br/><br/><span style="color:#FF0000;">逆地理编码境外POI服务为开放平台高级服务，需申请开通权限后才能访问服务，如有需求请提交[http://lbsyun.baidu.com/apiconsole/fankui 【工单】]咨询。<br/>2021年7月27日起，逆地理编码返回的行政区划按照民政部标准进行更新，将不包含工业园区、经济开发区等区域（如苏州工业园区）。如果您对工业园区等区划范围有特殊需要，可以[https://lbsyun.baidu.com/apiconsole/fankui#?typeOne=产品需求&typeTwo=新服务/功能需求 联系我们]进行反馈。</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> | </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> | ||
用户可通过该功能，将位置坐标解析成对应的行政区划数据以及周边高权重地标地点分布情况，整体描述坐标所在的位置。 | 用户可通过该功能，将位置坐标解析成对应的行政区划数据以及周边高权重地标地点分布情况，整体描述坐标所在的位置。 | ||
</div><div class="serveintorright"> | </div><div class="serveintorright"> | ||
http://mapopen-pub-webserviceapi.bj.bcebos.com/images/RGC.png | http://mapopen-pub-webserviceapi.bj.bcebos.com/images/RGC.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="serveintoor-title service-page-anchor">逆地理编码</div><div class="code-template"><pre class="get-url-pre"> | + | </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">https://api.map.baidu.com/reverse_geocoding/v3/?ak=您的ak&output=json&coordtype=wgs84ll&location=31.225696563611,121.49884033194 //GET请求 |
| − | + | ||
</pre> | </pre> | ||
| − | < | + | 注意：当前为V3.0版本接口文档，V2.0及以前版本自2019.6.18起新用户无法使用。老用户仍可继续使用V2.0及以前版本请求实现逆地理编码服务，为保障用户体验，建议您尽快迁移到V3.0版本。<br/>如在使用V3.0 时“鉴权失败“ 可在”[http://lbsyun.baidu.com/apiconsole/key 控制台]“->"查看应用"->“设置” 确认是否已获得“逆地理编码服务”权限。<br/>如有其他问题，可通过“[https://lbsyun.baidu.com/apiconsole/fankui 反馈与帮助]”反馈给我们。 |
</div></div><div class="separate-title"><br/>请求参数</div> | </div></div><div class="separate-title"><br/>请求参数</div> | ||
{| | {| | ||
| 第42行： | 第41行： | ||
| style="width: 189px;" | gcj02ll（国测局坐标，仅限中国）、bd09mc（百度墨卡托坐标） | | style="width: 189px;" | gcj02ll（国测局坐标，仅限中国）、bd09mc（百度墨卡托坐标） | ||
| style="width: 107px;" | bd09ll（百度经纬度坐标） | | style="width: 107px;" | bd09ll（百度经纬度坐标） | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| style="width: 53px;" | 否 | | style="width: 53px;" | 否 | ||
|- | |- | ||
| 第85行： | 第77行： | ||
| style="width: 107px;" | 无 | | style="width: 107px;" | 无 | ||
| style="width: 53px;" | 否<br/> | | style="width: 53px;" | 否<br/> | ||
| + | |- | ||
| + | | poi_types<br/> | ||
| + | | style="width: 319px;" | 可以选择poi类型召回不同类型的poi，例如poi_types=酒店，如想召回多个POI类型数据，可以‘|’分割<br/>例如poi_types=酒店|房地产<br/>不添加该参数则默认召回全部POI分类数据。[http://lbsyun.baidu.com/index.php?title=lbscloud/poitags poi分类] | ||
| + | | style="width: 33px;" | string<br/> | ||
| + | | style="width: 189px;" | poi_types=酒店<br/>poi_types=酒店|房地产<br/> | ||
| + | | style="width: 107px;" | 无 | ||
| + | | style="width: 53px;" | 否 | ||
|- | |- | ||
| extensions_poi<br/> | | extensions_poi<br/> | ||
| − | | style="width: 319px;" | | + | | style="width: 319px;" | extensions_poi=0，不召回pois数据。<br/>extensions_poi=1，返回pois数据（默认显示周边1000米内的poi），并返回sematic_description语义化数据。<br/><br/> |
| style="width: 33px;" | string<br/> | | style="width: 33px;" | string<br/> | ||
| − | | style="width: 189px;" | | + | | style="width: 189px;" | 0<br/> |
| style="width: 107px;" | 无 | | style="width: 107px;" | 无 | ||
| style="width: 53px;" | 否 | | style="width: 53px;" | 否 | ||
| 第101行： | 第100行： | ||
|- | |- | ||
| extensions_town<br/> | | extensions_town<br/> | ||
| − | | style="width: 319px;" | | + | | style="width: 319px;" | 当取值为true时，行政区划返回乡镇级数据（town），仅国内召回乡镇数据。默认不访问。<br/> |
| style="width: 33px;" | string<br/> | | style="width: 33px;" | string<br/> | ||
| style="width: 189px;" | true | | style="width: 189px;" | true | ||
| 第108行： | 第107行： | ||
|- | |- | ||
| language<br/> | | language<br/> | ||
| − | | style="width: 319px;" | <span style="color:#626262;"><span style="font-family:微软雅黑,sans-serif;"><span style="font-size:9.0pt;"> | + | | style="width: 319px;" | <span style="color:#626262;"><span style="font-family:微软雅黑,sans-serif;"><span style="font-size:9.0pt;">指定召回的行政区划语言类型。</span></span></span><br/><span style="color:#626262;"><span style="font-family:微软雅黑,sans-serif;"><span style="font-size:9.0pt;">召回行政区划语言list</span>（全量支持的语言见示例）。</span></span><br/><span style="color:#626262;"><span style="font-family:微软雅黑,sans-serif;"><span style="font-size:9.0pt;">当language=local</span>时，根据请求中坐标所对应国家的母语类型，自动选择对应语言类型的行政区划召回。</span></span><br/><span style="color:#626262;"><span style="font-family:微软雅黑,sans-serif;"><span style="font-size:9.0pt;">目前支持多语言的行政区划区划包含country</span>、province</span>、city</span>、district<br/> |
| style="width: 33px;" | string<br/> | | style="width: 33px;" | string<br/> | ||
| − | | style="width: 189px;" | el gu en vi ca it iw sv eu ar cs gl id es en-GB ru sr nl pt tr tl lv en-AU lt | + | | style="width: 189px;" | el gu en vi ca it iw sv eu ar cs gl id es en-GB ru sr nl pt tr tl lv en-AU lt th ro fil ta fr bg hr bn de hu fa hi pt-BR fi da ja te pt-PT ml ko kn sk zh-CN pl uk sl mr <br/>local<br/> |
| style="width: 107px;" | en，国内默认zh-CN<br/> | | style="width: 107px;" | en，国内默认zh-CN<br/> | ||
| style="width: 53px;" | 否 | | style="width: 53px;" | 否 | ||
|- | |- | ||
| language_auto<br/> | | language_auto<br/> | ||
| − | | style="width: 319px;" | <span style="color:#626262;"><span style="font-family:微软雅黑,sans-serif;"><span style="font-size:9.0pt;"> | + | | style="width: 319px;" | <span style="color:#626262;"><span style="font-family:微软雅黑,sans-serif;"><span style="font-size:9.0pt;">当用户指定language参数时，是否自动填充行政区划。</span></span></span><br/><span style="color:#626262;"><span style="font-family:微软雅黑,sans-serif;"><span style="font-size:9.0pt;">1</span></span></span><span style="color:#626262;"><span style="font-family:微软雅黑,sans-serif;"><span style="font-size:9.0pt;">填充，0</span>不填充。</span></span><br/><span style="color:#626262;"><span style="font-family:微软雅黑,sans-serif;"><span style="font-size:9.0pt;">填充：当服务按某种语言类别召回时，若某一行政区划层级的语言数据未覆盖，则按照“</span>英文→</span>中文→</span>本地语言”类别行政区划数据对该层级行政区划进行填充，保证行政区划数据召回完整性。<br/> |
| style="width: 33px;" | int | | style="width: 33px;" | int | ||
| style="width: 189px;" | 0、1 | | style="width: 189px;" | 0、1 | ||
| style="width: 107px;" | 无 | | style="width: 107px;" | 无 | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| style="width: 53px;" | 否 | | style="width: 53px;" | 否 | ||
|} | |} | ||
| 第161行： | 第153行： | ||
| style="width: 88px;" | string | | style="width: 88px;" | string | ||
|- | |- | ||
| − | | style="width: 123px;" rowspan=" | + | | style="width: 123px;" rowspan="15" colspan="1" | addressComponent<br/>（注意，国外行政区划，字段仅代表层级）<br/> |
| style="width: 123px;" | country<br/> | | style="width: 123px;" | country<br/> | ||
| style="width: 680px;" | 国家<br/> | | style="width: 680px;" | 国家<br/> | ||
| + | | style="width: 88px;" | string<br/> | ||
| + | |- | ||
| + | | style="width: 123px;" | country_code<br/> | ||
| + | | style="width: 680px;" | 国家编码 | ||
| + | | style="width: 88px;" | int | ||
| + | |- | ||
| + | | style="width: 123px;" | country_code_iso<br/> | ||
| + | | style="width: 680px;" | 国家英文缩写（三位） | ||
| + | | style="width: 88px;" | string<br/> | ||
| + | |- | ||
| + | | style="width: 123px;" | country_code_iso2<br/> | ||
| + | | style="width: 680px;" | 国家英文缩写（两位）<br/> | ||
| style="width: 88px;" | string<br/> | | style="width: 88px;" | string<br/> | ||
|- | |- | ||
| 第173行： | 第177行： | ||
| style="width: 680px;" | 城市名<br/> | | style="width: 680px;" | 城市名<br/> | ||
| style="width: 88px;" | string<br/> | | style="width: 88px;" | string<br/> | ||
| + | |- | ||
| + | | style="width: 123px;" | city_level<br/> | ||
| + | | style="width: 680px;" | 城市所在级别（仅国外有参考意义。国外行政区划与中国有差异，城市对应的层级不一定为『city』。country、province、city、district、town分别对应0-4级，若city_level=3，则district层级为该国家的city层级） | ||
| + | | style="width: 88px;" | int | ||
|- | |- | ||
| style="width: 123px;" | district<br/> | | style="width: 123px;" | district<br/> | ||
| 第179行： | 第187行： | ||
|- | |- | ||
| style="width: 123px;" | town | | style="width: 123px;" | town | ||
| − | | style="width: 680px;" | | + | | style="width: 680px;" | 乡镇名，需设置extensions_town=true时才会返回 |
| style="width: 88px;" | string | | style="width: 88px;" | string | ||
| + | |- | ||
| + | | style="width: 123px;" | town_code<br/> | ||
| + | | style="width: 680px;" | 乡镇id | ||
| + | | style="width: 88px;" | string<br/> | ||
|- | |- | ||
| style="width: 123px;" | street<br/> | | style="width: 123px;" | street<br/> | ||
| 第191行： | 第203行： | ||
|- | |- | ||
| style="width: 123px;" | adcode<br/> | | style="width: 123px;" | adcode<br/> | ||
| − | | style="width: 680px;" | | + | | style="width: 680px;" | 行政区划代码，[https://lbsyun.baidu.com/index.php?title=open/dev-res 前往下载]<br/> |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| style="width: 88px;" | int | | style="width: 88px;" | int | ||
|- | |- | ||
| 第250行： | 第258行： | ||
| style="width: 680px;" | poi对应的主点poi（如，海底捞的主点为上地华联，该字段则为上地华联的poi信息。如无，该字段为空），包含子字段和pois基础召回字段相同。<br/> | | style="width: 680px;" | poi对应的主点poi（如，海底捞的主点为上地华联，该字段则为上地华联的poi信息。如无，该字段为空），包含子字段和pois基础召回字段相同。<br/> | ||
| style="width: 88px;" | <br/> | | style="width: 88px;" | <br/> | ||
| + | |- | ||
| + | | style="width: 123px;" colspan="1" rowspan="2" | roads<br/> | ||
| + | | style="width: 123px;" | name | ||
| + | | style="width: 680px;" | 周边道路名称 | ||
| + | | style="width: 88px;" | string | ||
| + | |- | ||
| + | | style="width: 123px;" | distance | ||
| + | | style="width: 680px;" | 传入的坐标点距离道路的大概距离 | ||
| + | | style="width: 88px;" | string | ||
|- | |- | ||
| style="width: 123px;" colspan="1" rowspan="3" | poiRegions<br/> | | style="width: 123px;" colspan="1" rowspan="3" | poiRegions<br/> | ||
| 第265行： | 第282行： | ||
|- | |- | ||
| style="width: 123px;" colspan="2" rowspan="1" | sematic_description<br/> | | style="width: 123px;" colspan="2" rowspan="1" | sematic_description<br/> | ||
| − | | style="width: 680px;" | | + | | style="width: 680px;" | 当前位置结合POI的语义化结果描述。需设置extensions_poi=1才能返回。<br/> |
| style="width: 88px;" | string | | style="width: 88px;" | string | ||
|- | |- | ||
| 第286行： | 第303行： | ||
| style="width: 200px;" | 服务器内部错误 | | style="width: 200px;" | 服务器内部错误 | ||
| style="width: 416px;" | 该服务响应超时或系统内部错误，请留下联系方式 | | style="width: 416px;" | 该服务响应超时或系统内部错误，请留下联系方式 | ||
| + | |- | ||
| + | | 2 | ||
| + | | style="width: 200px;" | 参数错误 | ||
| + | | style="width: 416px;" | 坐标类型错误，location格式错误 | ||
|- | |- | ||
| 10 | | 10 | ||
| 第353行： | 第374行： | ||
| 261 | | 261 | ||
| style="width: 200px;" | 服务被禁用 | | style="width: 200px;" | 服务被禁用 | ||
| − | | style="width: 416px;" | | + | | style="width: 416px;" | 该服务已下线，<span style="color:#FF0000;">请在控制台确认是否有该服务的权限。</span> |
|- | |- | ||
| 301 | | 301 | ||
| style="width: 200px;" | 永久配额超限，限制访问 | | style="width: 200px;" | 永久配额超限，限制访问 | ||
| − | | style="width: 416px;" | 配额超限，如果想增加配额请[ | + | | style="width: 416px;" | 配额超限，如果想增加配额请[https://lbsyun.baidu.com/apiconsole/fankui 联系我们] |
|- | |- | ||
| 302 | | 302 | ||
| style="width: 200px;" | 天配额超限，限制访问 | | style="width: 200px;" | 天配额超限，限制访问 | ||
| − | | style="width: 416px;" | 配额超限，如果想增加配额请[ | + | | style="width: 416px;" | 配额超限，如果想增加配额请[https://lbsyun.baidu.com/apiconsole/fankui 联系我们] |
|- | |- | ||
| 401 | | 401 | ||
| style="width: 200px;" | 当前并发量已经超过约定并发配额，限制访问 | | style="width: 200px;" | 当前并发量已经超过约定并发配额，限制访问 | ||
| − | | style="width: 416px;" | 并发控制超限，请控制并发量或[ | + | | style="width: 416px;" | 并发控制超限，请控制并发量或[https://lbsyun.baidu.com/apiconsole/fankui 联系我们] |
|- | |- | ||
| 402 | | 402 | ||
| style="width: 200px;" | 当前并发量已经超过约定并发配额，并且服务总并发量也已经超过设定的总并发配额，限制访问 | | style="width: 200px;" | 当前并发量已经超过约定并发配额，并且服务总并发量也已经超过设定的总并发配额，限制访问 | ||
| − | | style="width: 416px;" | 并发控制超限，请控制并发量或[ | + | | style="width: 416px;" | 并发控制超限，请控制并发量或[https://lbsyun.baidu.com/apiconsole/fankui 联系我们] |
|} | |} | ||
</div><div class="navRemark"><div class="handpointto">内容（使用指南）</div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">使用方法</div></div><div class="serveintoor-title">如不访问境外POI，走以下服务使用流程</div><div class="useguide"><div class="useguide_bg"></div><div class="useguide_li"> | </div><div class="navRemark"><div class="handpointto">内容（使用指南）</div></div><div class="txtstyle2"><div class="bluetitle"><div class="services-title-text">使用方法</div></div><div class="serveintoor-title">如不访问境外POI，走以下服务使用流程</div><div class="useguide"><div class="useguide_bg"></div><div class="useguide_li"> | ||
| 第432行： | 第453行： | ||
{{bluepoint}}同一个账号下的HTTP/HTTPS请求，配额，并发共享。 | {{bluepoint}}同一个账号下的HTTP/HTTPS请求，配额，并发共享。 | ||
</div><div class="bluetitle"><br/></div></div></div><div class="navRemark"><div class="handpointto">内容（常见问题）</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">1、使用逆地址解析的批量解析功能，配额是如何计算的？</div> | </div><div class="bluetitle"><br/></div></div></div><div class="navRemark"><div class="handpointto">内容（常见问题）</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">1、使用逆地址解析的批量解析功能，配额是如何计算的？</div> | ||
| − | 若一次请求同时解析20个坐标点，则对应消耗20次请求配额。 | + | 若一次请求同时解析20个坐标点，则对应消耗20次请求配额。<br/><br/>2、<span style="font-size:larger;">为什么返回的数据行政区划district不正确？</span><br/><span style="color:#696969;">老版本请确认添加latest_admin=1，请求访问最新的行政区划数据。<br/>新版本默认返回最新行政区划数据</span><br/><br/><span style="font-size:larger;">3. 为什么county_code=-1？</span><br/> county_code=-1表示未查找到国家，有可能当前定位点在非陆地区域。<br/><br/>4. 为什么提示服务被禁用？<br/> 请在[http://lbs.baidu.com/apiconsole/key 控制台]确认您的AK是否有该服务的权限。 当前为V3.0版本接口文档，V2.0及以前版本自2019.6.18起新用户无法使用。老用户仍可继续使用V2.0及以前版本请求实现逆地理编码服务，为保障用户体验，建议您尽快迁移到V3.0版本。 |
| − | + | ||
| − | + | 可在”[http://lbsyun.baidu.com/apiconsole/key 控制台]“->"查看应用"->“设置” 确认是否已获得“逆地理编码服务”权限。 | |
| − | </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 | + | |
| + | 如有其他问题，可通过“[https://lbsyun.baidu.com/apiconsole/fankui 反馈与帮助]”反馈给我们。 | ||
| + | |||
| + | |||
| + | </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"> | ||
2018年3月24日 | 2018年3月24日 | ||
V1.0 | 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">全球逆地理编码服务上线</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> | + | </div><div class="timeversions"> |
| + | 2018年6月15日 | ||
| + | |||
| + | V2.0 | ||
| + | </div><div class="timeversions"> | ||
| + | 2019年6月18日 | ||
| + | |||
| + | V3.0 | ||
| + | </div><div class="timeversions intro"> | ||
| + | 2019年10月11日 | ||
| + | |||
| + | V3.1 | ||
| + | </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">全球逆地理编码服务上线</div></div><div class="updatebox"><div class="bluetitle"><div class="services-title-text">bug修复</div></div><div class="serve-explain-text">修复线上bug<br/></div></div><div class="updatebox"><div class="bluetitle"><div class="services-title-text">功能优化</div></div><div class="serve-explain-text">1. 逆地理编码默认加载最新行政区划 2. 逆地理编码优化返回pois策略<br/></div></div><div class="updatebox"><div class="bluetitle"><div class="services-title-text">功能优化</div></div><div class="serve-explain-text">1.新增根据POI类型召回pois 2. 新增乡镇ID，town_code <br/></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）经纬度 | 您可以通过此文件获知百度地图的全国各城市中心点（cityCenter）经纬度 | ||
| − | <div class="download-btn">[ | + | <div class="download-btn">[https://mapopen-website-wiki.bj.bcebos.com/operaZip/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> | 您可以通过此文件获知百度地图的全国各城市代码（cityCode)。 在使用百度地图API或SDK各种涉及citycode参数的服务时，您可参看此文件传入准确值，如JavaScript API的本地检索服务（根据cityCode获取本地检索结果）、Android SDK离线地图服务（根据cityCode，获取对应城市离线地图）等。<br/><font color="red">注意：cityCode为百度内部定义，已不再维护，请谨慎使用。</font> | ||
| − | <div class="download-btn">[ | + | <div class="download-btn">[https://mapopen-website-wiki.bj.bcebos.com/operaZip/BaiduMap_cityCode_1102.zip 下载]</div><br/></div><div class="serve-explain-text"><div class="serveintoor-title">百度地图行政区划adcode映射表【更新至22年07月】<br/><br/></div> |
| − | | + | 逆地理编码服务使用的国家标准行政区划代码（adcode）映射表。持续更新。<br/>（<span style="color:#FF0000;">注意：</span>该映射表对应的是最新版行政区划，V2.0版本需要设置latest_admin=1，V3.0版本默认返回最新行政区划） |
| − | <div class="download-btn">[ | + | <div class="download-btn">[https://mapopen-pub-webserviceapi.bj.bcebos.com/geocoding/Township_Area_A_20220722.xlsx 下载]<br/></div></div><div class="serve-explain-text"><div class="serveintoor-title">百度地图country_code映射表</div> |
百度地图定义的country_code数字编码映射表，持续更新。 | 百度地图定义的country_code数字编码映射表，持续更新。 | ||
<div class="download-btn">[http://mapopen-pub-webserviceapi.bj.bcebos.com/geocoding/country_code.csv 下载]</div><br/></div><div class="serve-explain-text"><div class="serveintoor-title">国际标准国家代码映射表</div> | <div class="download-btn">[http://mapopen-pub-webserviceapi.bj.bcebos.com/geocoding/country_code.csv 下载]</div><br/></div><div class="serve-explain-text"><div class="serveintoor-title">国际标准国家代码映射表</div> | ||
2022年8月12日 (五) 18:30的版本
服务介绍
服务文档
使用指南
常见问题
更新日志
资源下载
全球逆地理编码服务
全球逆地理编码服务是一类Web API接口服务；
逆地理编码服务提供将坐标点（经纬度）转换为对应位置信息（如所在行政区划，周边地标点分布）功能。
服务同时支持全球行政区划位置描述及周边地标POI数据召回（包括中国在内的全球200多个国家地区）；
逆地理编码境外POI服务为开放平台高级服务，需申请开通权限后才能访问服务，如有需求请提交【工单】咨询。
2021年7月27日起，逆地理编码返回的行政区划按照民政部标准进行更新，将不包含工业园区、经济开发区等区域（如苏州工业园区）。如果您对工业园区等区划范围有特殊需要，可以联系我们进行反馈。
功能介绍
逆地理编码服务
用户可通过该功能，将位置坐标解析成对应的行政区划数据以及周边高权重地标地点分布情况，整体描述坐标所在的位置。
接口功能介绍
逆地理编码
https://api.map.baidu.com/reverse_geocoding/v3/?ak=您的ak&output=json&coordtype=wgs84ll&location=31.225696563611,121.49884033194 //GET请求
注意：当前为V3.0版本接口文档，V2.0及以前版本自2019.6.18起新用户无法使用。老用户仍可继续使用V2.0及以前版本请求实现逆地理编码服务，为保障用户体验，建议您尽快迁移到V3.0版本。
如在使用V3.0 时“鉴权失败“ 可在”控制台“->"查看应用"->“设置” 确认是否已获得“逆地理编码服务”权限。
如有其他问题，可通过“反馈与帮助”反馈给我们。
请求参数
| 参数名 | 参数含义 | 类型 | 举例 | 默认值 | 是否必须 |
|---|---|---|---|---|---|
| location | 根据经纬度坐标获取地址。 |
float | 38.76623,116.43213
lat<纬度>,lng<经度> |
无 | 是 |
| coordtype | 坐标的类型，目前支持的坐标类型包括：bd09ll（百度经纬度坐标）、bd09mc（百度米制坐标）、gcj02ll（国测局经纬度坐标，仅限中国）、wgs84ll（ GPS经纬度） 坐标系说明 | string | bd09ll、gcj02ll | bd09ll |
否 |
| ret_coordtype | 可选参数，添加后返回国测局经纬度坐标或百度米制坐标 坐标系说明 | string | gcj02ll（国测局坐标，仅限中国）、bd09mc（百度墨卡托坐标） | bd09ll（百度经纬度坐标） | 否 |
| radius |
poi召回半径，允许设置区间为0-1000米，超过1000米按1000米召回。 |
int | 500 |
1000 | 否 |
| ak | 用户申请注册的key，自v2开始参数修改为“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函数名) | 无 | 否 |
| poi_types |
可以选择poi类型召回不同类型的poi，例如poi_types=酒店，如想召回多个POI类型数据，可以‘|’分割 例如poi_types=酒店|房地产 不添加该参数则默认召回全部POI分类数据。poi分类 |
string |
poi_types=酒店 poi_types=酒店|房地产 |
无 | 否 |
| extensions_poi |
extensions_poi=0，不召回pois数据。 extensions_poi=1，返回pois数据（默认显示周边1000米内的poi），并返回sematic_description语义化数据。 |
string |
0 |
无 | 否 |
| extensions_road |
当取值为true时，召回坐标周围最近的3条道路数据。区别于行政区划中的street参数（street参数为行政区划中的街道，和普通道路不对应）。 |
string |
false、true | false | 否 |
| extensions_town |
当取值为true时，行政区划返回乡镇级数据（town），仅国内召回乡镇数据。默认不访问。 |
string |
true | 无 | 否 |
| language |
指定召回的行政区划语言类型。 召回行政区划语言list（全量支持的语言见示例）。 当language=local时，根据请求中坐标所对应国家的母语类型，自动选择对应语言类型的行政区划召回。 目前支持多语言的行政区划区划包含country、province、city、district |
string |
el gu en vi ca it iw sv eu ar cs gl id es en-GB ru sr nl pt tr tl lv en-AU lt th ro fil ta fr bg hr bn de hu fa hi pt-BR fi da ja te pt-PT ml ko kn sk zh-CN pl uk sl mr local |
en，国内默认zh-CN |
否 |
| language_auto |
当用户指定language参数时，是否自动填充行政区划。 1填充，0不填充。 填充：当服务按某种语言类别召回时，若某一行政区划层级的语言数据未覆盖，则按照“英文→中文→本地语言”类别行政区划数据对该层级行政区划进行填充，保证行政区划数据召回完整性。 |
int | 0、1 | 无 | 否 |
返回结果参数
| 名称 |
含义 | 类型 | |
|---|---|---|---|
| status |
返回结果状态值， 成功返回0，其他值请查看下方返回码状态表。 | int | |
| location |
经纬度坐标 | object | |
| |
lat | 纬度值 | float |
| |
lng | 经度值 | float |
| formatted_address |
结构化地址信息 | string | |
| business |
坐标所在商圈信息，如 "人民大学,中关村,苏州街"。最多返回3个。 | string | |
| addressComponent （注意，国外行政区划，字段仅代表层级） |
country |
国家 |
string |
| country_code |
国家编码 | int | |
| country_code_iso |
国家英文缩写（三位） | string | |
| country_code_iso2 |
国家英文缩写（两位） |
string | |
| province |
省名 |
string | |
| city |
城市名 |
string | |
| city_level |
城市所在级别（仅国外有参考意义。国外行政区划与中国有差异，城市对应的层级不一定为『city』。country、province、city、district、town分别对应0-4级，若city_level=3，则district层级为该国家的city层级） | int | |
| district |
区县名 |
string | |
| town | 乡镇名，需设置extensions_town=true时才会返回 | string | |
| town_code |
乡镇id | string | |
| street |
街道名（行政区划中的街道层级） |
string | |
| street_number |
街道门牌号 |
string | |
| adcode |
行政区划代码，前往下载 |
int | |
| direction |
相对当前坐标点的方向，当有门牌号的时候返回数据 |
string | |
| distance |
相对当前坐标点的距离，当有门牌号的时候返回数据 |
string | |
| pois（周边poi数组） |
addr |
地址信息 |
string |
| cp |
数据来源（已废弃） |
string | |
| direction |
和当前坐标点的方向 |
string | |
| distance |
离坐标点距离 |
int | |
| name |
poi名称 |
string | |
| tag |
poi类型，如’美食;中餐厅’。tag与poiType字段均为poi类型，建议使用tag字段，信息更详细。poi详细类别 |
string | |
| point |
poi坐标{x,y} |
float | |
| tel |
电话 |
int | |
| uid |
poi唯一标识 |
string | |
| zip |
邮编 |
int | |
| parent_poi |
poi对应的主点poi（如，海底捞的主点为上地华联，该字段则为上地华联的poi信息。如无，该字段为空），包含子字段和pois基础召回字段相同。 |
| |
| roads |
name | 周边道路名称 | string |
| distance | 传入的坐标点距离道路的大概距离 | string | |
| poiRegions |
direction_desc |
请求中的坐标与所归属区域面的相对位置关系 | string |
| name |
归属区域面名称 | string | |
| tag |
归属区域面类型 | string | |
| sematic_description |
当前位置结合POI的语义化结果描述。需设置extensions_poi=1才能返回。 |
string | |
| cityCode |
百度定义的城市id（正常更新与维护，但建议使用adcode） |
int | |
服务状态码
| 返回码 | 定义 | 常见原因 |
|---|---|---|
| 0 | 正常 | 服务请求正常召回 |
| 1 | 服务器内部错误 | 该服务响应超时或系统内部错误，请留下联系方式 |
| 2 | 参数错误 | 坐标类型错误，location格式错误 |
| 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的时候禁用了某项服务，若需开通权限，可进入API控制台为AK勾选对应服务 |
| 250 | 用户不存在 | 根据请求的user_id, 数据库中找不到该用户的信息，请携带正确的user_id |
| 251 | 用户被自己删除 | 该用户处于未激活状态 |
| 252 |
用户被管理员删除 | 恶意用户被加入黑名单 |
| 260 | 服务不存在 | 服务器解析不到用户请求的服务名称 |
| 261 | 服务被禁用 | 该服务已下线，请在控制台确认是否有该服务的权限。 |
| 301 | 永久配额超限，限制访问 | 配额超限，如果想增加配额请联系我们 |
| 302 | 天配额超限，限制访问 | 配额超限，如果想增加配额请联系我们 |
| 401 | 当前并发量已经超过约定并发配额，限制访问 | 并发控制超限，请控制并发量或联系我们 |
| 402 | 当前并发量已经超过约定并发配额，并且服务总并发量也已经超过设定的总并发配额，限制访问 | 并发控制超限，请控制并发量或联系我们 |
使用方法
如不访问境外POI，走以下服务使用流程
编码说明
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表示百度墨卡托米制坐标
正/逆地理编码服务默认输入输出坐标类型为百度坐标（BD09），同时可通过参数（"coord_type","ret_coordtype"）控制输入输出坐标类型。输入坐标支持以上三种坐标系，输出坐标支持-国测局坐标（GCJ02）和百度坐标（BD09）
注意：不同类型坐标如需转换，请使用百度地图开放平台提供的标准坐标转换接口。请勿使用其他渠道提供的坐标转换方法，以免影响坐标转换精度。
服务配额
服务相关配额及并发请求限制请访问开发者权益页面查看。
如需要访问境外POI，走以下服务使用流程，需单独申请境外服务权限，流程如下：
服务开通方法
服务配额
境外逆地理编码服务为付费服务，根据需求日配额及并发次数付费使用，具体价格和配额提升请通过联系我们了解。
每个开发者账号每天调用“境外逆地理编码”API 服务的总次数（即配额）是有限的。
每个开发者账号每分钟调用“境外逆地理编码”API 服务的总次数（即并发量）是有限的。
同一个账号下的HTTP/HTTPS请求，配额，并发共享。
服务常见问题
1、使用逆地址解析的批量解析功能，配额是如何计算的？
若一次请求同时解析20个坐标点，则对应消耗20次请求配额。
2、为什么返回的数据行政区划district不正确？
老版本请确认添加latest_admin=1，请求访问最新的行政区划数据。
新版本默认返回最新行政区划数据
3. 为什么county_code=-1？
county_code=-1表示未查找到国家，有可能当前定位点在非陆地区域。
4. 为什么提示服务被禁用？
请在控制台确认您的AK是否有该服务的权限。 当前为V3.0版本接口文档，V2.0及以前版本自2019.6.18起新用户无法使用。老用户仍可继续使用V2.0及以前版本请求实现逆地理编码服务，为保障用户体验，建议您尽快迁移到V3.0版本。
可在”控制台“->"查看应用"->“设置” 确认是否已获得“逆地理编码服务”权限。
如有其他问题，可通过“反馈与帮助”反馈给我们。
2018年3月24日
V1.0
2018年6月15日
V2.0
2019年6月18日
V3.0
2019年10月11日
V3.1
产品发布
全球逆地理编码服务上线
bug修复
修复线上bug
功能优化
1. 逆地理编码默认加载最新行政区划 2. 逆地理编码优化返回pois策略
功能优化
1.新增根据POI类型召回pois 2. 新增乡镇ID，town_code
服务资源下载
百度地图城市名称-城市代码（cityCode）关系对照
您可以通过此文件获知百度地图的全国各城市代码（cityCode)。 在使用百度地图API或SDK各种涉及citycode参数的服务时，您可参看此文件传入准确值，如JavaScript API的本地检索服务（根据cityCode获取本地检索结果）、Android SDK离线地图服务（根据cityCode，获取对应城市离线地图）等。
注意：cityCode为百度内部定义，已不再维护，请谨慎使用。
百度地图行政区划adcode映射表【更新至22年07月】
逆地理编码服务使用的国家标准行政区划代码（adcode）映射表。持续更新。
（注意：该映射表对应的是最新版行政区划，V2.0版本需要设置latest_admin=1，V3.0版本默认返回最新行政区划）
百度地图POI行业分类（tag）
您可以通过此链接获知百度地图POI(兴趣点）的tag引导体系，辅助您检索POI。 如检索query为百度地图的tag“生活服务”，返回的检索结果即包含关键字为“生活服务”的POI、也包含tag为“生活服务”的POI，从而聚焦检索结果。