AI
产品服务
解决方案
文档与支持
定价
更新时间: 2026/03/25 12:01
地址解析聚合
API服务地址

https://api.map.baidu.com/address_analyzer/v2?address=北京市海淀区信息路甲九号&ak=您的ak
//GET请求

请求参数
字段名称字段类型默认值是否必填字段含义示例备注

address

string

需要解析的地址文本

北京市海淀区信息路甲九号

output_tag

string

all

需聚合的POI分类、poi类型分类明细

output_tag=all

output_tag=酒店

output_tag=酒店|房地产

多个类型请使用"|"分隔。当设置为"all"时,解析到的地址 poi

aoi_radius

int

0

聚合AOI单位外扩范围 (0-1000m)

100

若地址在AOI外扩范围内,同样会聚合到该AOI对应的POI上

ret_coordtype

string

bd09mc

召回坐标的类型bd09ll(百度经纬度坐标系)、bd09mc(百度墨卡托米制坐标)、gcj02(国测局坐标)

ret_coordtype=bd09ll

ret_coordtype=bd09mc

ret_coordtype=gcj02

addr_verify

int

0

是否触发异常地址识别功能

addr_verify=0 不使用

addr_verify=1 使用

返回 problem、facticity 字段注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系

addr_unify

int

0

多源地址归一

是否返回地址归一结果

addr_unify=0不使用

addr_unify=1使用

返回address_unify_id注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系

show_zoning

int

0

五级地址

是否返回五级行政村的地址和编码;

show_zoning=0不使用

show_zoning=1使用

返回 village 和 village_code 字段。注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系注:使用该参数会影响接口整体耗时

urban_rural_code

int

0

城乡编码

是否返回城乡分类编码

urban_rural_code=0不使用

urban_rural_code=1使用

返回 urban_rural_code 字段注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系注:使用该参数会影响接口整体耗时

show_edz

int

0

是否返回开发区

show_edz=0不使用

show_edz=1使用

返回 edz 字段,此数据来自于官方数据标准

show_structured

int

0

地址文本切分

是否对输入地址进行文本结构化切分

show_structured=0 不使用

show_structured=1使用

show_structured=1 默认返回 name、tel、origin_village 、origin_poi 、building_number 、unit_number 、room_number、address_detail ; 其他信息需要开通高级服务才会回返。注 :其他字段信息为高级服务,如有需求,请反馈平台联系我们,将有商务与您取得联系;

force_admin

Int

0

解析结果是否强制返回在地址输入的行政区划内

force_admin=3 区县

force_admin=4 乡镇

默认为 0,表示无强制区划层次需求。3-4 表示强制返回对应区县、乡镇级区划的结果。若解析数据中无输入层级的区划时,则返回输入区划的政府 poi 及坐标。

ak

string

用户服务访问密钥

cO3seSdqC*********

ObPGvXNcwcW04

返回参数
参数名字段类型字段含义示例备注

status

int

请求结果状态码

0

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

address

string

请求中的地址文本数据

北京市海淀区信息路甲九号

result

format_address

string

结构化地址信息

北京市市辖区海淀区上地街道信息路

依据解析到的poi中的省province+市city+区县county+乡镇town+路road+poiaddress_poi+楼栋号+门牌号(输入的门牌号building_number+unit_number+room_number拼接而成)

address_location

解析到的经纬度信息

根据文本地址解析到的坐标。

lng

double

经度

116.31343400404705

lat

double

维度

40.04770109108722

detail

地址解析、纠偏补全结果

admin

province

string

北京市

province_code

string

省编码

110000

省对应区划代码

city

string

市辖区

city_code

string

市编码

110100

市对应区划代码

county

string

区县

海淀区

county_code

string

区县编码

110108

区县对应区划代码

town

string

街道、乡镇

上地街道

town_code

string

街道、乡镇编码

110108022

街道、乡镇对应区划代码

village

string

居委会、村

上地科技园社区居委会

show_zoning = 1时返回注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系

village_code

string

社区、村编码

110108022014

urban_rural_code

int

城乡分类编码

111

urban_rural_code = 1时返回注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系

admin_type

string

城乡分类类型

城镇,城区,主城区,城乡结合区,镇中心区,镇乡结合区,特殊区域,乡中心区,村庄

edz

string

开发区

所属开发区名称,需配合show_edz=1使用。官方数据标准

poi

poi_name

string

解析到的poi名称

奎科科技大厦

解析到的poi名称

poi_address

string

解析到的poi地址

解析到的poi地址

poi_xy

解析到的poi坐标

lng

double

经度

116.3127950393378

lat

double

维度

40.04773119283188

poi_tag

string

房地产;写字楼

解析到的poi类型

