根据国家发布的城乡标准，通过多源数据融合，利用智能挖掘算法对地址所在区域进行自动化精准匹配，从而高效、准确的判断地址所在区域的城乡类型。
本服务从行政区划和经济发展角度判断某一地址所在位置是城市、乡镇还是农村，为开发者输出城乡类别置信度分值，同时可提供地址所在区县、乡镇街道的类型。辅助金融、物流、生活服务等行业的开发者更好的理解地址类型，进行风险评估、个性化服务以及精细化运营。
银行业务风险识别：判断用户地址的真实性以及属于城市或农村， 辅助欺诈识别和判断。
潜在客户质量分析：根据客户所在地区，获取地区的置信等级，用于分析客户质量，助于业务更好的发展。
门店管理地址分类：用于终端门店城乡类别分类统计，便于对门店进行更加精细化的管理。
电商订单地址检测：根据订单地址，辅助企业计算统计订单的分布情况，方便后期广告投放维度
本服务属于高级权限，需付费开通，您可以联系我们开通15天试用并了解更多信息。
https://api.map.baidu.com/api_recog_address/v1/recog? //GET请求
https://api.map.baidu.com/api_recog_address/v1/recog?address=北京市海淀区信息路甲九号&ak=你的ak
注意：城乡类型判别是付费高级服务，您可以联系我们开通15天试用并了解更多信息。
| 参数名 | 数据类型 | 是否必传 | 默认值 | 参数含义 | 示例 |
|---|---|---|---|---|---|
| |
|
|
|
需要解析的地址 | 北京市海淀区上地十街10号百度大厦 |
| |
|
|
|
开发者密钥，可在API控制台申请获得 | CO3seS******ObPGW04 |
| |
|
|
|
判断地址address是否加密 默认是不加密 加密方式请通过反馈平台与我们联系 |
|
| |
|
|
|
是否返回特殊区域标识：true(返回) 、false(不返回) | true、false |
返回的结果中，从两个维度描述地址所属的城乡类别：
1、行政区划维度：根据国家行政区划标准，判断地址所属城乡类别，包括城市和农村两种类型。
2、经济统计维度：国家统计局会根据每个地区的经济发展程度，对城乡类别进行划分，包括城市、乡镇、农村三种类型。比如一个地区在行政区划上是农村，但随着经济的发展，已成为经济较发达地区，即会在经济统计维度被归类为城市。
开发者可以根据自身业务需要，选择采用行政区划还是经济统计维度对地址进行分类。
3、特殊区域标识：当前特殊区域包含机场和开发区两种类型。开发者可以根据自身业务需要，结合特殊区域返回类型进行业务判断。
| 参数名 | 含义 | 备注 | 示例 | |
|---|---|---|---|---|
| |
|
|
| |
| |
|
|
|
|
| |
|
|
北京市 | |
| |
|
|
海淀区 | |
| |
|
|
上地街道 | |
| |
|
|
|
区 |
| |
|
|
街道 | |
| |
|
|
城市 | |
| |
|
|
100.0 | |
| |
|
|
|
100.0 |
| |
|
100表示：城镇 110表示：城区 111表示：主城区 112表示：城乡结合区 |
111:80,112:10 | |
| |
|
0.0 – 100.0 | 0.0 | |
| |
|
120表示：镇区 121表示：镇中心区 122表示：镇乡结合区 123 表示：特殊区域 |
121:70，122：10 | |
| |
|
0.0 – 100.0 | 0.0 | |
| |
|
200表示：乡村 210表示：乡中心区 220表示：村庄 |
210：10，220：80 | |
| |
|
|
|
|
{
"status":0,
"admin_info":{
"province":"北京市",
"city":"北京市",
"county":"海淀区",
"town":"上地街道"
},
"admin_type":{
"county_type":"区",
"town_type":"街道",
"town_urban_rural":"城市",
"confidence":100
},
"stats_type":{
"urban":80,
"urban_list": "111:70,112:10",
"township":0,
"township_list": "",
"rural":20,
"rural_list": "220:20"
}
"airport_or_develop": "|机场|开发区"
}
API请求中需要用到中文或一些特殊字符的参数，如query、region等，为了避免提交到后台乱码，需要对这几个参数值进行编码处理，转换成UTF-8字符的二字符十六进制值，凡是不在下表中的字符都需要进行编码。
| 字符集合 | 字符 |
| URL非保留字 |
a b c d e f g h i j k l m n o p q r s t u v w x y z A B C D E F G H I J K L M N O P Q R S T U V W X Y Z 0 1 2 3 4 5 6 7 8 9 - _ . ~ |
| URL保留字 |
! * ' ( ) ; : @ & = + $ , / ? % # [ ] |
如果中文参数中使用URL保留字字符的字面意思，例如：region关键字取值为"?北京"，检索关键字包含一个问号，此问号也必须进行编码。
附注：
javascript中一般采用encodeURIComponent函数对特殊字符进行编码。
Java中可以使用函数URLEncoder.encode对特殊字符进行编码。
C#中可以使用函数HttpUtility.UrlEncode对特殊字符进行编码。
php中可以使用函数urlencode对特殊字符进行编码。
WGS84：为一种大地坐标系，也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。
GCJ02：是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。
BD09：为百度坐标系，在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标，bd09mc表示百度墨卡托米制坐标
注意：不同类型坐标如需转换，请使用百度地图开放平台提供的标准坐标转换接口。请勿使用其他渠道提供的坐标转换方法，以免影响坐标转换精度。
加密方式：AES对称加密算法CTR模式nopadding作为填充方式
约定密钥key 位数：128位 值：yUdu59C3By+kb0Gy
偏移量iv 位数：128位 值：YduF6jc6SeSopG+h
地址加密完之后请使用urlencode进行编码，之后再下发请求：
https://api.map.baidu.com/api_recog_address/v1/recog?address={加密base64编码再urlendcode后的值} &ak=你的ak& is_encry_adderss=1
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
| |
|
本服务属于高级权限，需付费开通，您可以联系我们开通15天试用并了解更多信息
服务相关配额及并发请求限制请访问开发者权益页面查看。
地址城乡类型判别服务与其他API服务一样，具有每天使用配额和并发次数的限制。使用前，您需要联系我们申请服务权限，权限开通后您将获取每天100次免费请求次数。如果您需要对服务进行大量测试，当前配额或并发不能满足业务使用需求，需联系我们申请做进一步提升，请详细填写日配额和并发预估计算方法，以便评估。
本服务为高级服务，如有采买需求，请提交工单联系我们，将有商务与您取得联系。
2020年9月16日
V1.0
2022年1月18日
V1.1
新增“ is_airport_or_develop ”请求参数，城乡判别服务可支持是否返回特殊区域标识。
新增“airport_or_develop”返回参数，可支持返回该地点属于特殊区域类型，当前特殊区域包含机场和开发区两种类型。
新增“urban_list”返回参数，可支持返回该地点在城市类别中所属的具体区域及其置信分。
新增“township_list”返回参数，可支持返回该地点在乡镇类别中所属的具体区域及其置信分。
新增“ rural_list ”返回参数，可支持返回该地点在农村类别中所属的具体区域及其置信分。