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

WEB 服务API

百度地图Web服务API为开发者提供http/https接口,即开发者通过http/https形式发起检索请求,获取返回json或xml格式的检索数据。用户可以基于此开发JavaScript、C#、C++、Java等语言的地图应用。

服务介绍
服务文档
使用指南
常见问题
更新日志
资源下载
全球逆地理编码服务

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

功能介绍
逆地理编码服务

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

RGC.png

接口功能介绍
逆地理编码
http://api.map.baidu.com/geocoder/v2/?callback=renderReverse&location=35.658651,139.745415&output=json&pois=1&ak=您的ak //GET请求
请求参数
参数名 参数含义 类型 举例 默认值 是否必须
location 根据经纬度坐标获取地址。
float 38.76623,116.43213

lat<纬度>,lng<经度>

coordtype 坐标的类型,目前支持的坐标类型包括:bd09ll(百度经纬度坐标)、bd09mc(百度米制坐标)、gcj02ll(国测局经纬度坐标,仅限中国)、wgs84ll( GPS经纬度) 坐标系说明 string bd09ll、gcj02ll bd09ll

ret_coordtype 可选参数,添加后返回国测局经纬度坐标或百度米制坐标 坐标系说明 string gcj02ll(国测局坐标,仅限中国)、bd09mc(百度墨卡托坐标) bd09ll(百度经纬度坐标)
pois
是否召回传入坐标周边的poi,0为不召回,1为召回。当值为1时,默认显示周边1000米内的poi。
注意:若需访问海外POI,需申请「逆地理编码海外POI」服务权限,请提交工单申请。
int 0
0
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函数名)
extensions_poi
区别于pois参数,pois=0,不召回pois数据,但后端仍访问poi相应服务;extensions_poi=null时,后端不调用poi相关服务,可减少服务访问时延。
注意:若需访问海外POI,需申请「逆地理编码海外POI」服务权限,请提交工单申请。
string
null
extensions_road
当取值为true时,召回坐标周围最近的3条道路数据。区别于行政区划中的street参数(street参数为行政区划中的街道,和普通道路不对应)。
string
false、true false
extensions_town
当取值为true时,行政区划返回乡镇级数据(仅国内召回乡镇数据)。默认不访问。
string
true
language
指定召回的新政区划语言类型。
召回行政区划语言list(全量支持的语言见示例)。
当language=local时,根据请求中坐标所对应国家的母语类型,自动选择对应语言类型的行政区划召回。
目前支持多语言的行政区划区划包含country、provence、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
latest_admin
是否访问最新版行政区划数据(仅对中国数据生效),1(访问),0(不访问)
int 0、1
0
返回结果参数
名称
含义 类型
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
street
街道名(行政区划中的街道层级)
string
street_number
街道门牌号
string
adcode
行政区划代码 adcode映射表
int
country_code
国家代码
int
direction
相对当前坐标点的方向,当有门牌号的时候返回数据
string
distance
相对当前坐标点的距离,当有门牌号的时候返回数据
string
pois(周边poi数组)
addr
地址信息
string
cp
数据来源(已废弃)
string
direction
和当前坐标点的方向
string
distance
离坐标点距离
int
name
poi名称
string
poiType
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 ok 正常 服务请求正常召回
1
服务器内部错误

2 Parameter Invalid 请求参数非法 必要参数拼写错误或漏传(如query和tag请求中均未传入)
3 Verify Failure 权限校验失败
4 Quota Failure 配额校验失败 服务当日调用次数已超限,请前往API控制台提升(请优先进行开发者认证
5 AK Failure ak不存在或者非法 未传入ak参数;ak已被删除(可前往回收站恢复);
101

服务禁用

102

不通过白名单或者安全码不对

2xx

无权限

3xx

配额错误

使用方法
如不访问国际化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、我能通过接口召回自己的地点数据吗?

可以支持。请使用「云逆地理编码服务」。

2018年3月24日

V1.0


产品发布
国际化逆地理编码服务上线

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

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


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

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


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

 逆地理编码服务使用的国家标准行政区划代码(adcode)映射表。持续更新


百度地图country_code映射表

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


国际标准国家代码映射表

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


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

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