address

待解析的地址。最多支持128个字节。

可以输入两种样式的值，分别是：

1、标准的结构化地址信息，如北京市海淀区上地十街十号【推荐，地址结构越完整，解析精度越高】

2、支持“*路与*路交叉口”描述方式，如北一环路和阜阳路的交叉路口

第二种方式并不总是有返回结果，只有当地址库中存在该地址描述时才有返回。

北京市海淀区上地十街10号

string

无

是

ak

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

无

string

是

city

地址所在的城市名。用于指定上述地址所在的城市，当多个城市都有上述地址时，该参数起到过滤作用，但不限制坐标召回城市。

北京市

string

无

否

ret_coordtype

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

gcj02ll（国测局坐标）、bd09mc（百度墨卡托坐标）

string

bd09ll（百度经纬度坐标）

否

sn

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

无

string

否

output

输出格式为json或者xml

json或xml

string

xml

否

callback

将json格式的返回值通过callback函数返回以实现jsonp功能

callback=showLocation(JavaScript函数名)

string

无

否

extension_analys_level

是否触发解析到最小地址结构功能

extension_analys_level=1或true时，触发analys_level;字段返回参数；

extension_analys_level=0或false时；

analys_level字段不返回参数；

string

0

否

extension_poi_infos

是否返回经纬度所在的地址信息

true / false

string

false

否

status

int

本次API访问状态，如果成功返回0，如果失败返回其他数字。（见服务状态码）

count

int

解析结果的数量（当extension_poi_infos=true时返回）

result

object

返回的结果（策略首推的结果，对应poi_infos的第一个结果）

object

经纬度坐标

lng

float

经度值

lat

float

纬度值

int

位置的附加信息，是否精确查找。1为精确查找，即准确打点；0为不精确，即模糊打点。

int

描述打点绝对精度（即坐标点的误差范围）。

confidence=100，解析误差绝对精度小于20m；

confidence≥90，解析误差绝对精度小于50m；

confidence≥80，解析误差绝对精度小于100m；

confidence≥75，解析误差绝对精度小于200m；

confidence≥70，解析误差绝对精度小于300m；

confidence≥60，解析误差绝对精度小于500m；

confidence≥50，解析误差绝对精度小于1000m；

confidence≥40，解析误差绝对精度小于2000m；

confidence≥30，解析误差绝对精度小于5000m；

confidence≥25，解析误差绝对精度小于8000m；

confidence≥20，解析误差绝对精度小于10000m；

int

描述地址理解程度。分值范围0-100，分值越大，服务对地址理解程度越高（建议以该字段作为解析结果判断标准）；

当comprehension值为以下值时，对应的准确率如下：

comprehension=100，解析误差100m内概率为91%，误差500m内概率为96%；

comprehension≥90，解析误差100m内概率为89%，误差500m内概率为96%；

comprehension≥80，解析误差100m内概率为88%，误差500m内概率为95%；

comprehension≥70，解析误差100m内概率为84%，误差500m内概率为93%；

comprehension≥60，解析误差100m内概率为81%，误差500m内概率为91%；

comprehension≥50，解析误差100m内概率为79%，误差500m内概率为90%；

解析误差：地理编码服务解析地址得到的坐标位置，与地址对应的真实位置间的距离。

string

可以打点到地址文本中的真实地址结构，

例如问题地址：北京市海淀区北京路百度大厦，level："道路"

能精确理解的地址类型，包含：UNKNOWN、国家、省、城市、区县、乡镇、村庄、道路、地产小区、商务大厦、政府机构、交叉路口、商圈、生活服务、休闲娱乐、餐饮、宾馆、购物、金融、教育、医疗 、工业园区 、旅游景点 、汽车服务、火车站、长途汽车站、桥 、停车场/停车区、港口/码头、收费区/收费站、飞机场 、机场 、收费处/收费站 、加油站、绿地、门址

string

可以解析地址文本中的最小地址结构，

例如问题地址：北京市海淀区北京路百度大厦，analys_level："POI"，

能精确理解的地址类型包含: 省 市 区县 乡镇 道路 门址 POI 。

poi_infos

object

解析结果信息列表（当extension_poi_infos=true时返回；第一个结果为对result里经纬度的解析）

string

poi 名字

（当经纬度为某poi时，该字段返回poi的名字；反之，该字段可能为空）

string

poi唯一标识

string

国家

string

省份

string

城市

string

区县

string

乡镇

string

乡镇代码

string

街道

string

街道代码

int

行政区划代码

object

坐标

lng

float

经度值

lat

float

纬度值

string

可以打点到地址文本中的真实地址结构，

例如问题地址：北京市海淀区北京路百度大厦，level："道路"

能精确理解的地址类型，包含：UNKNOWN、国家、省、城市、区县、乡镇、村庄、道路、地产小区、商务大厦、政府机构、交叉路口、商圈、生活服务、休闲娱乐、餐饮、宾馆、购物、金融、教育、医疗 、工业园区 、旅游景点 、汽车服务、火车站、长途汽车站、桥 、停车场/停车区、港口/码头、收费区/收费站、飞机场 、机场 、收费处/收费站 、加油站、绿地、门址

string

可以解析地址文本中的最小地址结构

string

结构化地址（不包含POI信息）

int

位置的附加信息，是否精确查找。1为精确查找，即准确打点；0为不精确，即模糊打点

int

描述打点绝对精度（即坐标点的误差范围）。

confidence=100，解析误差绝对精度小于20m；

confidence≥90，解析误差绝对精度小于50m；

confidence≥80，解析误差绝对精度小于100m；

confidence≥75，解析误差绝对精度小于200m；

confidence≥70，解析误差绝对精度小于300m；

confidence≥60，解析误差绝对精度小于500m；

confidence≥50，解析误差绝对精度小于1000m；

confidence≥40，解析误差绝对精度小于2000m；

confidence≥30，解析误差绝对精度小于5000m；

confidence≥25，解析误差绝对精度小于8000m；

confidence≥20，解析误差绝对精度小于10000m；

int

描述地址理解程度。分值范围0-100，分值越大，服务对地址理解程度越高（建议以该字段作为解析结果判断标准）；

当comprehension值为以下值时，对应的准确率如下：

comprehension=100，解析误差100m内概率为91%，误差500m内概率为96%；

comprehension≥90，解析误差100m内概率为89%，误差500m内概率为96%；

comprehension≥80，解析误差100m内概率为88%，误差500m内概率为95%；

comprehension≥70，解析误差100m内概率为84%，误差500m内概率为93%；

comprehension≥60，解析误差100m内概率为81%，误差500m内概率为91%；

comprehension≥50，解析误差100m内概率为79%，误差500m内概率为90%；

解析误差：地理编码服务解析地址得到的坐标位置，与地址对应的真实位置间的距离

0

正常状态

服务请求正常召回

1

服务器内部错误

2

请求参数非法

必要参数拼写错误或漏传（如query和tag请求中均未传入）

3

权限校验失败

服务请求正常召回

4

配额校验失败

服务当日调用次数已超限，请前往API控制台提升（请优先进行开发者认证）

5

ak不存在或者非法

未传入ak参数；ak已被删除（可前往回收站恢复）

101

AK参数不存在

请求消息没有携带AK参数

102

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

240

APP 服务被禁用

用户在API控制台中创建或设置某APP的时候禁用了某项服务，若需开通权限，可进入API控制台为AK勾选对应服务

2xx

无权限

3xx

配额错误