全部服务产品
开发者频道
服务升级
登录
地址解析聚合
下载开发文档
API服务地址

https://api.map.baidu.com/address_analyzer/v1?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上
poi_scoreint75POI聚合精度,取值范围“0-100”,数值越大,精度越高(但召回会降低)75(默认值)、100、90该字段取值较高时,仅在服务认为聚合精度较高的前提下
confidenceint30对应召回字段中的confidence,取值100-0,建议取值30。当配置值(confidence)高于置信度返回值(address_confidence)时,会触发补充解析策略,以提高结果精度。30经评测,在保证准确率提升效果的前提下,取值=30,服务平响增长相对较小。也可根据业务数据评测,决定取值。
modelint0是否使用标准化模式

model=0 不使用
model=1 使用

返回name、tel字段。

注:使用该参数会影响接口整体耗时

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

ret_coordtype=bd09ll
ret_coordtype=bd09mc
ret_coordtype=gcj02
ret_coordtype=wgs84

addr_verifyint0

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

addr_verify=0 不使用
addr_verify=1 使用

返回 problem、facticity 字段

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

addr_unifyint0

是否返回地址归一结果
多源地址归一

addr_unify=0不使用
addr_unify=1使用

返回address_unify_id

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

show_buildingint0是否展示门址信息

show_building=0不使用
show_building=1使用

开启切词数据展示功能,将以照原始地址文本为基准,返回切词后的village、origin_poi、building字段:
village:文本中所体现第五级行政区划村级数据
origin_poi:文本中所体现的POI数据
building:文本中所体现的详细的门牌号数据
请注意,当开启高级服务参数show_zoning=1时,返回标准五级区划的village;

注:使用该参数会影响接口整体耗时。

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_format_address_detailint0是否在format_address中显示门牌号信息

show_format_address_detail=0 不显示门牌号信息
show_format_address_detail=1 显示门牌号信息

请注意,由于门牌号信息依赖于show_building控制返回。需同时设置show_building=1和show_format_address_detail=1才能在format_address中显示门牌号信息。

注:使用该参数会影响接口整体耗时

akstring用户服务访问密钥

cO3seSdqC*********
ObPGvXNcwcW04

