根据国家发布的城乡标准,通过多源数据融合,利用智能挖掘算法对地址所在区域进行自动化精准匹配,从而高效、准确的判断地址所在区域的城乡类型。
本服务从行政区划和经济发展角度判断某一地址所在位置是城市、乡镇还是农村,为开发者输出城乡类别置信度分值,同时可提供地址所在区县、乡镇街道的类型。辅助金融、物流、生活服务等行业的开发者更好的理解地址类型,进行风险评估、个性化服务以及精细化运营。
银行业务风险识别:判断用户地址的真实性以及属于城市或农村, 辅助欺诈识别和判断。
潜在客户质量分析:根据客户所在地区,获取地区的置信等级,用于分析客户质量,助于业务更好的发展。
门店管理地址分类:用于终端门店城乡类别分类统计,便于对门店进行更加精细化的管理。
电商订单地址检测:根据订单地址,辅助企业计算统计订单的分布情况,方便后期广告投放维度
本服务属于高级权限,需付费开通,您可以联系我们开通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 ”返回参数,可支持返回该地点在农村类别中所属的具体区域及其置信分。