webapi

服务介绍

服务文档

使用指南

常见问题

更新日志

内容（服务介绍）

地址城乡类型判别

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

功能介绍

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

适用场景

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

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

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

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

接入指南

本服务属于高级权限，需付费开通，您可以联系我们开通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 ”返回参数，可支持返回该地点在农村类别中所属的具体区域及其置信分。