road_info

road

string

道路

信息路

road_code

string

道路编码

1505378891

section

string

路段

信息路(上地六街到上地五街)

一条道路包含多个路段。括号内为该路段的语义化描述。

section_code

string

路段编码

1520321854_1520321885

aoi

aoi_id

string

聚合后所属的区域面id

1a30c5f8cbb55eff71210b02

只有解析到区域面数据时,才会召回该字段

aoi_name

string

聚合后所属的区域面名称

奎科科技大厦

aoi_tag

string

聚合后所属区域面类型,poi类型分类明细

房地产;写字楼

other

address_precise

int

是否精确解析地址

1

1为精确查找,即准确打点;0 为不精确,即模糊打点。

address_level

string

能精确理解的地址类型

poi类型分类明细

struct_info

地址文本切分结果

show_structured=1时,默认返回name、tel、origin_village、origin_poi、building_number、unit_number、room_number、address_detail;注:其他字段信息为高级服务,如有需求,请反馈平台联系我们,将有商务与您取得联系;

name

String

地址文本中提取出的主体信息,多个结果用英文逗号','隔开

王先生

tel

String

地址文本中提取出的联系方式,多个结果用英文逗号","隔开

18180000001

origin_province

String

地址文本中提取出的省,多个结果用英文逗号","隔开

origin_city

String

地址文本中提取出的市,多个结果用英文逗号","隔开

origin_district

String

地址文本中提取出的区县,多个结果用英文逗号","隔开

origin_town

String

地址文本中提取出的乡镇/街道,多个结果用英文逗号","隔开

origin_village

String

地址文本中提取出的村/社区,多个结果用英文逗号","隔开

origin_poi

String

地址文本中提取出的poi,多个结果用英文逗号","隔开

创新家园

origin_road

String

地址文本中提取出的路名,多个结果用英文逗号","隔开

信息路

origin_road_no

String

地址文本中提取出的编号,多个结果用英文逗号","隔开

甲九号

building_number

String

地址文本中提取出的楼栋,多个结果用英文逗号","隔开

8栋

unit_number

String

地址文本中提取出的单元号,多个结果用英文逗号","隔开

1单元

room_number

String

地址文本中提取出的楼层号加房间号,多个结果用英文逗号","隔开

302室

address_detail

String

地址文本提取主体、联系方式、行政区划后剩余的详情信息

信息路甲九号

address_unify

地址归一结果,addr_unify=1时返回

注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系

address_unify_id

String

归一id

695585928D3A3AA6DF5CB96E6227C704

addr_verify

异常地址识别结果,addr_verify=1返回注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系

problem

string

地址核验结果描述,包括:

"行政区划冗余"

"行政区划冲突"

"省级地址结构缺失"

"城市级地址结构缺失"

"区县级地址结构缺失"

"乡镇级地址结构缺失"

"详细地址缺失或不存在"

"省级行政区划错误"

"城市级行政区划错误"

"区县级行政区划错误"

"乡镇级行政区划错误"

"地址缺失过多"

"缺少道路"

"请核对道路信息"

"缺少门牌号"

"缺少门址信息"

"请核对门址信息"

"请核对 POI 名称"

"缺少 POI 信息"

行政区划冲突

facticity

int

按照不合规信息,给地址文本打分。分数越高说明地址的完整度越高。

85

如您需要异常地址识别服务,请点击异常地址识别服务
服务状态码
返回码英文描述定义常见原因

0

ok

正常

服务请求正常召回

1

服务器内部错误

该服务响应超时或系统内部错误,请留下联系方式

2

Parameter Invalid

请求参数非法

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

3

Verify Failure

权限校验失败

4

Quota Failure

配额校验失败

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

5

AK Failure

ak不存在或者非法

未传入ak参数;ak已被删除(可前往回收站恢复);

8

Parse Proto Failure

数据解析失败

一般是query输入有误导致,如query输入特殊字符,全角符号。

9

Permission Denied

高级权限校验失败

101

AK参数不存在

请求消息没有携带AK参数

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校验失败

240

APP 服务被禁用

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

250

用户不存在

根据请求的user_id, 数据库中找不到该用户的信息,请携带正确的user_id

251

用户被自己删除

该用户处于未激活状态

252

用户被管理员删除

恶意用户被加入黑名单

260

服务不存在

服务器解析不到用户请求的服务名称

261

服务被禁用

该服务已下线

302

天配额超限,限制访问

配额超限,如果想增加配额请联系我们

401

当前并发量已经超过约定并发配额,限制访问

并发控制超限,请控制并发量或联系我们

接口文档版本升级记录:切换到旧版(v1)

上一篇

使用准备

下一篇

地址归一

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