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

所有文档

全球逆地理编码

全球逆地理编码
下载开发文档
接口说明

全球逆地理编码服务提供将坐标点(经纬度)转换为对应位置信息(如所在行政区划,周边地标点分布)功能。

使用说明

2023年5月1日起,全球逆地理编码返回的行政区划按照国家统计局标准进行更新,如果您对工业园区等区划范围有特殊需要,可以使用返回参数edz下的name字段,详情请参考返回参数表。

API服务地址

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根据经纬度坐标获取地址。38.76623,116.43213lat<纬度>,lng<经度>string
ak

用户申请注册的key,自v2开始参数修改为“ak”,之前版本参数为“key”申请ak

E4805d16******93a3fe70string
coordtype

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

bd09ll、gcj02stringbd09ll
ret_coordtype

可选参数,添加后返回国测局经纬度坐标或百度米制坐标 坐标系说明

gcj02(国测局坐标,仅限中国)、bd09mc(百度墨卡托坐标)stringbd09ll(百度经纬度坐标)
extensions_poi

extensions_poi=0,不召回pois数据。
extensions_poi=1,返回pois数据(默认显示周边1000米内的poi),并返回sematic_description语义化数据。

0string
extensions_road当取值为true时,召回坐标周围最近的3条道路数据。false、truestringfalse
extensions_town当取值为true时,行政区划返回乡镇级数据(town),仅国内召回乡镇数据。当取值为false时,行政区划不返回乡镇级数据(town)true、falsestringtrue
radius

以下内容需要 extensions_poi=1时才生效;
poi召回半径,允许设置区间为0-1000米,超过1000米按1000米召回。

500int1000
sn

若用户所用ak的校验方式为sn校验时该参数必须sn生成

string
output输出格式为json或者xmljson或xmlstringxml
callback将json格式的返回值通过callback函数返回以实现jsonp功能callback=showLocation(JavaScript函数名)string
poi_types

以下内容需要 extensions_poi=1时才生效;
可以选择poi类型召回不同类型的poi,例如poi_types=酒店,如想召回多个POI类型数据,可以‘|’分割
例如poi_types=酒店|房地产 不添加该参数则默认召回全部POI分类数据。poi分类

poi_types=酒店
poi_types=酒店|房地产

string
language

指定召回的行政区划语言类型。 召回行政区划语言list(全量支持的语言见示例)。 当language=local时,根据请求中坐标所对应国家的母语类型,自动选择对应语言类型的行政区划召回。
目前支持多语言的行政区划区划包含country、province、city、district

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 localstringen,国内默认zh-CN
language_auto

当用户指定language参数时,是否自动填充行政区划。
1填充,0不填充。
填充:当服务按某种语言类别召回时,若某一行政区划层级的语言数据未覆盖,则按照“英文→中文→本地语言”类别行政区划数据对该层级行政区划进行填充,保证行政区划数据召回完整性。

