浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
服务介绍
服务文档
使用指南
常见问题
更新日志
资源下载
全球逆地理编码服务

全球逆地理编码服务(又名Geocoder)是一类Web API接口服务;
逆地理编码服务提供将坐标点(经纬度)转换为对应位置信息(如所在行政区划,周边地标点分布)功能。
服务同时支持全球行政区划位置描述及周边地标POI数据召回(包括中国在内的全球200多个国家地区);
若需访问境外POI,需申请「逆地理编码境外POI」服务权限,请申请开通境外服务权限。

功能介绍
逆地理编码服务

用户可通过该功能,将位置坐标解析成对应的行政区划数据以及周边高权重地标地点分布情况,整体描述坐标所在的位置。

RGC.png

接口功能介绍
逆地理编码
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
province
省名
string
city
城市名
string
district
区县名
string
town 乡镇名 string
town_code
乡镇id string
street
街道名(行政区划中的街道层级)
string
street_number
街道门牌号
string
adcode
行政区划代码
int
country_code
国家代码
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基础召回字段相同。

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 当前并发量已经超过约定并发配额,并且服务总并发量也已经超过设定的总并发配额,限制访问 并发控制超限,请控制并发量或联系我们
使用方法
如不访问境外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,走以下服务使用流程,需单独申请境外服务权限,流程如下:
服务开通方法

境外逆地理编码服务为付费服务,需单独申请开通境外服务。

.1、通过控制台获取AK

.2、点击申请开通境外服务使用权限

服务配额

境外逆地理编码服务为付费服务,根据需求日配额及并发次数付费使用,具体价格和配额提升请通过联系我们了解。

.每个开发者账号每天调用“境外逆地理编码”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 

服务资源下载
百度地图城市名称-中心点经纬度(cityCenter)关系对照

您可以通过此文件获知百度地图的全国各城市中心点(cityCenter)经纬度


百度地图城市名称-城市代码(cityCode)关系对照

您可以通过此文件获知百度地图的全国各城市代码(cityCode)。 在使用百度地图API或SDK各种涉及citycode参数的服务时,您可参看此文件传入准确值,如JavaScript API的本地检索服务(根据cityCode获取本地检索结果)、Android SDK离线地图服务(根据cityCode,获取对应城市离线地图)等。
注意:cityCode为百度内部定义,已不再维护,请谨慎使用。


百度地图行政区划adcode映射表【更新至19年10月】

 逆地理编码服务使用的国家标准行政区划代码(adcode)映射表。持续更新。
注意:该映射表对应的是最新版行政区划,V2.0版本需要设置latest_admin=1,V3.0版本默认返回最新行政区划)

百度地图country_code映射表

 百度地图定义的country_code数字编码映射表,持续更新。


国际标准国家代码映射表

 ISO 3166-1国际标准国家映射码中,两位字母&三位字母映射表


百度地图POI行业分类(tag)

您可以通过此链接获知百度地图POI(兴趣点)的tag引导体系,辅助您检索POI。 如检索query为百度地图的tag“生活服务”,返回的检索结果即包含关键字为“生活服务”的POI、也包含tag为“生活服务”的POI,从而聚焦检索结果。


  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

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

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消