“webapi

2018年12月6日 (四) 10:11的版本

服务介绍

服务文档

使用指南

常见问题

更新日志

资源下载

内容（服务介绍）

全球逆地理编码服务

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

功能介绍

逆地理编码服务

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

接口功能介绍

逆地理编码

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映射表（对应latest_admin=1）【更新至18年10月15日】

逆地理编码服务使用的国家标准行政区划代码（adcode）映射表。持续更新。（注意：该映射表对应的是最新版行政区划，需要在请求中使用latest_admin=1字段，详情见服务文档）

下载

百度地图行政区划adcode映射表（对应latest_admin=0）【不再更新】

逆地理编码服务使用的旧版国家标准行政区划代码（adcode）映射表。（注意：该映射表对应的是旧版行政区划，也就是latest_admin=0字段对应的行政区划或默认行政区划，详情见服务文档）

下载

百度地图country_code映射表

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

下载

国际标准国家代码映射表

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

下载

百度地图POI行业分类（tag）

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

查看

@@ 第399行： / 第399行： @@
 <div class="download-btn">[http://developer.baidu.com/map/static/doc/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>
-<div class="download-btn">[http://wiki.lbsyun.baidu.com/cms/citycode/BaiduMap_cityCode_1102.zip 下载]</div><br/></div><div class="serve-explain-text"><div class="serveintoor-title">百度地图行政区划adcode映射表【更新至18年10月15日】</div>
+<div class="download-btn">[http://wiki.lbsyun.baidu.com/cms/citycode/BaiduMap_cityCode_1102.zip 下载]</div><br/></div><div class="serve-explain-text"><div class="serveintoor-title">百度地图行政区划adcode映射表（对应latest_admin=1）【更新至18年10月15日】</div>
-&nbsp;逆地理编码服务使用的国家标准行政区划代码（adcode）映射表。持续更新。（<span style="color:#FF0000;">注意：</span>该映射表对应的是最新版行政区划，需要使用latest_admin字段，详情见服务文档）
+&nbsp;逆地理编码服务使用的国家标准行政区划代码（adcode）映射表。持续更新。（<span style="color:#FF0000;">注意：</span>该映射表对应的是最新版行政区划，需要在请求中使用latest_admin=1字段，详情见服务文档）
-<div class="download-btn">[http://mapopen-pub-webserviceapi.bj.bcebos.com/geocoding/区县级行政区划清单V37.xlsx 下载]</div><br/></div><div class="serve-explain-text"><div class="serveintoor-title">百度地图country_code映射表</div>
+<div class="download-btn">[http://mapopen-pub-webserviceapi.bj.bcebos.com/geocoding/区县级行政区划清单V37.xlsx 下载]</div><br/></div><div class="serve-explain-text"><div class="serveintoor-title">百度地图行政区划adcode映射表（对应latest_admin=0）【不再更新】</div>
+&nbsp;逆地理编码服务使用的旧版国家标准行政区划代码（adcode）映射表。（<span style="color:#FF0000;">注意：</span>该映射表对应的是旧版行政区划，也就是latest_admin=0字段对应的行政区划或默认行政区划，详情见服务文档）
+<div class="download-btn">[http://mapopen-pub-webserviceapi.bj.bcebos.com/geocoding/13版（latest_admin=0）adcode映射表.xlsx 下载]</div><br/></div><div class="serve-explain-text"><div class="serveintoor-title">百度地图country_code映射表</div>
 &nbsp;百度地图定义的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>

WebAPI文档全面上新

2018年12月6日 (四) 10:11的版本