0、1int
返回参数
返回参数类型备注
statusint本次API访问状态,如果成功返回0,如果失败返回其他数字。(见服务状态码
resultobject返回的结果
locationobject经纬度坐标
lngfloat经度值
latfloat纬度值
formatted_address_poistring结构化地址(包含POI信息)。需设置extensions_poi=1才能返回。如果需要详细的地址描述,推荐使用这个参数。
formatted_addressstring结构化地址(不包含POI信息)。如果需要标准的结构化地址,比如获取XX路XX号,推荐使用这个参数
edzobject所属开发区
namestring开发区/工业区等非行政区划区域名称
businessstring坐标所在商圈信息,如 "人民大学,中关村,苏州街"。最多返回3个。
addressComponentobject注意,国外行政区划,字段仅代表层级
countrystring国家
country_codeint国家编码
country_code_isostring国家英文缩写(三位)
country_code_iso2string国家英文缩写(两位)
provincestring省名
citystring城市名
city_levelint城市所在级别(仅国外有参考意义。国外行政区划与中国有差异,城市对应的层级不一定为『city』。country、province、city、district、town分别对应0-4级,若city_level=3,则district层级为该国家的city层级)
districtstring区县名
townstring乡镇名,需设置extensions_town=true时才会返回
town_codestring乡镇id
streetstring道路名
street_numberstring道路门牌号
adcodeint行政区划代码,前往下载
directionstring相对当前坐标点的方向,当有门牌号的时候返回数据
distancestring相对当前坐标点的距离,当有门牌号的时候返回数据
pois周边poi数组
addrstring地址信息
cpstring数据来源(已废弃)
directionstring和当前坐标点的方向
distanceint离坐标点距离
namestringpoi名称
tagstringpoi类型,如’美食;中餐厅’。tag与poiType字段均为poi类型,建议使用tag字段,信息更详细。poi详细类别
pointfloatpoi坐标{x,y}
telint电话
uidstringpoi唯一标识
zipint邮编
parent_poiobjectpoi对应的主点poi(如,海底捞的主点为上地华联,该字段则为上地华联的poi信息。如无,该字段为空),包含子字段和pois基础召回字段相同。
roadsarray
namestring周边道路名称
distancestring传入的坐标点距离道路的大概距离
poiRegions
direction_descstring请求中的坐标与所归属区域面的相对位置关系
namestring归属区域面名称
tagstring归属区域面类型
distancestring离坐标点距离
uidstringpoi唯一标识
sematic_descriptionstring当前位置结合POI的语义化结果描述。需设置extensions_poi=1才能返回。
cityCodeint百度定义的城市id(正常更新与维护,但建议使用adcode)
示例代码
填写您的AK

输入AK可生成包含IP/SN校验方式的代码

<?php
// 此处填写你在控制台-应用管理-创建应用后获取的AK
$ak = '您的AK';
// 发起一个http get请求,并返回请求的结果
// $url字段为请求的地址
// $param字段为请求的参数
function request_get($url = '', $param = array()) {
if (empty($url) || empty($param)) {
return false;
}
$getUrl = $url . "?" . http_build_query($param);
$curl = curl_init(); // 初始化curl
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); // 跳过证书检查
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 2); // 从证书中检查SSL加密算法是否存在
curl_setopt($curl, CURLOPT_URL, $getUrl); // 抓取指定网页
curl_setopt($curl, CURLOPT_TIMEOUT, 1000); // 设置超时时间1秒
curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); // curl不直接输出到屏幕
curl_setopt($curl, CURLOPT_HEADER, 0); // 设置header
$data = curl_exec($curl); // 运行curl
if (!$data) {
print("an error occured in function request_get(): " . curl_error($curl) . "\n");
}
curl_close($curl);
return $data;
}
// 请求地址
$url = 'https://api.map.baidu.com/reverse_geocoding/v3';
// 构造请求参数
$param['ak'] = $ak;
$param['output'] = 'json';
$param['coordtype'] = 'wgs84ll';
$param['extensions_poi'] = '0';
$param['location'] = '31.225696563611,121.49884033194';
$res = request_get($url, $param);
// 将原始返回的结果打印出来
print("请求的原始返回结果为:\n");
print($res . "\n");
?>
{
"status": 0,
"result": {
"location": {
"lng": 121.50989077799083,
"lat": 31.22932842411674
},
"formatted_address": "上海市黄浦区中山南路187",
"edz": {
"name": ""
},
"business": "外滩,陆家嘴,董家渡",
"addressComponent": {
"country": "中国",
"country_code": 0,
"country_code_iso": "CHN",
"country_code_iso2": "CN",
"province": "上海市",
"city": "上海市",
"city_level": 2,
"district": "黄浦区",
"town": "小东门街道",
"town_code": "310101017",
"distance": "91",
"direction": "东北",
"adcode": "310101",
"street": "中山南路",
"street_number": "187"
},
"pois": [],
"roads": [],
"poiRegions": [],
"sematic_description": "",
"formatted_address_poi": "",
"cityCode": 289
}
}
在线运行
参数备注必选
location
根据经纬度坐标获取地址。
coordtype
坐标的类型,目前支持的坐标类型包括:bd09ll(百度经纬度坐标)、bd09mc(百度米制坐标)、gcj02(国测局经纬度坐标,仅限中国)、wgs84( GPS经纬度)坐标系说明
output
输出格式为json或者xml
extensions_poi
extensions_poi=0,不召回pois数据。
extensions_poi=1,返回pois数据(默认显示周边1000米内的poi),并返回sematic_description语义化数据和formatted_address_poi 结构化地址(包含POI信息)
服务状态码
返回码定义常见原因
0正常服务请求正常召回
1服务器内部错误该服务响应超时或系统内部错误,请留下联系方式
2参数错误坐标类型错误,location格式错误
10上传内容超过8MPost上传数据不能超过8M
101AK参数不存在请求消息没有携带AK参数
102MCODE参数不存在,mobile类型mcode参数必需对于Mobile类型的应用请求需要携带mcode参数,该错误码代表服务器没有解析到mcode
200APP不存在,AK有误请检查再重试根据请求的AK,找不到对应的APP
201APP被用户自己禁用,请在控制台解禁
202APP被管理员删除恶意APP被管理员删除
203APP类型错误当前API控制台支持Server(类型1), Mobile(类型2, 新版控制台区分为Mobile_Android(类型21)及Mobile_IPhone(类型22))及Browser(类型3),除此之外其他类型认为是APP类型错误
210APP IP校验失败在申请SERVER类型应用的时候选择IP校验,需要填写IP白名单,如果当前请求的IP地址不在IP白名单或者不是0.0.0.0/0就认为IP校验失败
211APP SN校验失败SERVER类型APP有两种校验方式IP校验和SN校验,当用户请求的SN和服务端计算出来的SN不相等的时候提示SN校验失败
220APP Referer校验失败浏览器类型的APP会校验referer字段是否存且切在referer白名单里面,否则返回该错误码
230APP Mcode码校验失败服务器能解析到mcode,但和数据库中不一致,请携带正确的mcode
240APP 服务被禁用用户在API控制台中创建或设置某APP的时候禁用了某项服务,若需开通权限,可进入API控制台为AK勾选对应服务
250用户不存在根据请求的user_id, 数据库中找不到该用户的信息,请携带正确的user_id
251用户被自己删除该用户处于未激活状态
252用户被管理员删除恶意用户被加入黑名单
260服务不存在服务器解析不到用户请求的服务名称
261服务被禁用该服务已下线,请在控制台确认是否有该服务的权限。
302天配额超限,限制访问配额超限,如果想增加配额请联系我们
401当前并发量已经超过约定并发配额,限制访问并发控制超限,请控制并发量或联系我们

上一篇

使用准备

下一篇

更新日志

本篇文章对您是否有帮助?