逆地理编码
GET
/reverse_geocoding/v3/
| 返回码 | 定义 | 常见原因 |
|---|---|---|
| 0 | 正常 | 服务请求正常召回 |
| 1 | 服务器内部错误 | 该服务响应超时或系统内部错误，请留下联系方式 |
| 2 | 参数错误 | 坐标类型错误，location格式错误 |
| 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 | 当前并发量已经超过约定并发配额，并且服务总并发量也已经超过设定的总并发配额，限制访问 | 并发控制超限，请控制并发量或联系我们 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://api.map.baidu.com/reverse_geocoding/v3/?location=31.225696563611,121.49884033194&ak=&sn='响应示例响应示例
{
"status": 0,
"location": {
"lat": 0,
"lng": 0
},
"formatted_address": "string",
"business": "string",
"addressComponent": {
"country": "string",
"country_code": 0,
"country_code_iso": "string",
"country_code_iso2": "string",
"province": "string",
"city": "string",
"city_level": 0,
"district": "string",
"town": "string",
"town_code": "string",
"street": "string",
"street_number": "string",
"adcode": 0,
"direction": "string",
"distance": "string"
},
"pois": {
"addr": "string",
"cp": "string",
"direction": "string",
"distance": 0,
"name": "string",
"tag": "string",
"point": "string",
"tel": 0,
"uid": "string",
"zip": 0,
"parent_poi": "string"
},
"roads": {
"name": "string",
"distance": "string"
},
"poiRegions": {
"direction_desc": "string",
"name": "string",
"tag": "string"
},
"sematic_description": "string",
"cityCode": 0
}请求参数
Query 参数
location
number
必需
示例值:
31.225696563611,121.49884033194
coordtype
string
可选
示例值:
wgs84ll
ret_coordtype
string
可选
示例值:
gcj02ll（国测局坐标，仅限中国）
radius
integer
可选
示例值:
500
output
string
可选
示例值:
json
callback
string
可选
示例值:
callback=showLocation(JavaScript函数名)
poi_types
string
可选
示例值:
酒店
extensions_poi
string
可选
示例值:
0
extensions_road
string
可选
示例值:
false
extensions_town
string
可选
示例值:
true
language
string
可选
示例值:
en
language_auto
integer
可选
示例值:
0
ak
string
必需
默认值:
{{ak}}
sn
string
可选
默认值:
{{sn}}