产品服务
解决方案
文档与支持
定价
登录
地址解析聚合
API服务地址

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

请求参数
字段名称字段类型默认值是否必填字段含义示例备注
addressstring需要解析的地址文本北京市海淀区信息路甲九号
output_tagstringall需聚合的POI分类、poi类型分类明细output_tag=all
output_tag=酒店
output_tag=酒店|房地产
多个类型请使用"|"分隔。当设置为"all"时,解析到的地址 poi
aoi_radiusint0聚合AOI单位外扩范围 (0-1000m)100若地址在AOI外扩范围内,同样会聚合到该AOI对应的POI上
ret_coordtypestringbd09mc召回坐标的类型bd09ll(百度经纬度坐标系)、bd09mc(百度墨卡托米制坐标)、gcj02(国测局坐标)ret_coordtype=bd09ll
ret_coordtype=bd09mc
ret_coordtype=gcj02
addr_verifyint0是否触发异常地址识别功能addr_verify=0 不使用
addr_verify=1 使用
返回 problem、facticity 字段
注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系
addr_unifyint0多源地址归一
是否返回地址归一结果
addr_unify=0不使用
addr_unify=1使用
返回address_unify_id
注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系
show_zoningint0五级地址
是否返回五级行政村的地址和编码;
show_zoning=0不使用
show_zoning=1使用
返回 village 和 village_code 字段。
注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系
注:使用该参数会影响接口整体耗时
urban_rural_codeint0城乡编码
是否返回城乡分类编码
urban_rural_code=0不使用
urban_rural_code=1使用
返回 urban_rural_code 字段
注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系
注:使用该参数会影响接口整体耗时
show_edzint0是否返回开发区show_edz=0不使用
show_edz=1使用
返回 edz 字段,此数据来自于官方数据标准
show_structuredint0地址文本切分
是否返回文本地址结构化切分。
show_structured=0 不使用
show_structured=1使用
show_structured=1 默认返回 name、tel、origin_village 、origin_poi 、building_number 、unit_number 、room_number ; 其他信息需要开通高级服务才会回返。
注 :其他字段信息为高级服务,如有需求,请反馈平台联系我们,将有商务与您取得联系;
force_adminInt0解析结果是否强制返回在地址输入的行政区划内force_admin=3 区县
force_admin=4 乡镇
默认为 0,表示无强制区划层次需求。3-4 表示强制返回对应区县、乡镇级区划的结果。若解析数据中无输入层级的区划时,则返回输入区划的政府 poi 及坐标。
akstring用户服务访问密钥cO3seSdqC*********
ObPGvXNcwcW04
返回参数
参数名字段类型字段含义示例备注
statusint请求结果状态码0本次API访问状态,如果成功返回0,如果失败返回其他数字。(见服务状态码
addressstring请求中的地址文本数据北京市海淀区信息路甲九号
result
format_addressstring结构化地址信息北京市市辖区海淀区上地街道信息路依据解析到的poi中的省province+市city+区县county+乡镇town+路road+poiaddress_poi+楼栋号+门牌号(输入的门牌号building_number+unit_number+room_number拼接而成)
address_location解析到的经纬度信息根据文本地址解析到的坐标。
lngdouble经度116.31343400404705
latdouble维度40.04770109108722
detail地址解析、纠偏补全结果
admin
provincestring北京市
province_codestring省编码110000省对应区划代码
citystring市辖区
city_codestring市编码110100市对应区划代码
countystring区县海淀区
county_codestring区县编码110108区县对应区划代码
townstring街道、乡镇上地街道
town_codestring街道、乡镇编码110108022街道、乡镇对应区划代码
villagestring居委会、村上地科技园社区居委会show_zoning = 1时返回
注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系
village_codestring社区、村编码110108022014
urban_rural_codeint城乡分类编码111urban_rural_code = 1时返回
注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系
admin_typestring城乡分类类型城镇,城区,主城区,城乡结合区,镇中心区,镇乡结合区,特殊区域,乡中心区,村庄
edzstring开发区所属开发区名称,需配合show_edz=1使用。官方数据标准
poi
poi_namestring解析到的poi名称奎科科技大厦解析到的poi名称
poi_addressstring解析到的poi地址解析到的poi地址
poi_xy解析到的poi坐标
lngdouble经度116.3127950393378
latdouble维度40.04773119283188
poi_tagstring房地产;写字楼解析到的poi类型
road_info
roadstring道路信息路
road_codestring道路编码1505378891
sectionstring路段信息路(上地六街到上地五街)一条道路包含多个路段。括号内为该路段的语义化描述。
section_codestring路段编码1520321854_1520321885
aoi
aoi_idstring聚合后所属的区域面id1a30c5f8cbb55eff71210b02只有解析到区域面数据时,才会召回该字段
aoi_namestring聚合后所属的区域面名称奎科科技大厦
aoi_tagstring聚合后所属区域面类型,poi类型分类明细房地产;写字楼
other
address_preciseint是否精确解析地址11为精确查找,即准确打点;0 为不精确,即模糊打点。
address_levelstring能精确理解的地址类型poi类型分类明细
struct_info地址文本切分结果
show_structured=1时,默认返回name、tel、origin_village、origin_poi、building_number、unit_number、room_number;
注:其他字段信息为高级服务,如有需求,请反馈平台联系我们,将有商务与您取得联系;
nameString地址文本中提取出的主体信息,多个结果用英文逗号','隔开王先生
telString地址文本中提取出的联系方式,多个结果用英文逗号","隔开18180000001
origin_provinceString地址文本中提取出的省,多个结果用英文逗号","隔开
origin_cityString地址文本中提取出的市,多个结果用英文逗号","隔开
origin_districtString地址文本中提取出的区县,多个结果用英文逗号","隔开
origin_townString地址文本中提取出的乡镇/街道,多个结果用英文逗号","隔开
origin_villageString地址文本中提取出的村/社区,多个结果用英文逗号","隔开
origin_poiString地址文本中提取出的poi,多个结果用英文逗号","隔开创新家园
origin_roadString地址文本中提取出的路名,多个结果用英文逗号","隔开信息路
origin_road_noString地址文本中提取出的编号,多个结果用英文逗号","隔开甲九号
building_numberString地址文本中提取出的楼栋,多个结果用英文逗号","隔开8栋
unit_numberString地址文本中提取出的单元号,多个结果用英文逗号","隔开1单元
room_numberString地址文本中提取出的楼层号加房间号,多个结果用英文逗号","隔开302室
address_unify地址归一结果,addr_unify=1时返回
注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系
address_unify_idString归一id695585928D3A3AA6DF5CB96E6227C704
addr_verify异常地址识别结果,addr_verify=1返回
注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系
problemstring地址核验结果描述,包括:
"行政区划冗余"
"行政区划冲突"
"省级地址结构缺失"
"城市级地址结构缺失"
"区县级地址结构缺失"
"乡镇级地址结构缺失"
"详细地址缺失或不存在"
"省级行政区划错误"
"城市级行政区划错误"
"区县级行政区划错误"
"乡镇级行政区划错误"
"地址缺失过多"
"缺少道路"
"请核对道路信息"
"缺少门牌号"
"缺少门址信息"
"请核对门址信息"
"请核对 POI 名称"
"缺少 POI 信息"
行政区划冲突
facticityint按照不合规信息,给地址文本打分。分数越高说明地址的完整度越高。85
如您需要异常地址识别服务,请点击异常地址识别服务
服务状态码
返回码英文描述定义常见原因
0ok成功
-1ERROR: address is empty字段address不能为空
ERROR: location is invalid坐标异常
ERROR: unkonwn error未知错误异常
-2ERROR: Invalid output_tag字段output_tag无效
101AK参数不存在请求消息没有携带AK参数
102不通过白名单或者安全码不对
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服务被禁用该服务已下线,请在控制台确认是否有该服务的权限。

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

上一篇

使用准备

下一篇

地址归一

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