浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

文档全面上新

更科技的视觉体验,更高效的页面结构,快前往体验吧!

体验新版
服务介绍
服务文档
使用指南
常见问题
更新日志
地址城乡类型判别

根据国家发布的城乡标准,通过多源数据融合,利用智能挖掘算法对地址所在区域进行自动化精准匹配,从而高效、准确的判断地址所在区域的城乡类型。

功能介绍

本服务从行政区划和经济发展角度判断某一地址所在位置是城市、乡镇还是农村,为开发者输出城乡类别置信度分值,同时可提供地址所在区县、乡镇街道的类型。辅助金融、物流、生活服务等行业的开发者更好的理解地址类型,进行风险评估、个性化服务以及精细化运营。

适用场景

银行业务风险识别:判断用户地址的真实性以及属于城市或农村, 辅助欺诈识别和判断。

潜在客户质量分析:根据客户所在地区,获取地区的置信等级,用于分析客户质量,助于业务更好的发展。

门店管理地址分类:用于终端门店城乡类别分类统计,便于对门店进行更加精细化的管理。

电商订单地址检测:根据订单地址,辅助企业计算统计订单的分布情况,方便后期广告投放维度

接入指南

本服务属于高级权限,需付费开通,您可以联系我们开通15天试用并了解更多信息。

接口功能介绍
请求URL
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天试用并了解更多信息。

请求参数
参数名 数据类型 是否必传 默认值 参数含义 示例
address
string
需要解析的地址 北京市海淀区上地十街10号百度大厦
ak
string
开发者密钥,可在API控制台申请获得 CO3seS******ObPGW04
is_encry_address
int
0
判断地址address是否加密
默认是不加密
加密方式请通过反馈平台与我们联系
is_airport_or_develop
bool
false
是否返回特殊区域标识:true(返回) 、false(不返回) true、false
返回结果参数

返回的结果中,从两个维度描述地址所属的城乡类别:
1、行政区划维度:根据国家行政区划标准,判断地址所属城乡类别,包括城市和农村两种类型。
2、经济统计维度:国家统计局会根据每个地区的经济发展程度,对城乡类别进行划分,包括城市、乡镇、农村三种类型。比如一个地区在行政区划上是农村,但随着经济的发展,已成为经济较发达地区,即会在经济统计维度被归类为城市。
开发者可以根据自身业务需要,选择采用行政区划还是经济统计维度对地址进行分类。
3、特殊区域标识:当前特殊区域包含机场和开发区两种类型。开发者可以根据自身业务需要,结合特殊区域返回类型进行业务判断。

参数名 含义 备注 示例
status
状态码
表示请求是否成功
0
admin_info
province
省份
省级行政区划名称
北京市
city
城市
市级行政区划名称
北京市
county
行政区
区级行政区划名称
海淀区
town
街道
街道、镇级行政区划名称
上地街道
admin_type
county_type
区县级行政区划的类型
区县级行政区划类型有:区、市、县、旗、特区、林区、自治县和自治旗。
town_type
乡镇级行政区划的类型
乡镇级行政区划类型有:乡、镇、街道、民族乡、苏木和民族苏木等。
街道
town_urban_rural
行政区划维度的城乡类别
根据行政区划的标准,判别城乡类型,包括城市和农村两种类型
城市
confidence
行政区划维度城乡类别的置信分,分数越高表示越有可能是这一类别。如类别为城市,置信分为90分,代表90%的可能性是城市
0.0 – 100.0
100.0
stats_type
urban
经济统计维度的城市类别置信分。如置信分为90,代表90%的可能性是城市
0.0 – 100.0
100.0
urban_list
该地点在城市类别中所属的具体区域及其置信分。如代码111置信分为80,代表80%的可能性是主城区
100表示:城镇
110表示:城区
111表示:主城区
112表示:城乡结合区
111:80,112:10
township
经济统计维度的乡镇类型置信分。如置信分为10,代表10%的可能性是乡镇
0.0 – 100.0 0.0
township_list
该地点在乡镇类别中所属的具体区域及其置信分。如代码121置信分为70,代表70%的可能性是镇中心区
120表示:镇区
121表示:镇中心区
122表示:镇乡结合区
123 表示:特殊区域
121:70,122:10
rural
经济统计维度的农村类型置信分。如置信分为0,代表0%的可能性是农村
0.0 – 100.0 0.0
rural_list
该地点在农村类别中所属的具体区域及其置信分。如代码220置信分为80,代表80%的可能性是村庄
200表示:乡村
210表示:乡中心区
220表示:村庄
210:10,220:80
airport_or_develop

该地点是否属于特殊区域(包含机场和开发区)
若设置了请求参数is_airport_or_develop=true时,则返回该字段,返回类型包含机场和开发区
|机场|开发区

示例代码
{
    "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


城乡分类与代码
110
城区
110
城区
111
主城区
112
城乡结合区
120
镇区
121
镇中心区
122
镇乡结合区
123
特殊区域
200
乡村
210
乡中心区
220
村庄
服务使用限制

本服务属于高级权限,需付费开通,您可以联系我们开通15天试用并了解更多信息
服务相关配额及并发请求限制请访问开发者权益页面查看。

服务常见问题
1、服务的使用配额/并发满了要怎么办?

地址城乡类型判别服务与其他API服务一样,具有每天使用配额和并发次数的限制。使用前,您需要联系我们申请服务权限,权限开通后您将获取每天100次免费请求次数。如果您需要对服务进行大量测试,当前配额或并发不能满足业务使用需求,需联系我们申请做进一步提升,请详细填写日配额和并发预估计算方法,以便评估。

2.如何购买该服务?

本服务为高级服务,如有采买需求,请提交工单联系我们,将有商务与您取得联系。

2020年9月16日

V1.0

2022年1月18日

V1.1


全新上线
城乡类型判别服务全新上线,支持判断地址所在位置的城乡类别。
新增功能
新增请求参数
新增“ is_airport_or_develop ”请求参数,城乡判别服务可支持是否返回特殊区域标识。

新增返回参数
新增“airport_or_develop”返回参数,可支持返回该地点属于特殊区域类型,当前特殊区域包含机场和开发区两种类型。
新增“urban_list”返回参数,可支持返回该地点在城市类别中所属的具体区域及其置信分。
新增“township_list”返回参数,可支持返回该地点在乡镇类别中所属的具体区域及其置信分。
新增“ rural_list ”返回参数,可支持返回该地点在农村类别中所属的具体区域及其置信分。

  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消