| 第153行： | 第153行： | ||
| style="width: 88px;" | string | | style="width: 88px;" | string | ||
|- | |- | ||
| − | | style="width: 123px;" rowspan=" | + | | style="width: 123px;" rowspan="14" 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/> | ||
|- | |- | ||
| 第188行： | 第200行： | ||
| style="width: 123px;" | adcode<br/> | | style="width: 123px;" | adcode<br/> | ||
| style="width: 680px;" | [http://lbsyun.baidu.com/index.php?title=open/dev-res 行政区划代码]<br/> | | style="width: 680px;" | [http://lbsyun.baidu.com/index.php?title=open/dev-res 行政区划代码]<br/> | ||
| − | |||
| − | |||
| − | |||
| − | |||
| style="width: 88px;" | int | | style="width: 88px;" | int | ||
|- | |- | ||
| 第246行： | 第254行： | ||
| 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/> | ||
2020年1月19日 (日) 11:15的版本
全球逆地理编码服务（又名Geocoder）是一类Web API接口服务；
逆地理编码服务提供将坐标点（经纬度）转换为对应位置信息（如所在行政区划，周边地标点分布）功能。
服务同时支持全球行政区划位置描述及周边地标POI数据召回（包括中国在内的全球200多个国家地区）；
若需访问境外POI，需申请「逆地理编码境外POI」服务权限，请申请开通境外服务权限。
用户可通过该功能，将位置坐标解析成对应的行政区划数据以及周边高权重地标地点分布情况，整体描述坐标所在的位置。
http://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。 注意：若需访问境外POI，需申请「逆地理编码境外POI」服务权限，请提交工单申请。 |
string |
0 |
无 | 否 |
| extensions_road |
当取值为true时，召回坐标周围最近的3条道路数据。区别于行政区划中的street参数（street参数为行政区划中的街道，和普通道路不对应）。 |
string |
false、true | false | 否 |
| extensions_town |
当取值为true时，行政区划返回乡镇级数据（仅国内召回乡镇数据）。默认不访问。 |
string |
true | 无 | 否 |
| language |
指定召回的新政区划语言类型。 召回行政区划语言list（全量支持的语言见示例）。 当language=local时，根据请求中坐标所对应国家的母语类型，自动选择对应语言类型的行政区划召回。 目前支持多语言的行政区划区划包含country、province、city、district 注意：多语言需申请「逆地理编码境外POI」服务权限，请提交工单申请。 |
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 zh-TW 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 |
是否自动填充行政区划。 1填充，0不填充。 填充：当服务按某种语言类别召回时，若某一行政区划层级数据未覆盖，则按照“英文→中文→本地语言”类别行政区划数据对该层级行政区划进行填充，保证行政区划数据召回完整性。 注意：多语言需申请「逆地理编码境外POI」服务权限，请提交工单申请。 |
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 | |
| district |
区县名 |
string | |
| town | 乡镇名 | 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的语义化结果描述。 |
string | |
| cityCode |
百度定义的城市id（正常更新与维护，但建议使用adcode） |
int | |
| 返回码 | 定义 | 常见原因 |
|---|---|---|
| 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的时候禁用了某项服务，若需开通权限，可进入API控制台为AK勾选对应服务 |
| 250 | 用户不存在 | 根据请求的user_id, 数据库中找不到该用户的信息，请携带正确的user_id |
| 251 | 用户被自己删除 | 该用户处于未激活状态 |
| 252 |
用户被管理员删除 | 恶意用户被加入黑名单 |
| 260 | 服务不存在 | 服务器解析不到用户请求的服务名称 |
| 261 | 服务被禁用 | 该服务已下线，请在控制台确认是否有该服务的权限。 |
| 301 | 永久配额超限，限制访问 | 配额超限，如果想增加配额请联系我们 |
| 302 | 天配额超限，限制访问 | 配额超限，如果想增加配额请联系我们 |
| 401 | 当前并发量已经超过约定并发配额，限制访问 | 并发控制超限，请控制并发量或联系我们 |
| 402 | 当前并发量已经超过约定并发配额，并且服务总并发量也已经超过设定的总并发配额，限制访问 | 并发控制超限，请控制并发量或联系我们 |
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）
注意：不同类型坐标如需转换，请使用百度地图开放平台提供的标准坐标转换接口。请勿使用其他渠道提供的坐标转换方法，以免影响坐标转换精度。
服务相关配额及并发请求限制请访问开发者权益页面查看。
境外逆地理编码服务为付费服务，根据需求日配额及并发次数付费使用，具体价格和配额提升请通过联系我们了解。
每个开发者账号每天调用“境外逆地理编码”API 服务的总次数（即配额）是有限的。
每个开发者账号每分钟调用“境外逆地理编码”API 服务的总次数（即并发量）是有限的。
同一个账号下的HTTP/HTTPS请求，配额，并发共享。
若一次请求同时解析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
您可以通过此文件获知百度地图的全国各城市代码（cityCode)。 在使用百度地图API或SDK各种涉及citycode参数的服务时，您可参看此文件传入准确值，如JavaScript API的本地检索服务（根据cityCode获取本地检索结果）、Android SDK离线地图服务（根据cityCode，获取对应城市离线地图）等。
注意：cityCode为百度内部定义，已不再维护，请谨慎使用。
逆地理编码服务使用的国家标准行政区划代码（adcode）映射表。持续更新。
（注意：该映射表对应的是最新版行政区划，V2.0版本需要设置latest_admin=1，V3.0版本默认返回最新行政区划）
您可以通过此链接获知百度地图POI(兴趣点）的tag引导体系，辅助您检索POI。 如检索query为百度地图的tag“生活服务”，返回的检索结果即包含关键字为“生活服务”的POI、也包含tag为“生活服务”的POI，从而聚焦检索结果。