返回参数
参数名字段类型字段含义示例备注
statusint请求结果状态码0本次API访问状态,如果成功返回0,如果失败返回其他数字。(见服务状态码
addressstring请求中的地址文本数据北京市海淀区信息路甲九号
result
provincestring北京市
province_codestring省编码110000省对应区划代码
citystring市辖区
city_codestring市编码110100市对应区划代码
countystring区县海淀区
county_codestring区县编码110108区县对应区划代码
townstring街道、乡镇上地街道
town_codestring街道、乡镇编码110108022街道、乡镇对应区划代码
villagestring社区、村上地科技园社区居委会show_building=1返回文本中所体现第五级行政区划村级数据。
show_zoning=1返回解析后的第五级行政区划数据。
show_building和show_zoning参数共同使用时,返回解析后的第五级行政区划数据。
village_codestring社区、村编码110108022014show_zoning=1返回,社区、村对应区划代码。
注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系
urban_rural_codeint城乡分类编码111urban_rural_code = 1时返回
注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系
edzstring开发区所属开发区名称,需配合show_edz=1使用。官方数据标准
origin_poistring请求文本地址中的poi名称show_building=1时返回
buildingstring请求文本地址中的楼栋门牌号show_building = 1时返回
请注意:当原始文本中存在多组楼栋门牌号信息时,则按照原始文本地址中的相对顺序全部写在此字段中。
roadstring道路信息路
road_codestring道路编码004014ba01afe8b63a221c4e
sectionstring路段信息路(上地六街到上地五街)一条道路包含多个路段。括号内为该路段的语义化描述。
section_codestring路段编码ebc13ff6a4ddcd370b1cc7ca
poistring聚合后的兴趣点poi名称奎科科技大厦聚合后的兴趣点poi,指解析结果中距离坐标最近或热度最高的poi信息,但不一定是请求地址中的poi信息。output_tag、poi_score参数会影响该结果返回。
poi_codestring聚合后的兴趣点poi编码1a30c5f8cbb55eff71210b02
namestring请求文本地址中的人名mode=1时返回
telstring请求文本地址中的电话mode=1时返回
problemstring输入地址不合规提示"|行政区划冲突: 冲突A---冲突B"
"|行政区划冗余: 冗余A---冗余B"
"|省级地址结构缺失"
"|省级行政区划错误"
"|城市级地址结构缺失"
"|城市级行政区划错误"
"|区县级地址结构缺失"
"|区县级行政区划错误"
"|乡镇级地址结构缺失"
异常地址识别能力,addr_verify=1时返回;
请求地址中行政区划冲突、冗余、错误、缺失信息提示
注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系
facticityint地址得分100addr_verify=1时返回;
异常地址识别评分,按照不合规信息,给地址文本打分;
注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系
address_unify_idstring归一idE6880F547A42C91137F75EB864B6719Faddr_unify=1时返回
注:该功能为高级付费服务,用户不能直接在官网付费入口中直接购买,如有采买需求,请反馈平台联系我们,将有商务与您取得联系
detail
poi_xyList<double>能够聚合到的最近或热度最高的兴趣点坐标[经度,纬度][116.3127950393378,40.04773119283188]只有聚合到最近兴趣点时,才会召回字段。output_tag、poi_score参数会影响该结果返回
poi_tagstring能够聚合到的最近或热度最高的兴趣点类别poi类型分类明细房地产;写字楼只有解析到兴趣点数据时(即返回结果result下的poi字段)不为空,才会召回该字段。output_tag、poi_score参数会影响该结果返回
aoi_idstring聚合后所属的区域面id1a30c5f8cbb55eff71210b02只有解析到区域面数据时,才会召回该字段。aoi_radius参数会影响该结果返回。
aoi_namestring聚合后所属的区域面名称奎科科技大厦只有解析到区域面数据时,才会召回该字段。aoi_radius参数会影响该结果返回。
aoi_tagstring聚合后所属区域面类型,poi类型分类明细房地产;写字楼只有解析到区域面数据时,才会召回该字段。aoi_radius参数会影响该结果返回。
address_preciseint是否精确解析地址11为精确查找,即准确打点;0 为不精确,即模糊打点。如果请求文本质量不佳此字段只作为参考。
address_confidenceint描述地址解析打点绝对精度(即 address_xy 坐标点的误差范围)。80confidence=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;
如果请求文本质量不佳此字段只作为参考。
address_comprehensionint描述地址理解程度。分值范围0-100,分值越大,服务对地址理解程度越高100解析地址得到的坐标位置,与地址对应的真实位置间的距离。
address_levelstring能精确理解的地址类型门址包含:UNKNOWN、国家、省、城市、区县、乡镇、村庄、道路、地产小区、商务大厦、政府机构、交叉路口、商圈、生活服务、休闲娱乐、餐饮、宾馆、购物、金融、教育、医疗 、工业园区 、旅游景点 、汽车服务、火车站、长途汽车站、桥 、停车场/停车区、港口/码头、收费区/收费站、飞机场 、机场 、收费处/收费站 、加油站、绿地、门址
address_poistring地址中原始兴趣点名称奎科科技大厦address_poi定义为以该文本地址中解析到的poi信息。如果为空说明该点未记录或有多个。可以取detail下的aoi_name或result下的poi字段
address_xyList<double>解析到的地址坐标[116.31343400404705,40.04770109108722]根据文本地址解析到的坐标。
address_detailstring地址文本提取主体、联系方式、行政区划后剩余的详情信息信息路甲九号mode=1时返回
format_addressstring结构化地址信息北京市市辖区海淀区上地街道信息路由省province+市city+区县county+乡镇town+路road+poiaddress_poi+楼栋门牌号building拼接而成
注意:其中拼接信息中的楼栋门牌号building由show_format_address_detail字段控制生成
如您需要异常地址识别服务,请点击异常地址识别服务
示例代码
填写您的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/address_analyzer/v1';
// 构造请求参数
$param['address'] = '北京市海淀区信息路甲九号';
$param['ak'] = $ak;
$res = request_get($url, $param);
// 将原始返回的结果打印出来
print("请求的原始返回结果为:\n");
print($res . "\n");
?>
{
"status": 0,
"address": "北京市海淀区信息路甲九号",
"result": {
"province": "北京市",
"province_code": "110000",
"city": "北京市",
"city_code": "110100",
"county": "海淀区",
"county_code": "110108",
"town": "上地街道",
"town_code": "110108022",
"road": "信息路",
"road_code": "004014ba01afe8b63a221c4e",
"section": "信息路(上地六街到上地五街)",
"section_code": "ebc13ff6a4ddcd370b1cc7ca",
"poi": "奎科科技大厦",
"poi_code": "1a30c5f8cbb55eff71210b02"
},
"detail": {
"poi_xy": [
12948022.0,
4845130.0
],
"poi_tag": "房地产;写字楼",
"aoi_id": "1a30c5f8cbb55eff71210b02",
"aoi_name": "奎科科技大厦",
"aoi_tag": "房地产;写字楼",
"address_precise": 1,
"address_confidence": 80,
"address_comprehension": 100,
"address_level": "门址",
"address_poi": "",
"address_xy": [
12948093.13,
4845125.64
],
"format_address": "北京市北京市海淀区上地街道信息路"
}
}
在线运行
参数备注必选
address
北京市海淀区信息路甲九号
服务状态码
返回码英文描述定义常见原因
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服务被禁用该服务已下线,请在控制台确认是否有该服务的权限。

上一篇

使用准备

下一篇

地址归一

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