webapi

服务介绍

服务文档

使用指南

常见问题

更新日志

内容（服务介绍）

地址城乡类型判别

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

功能介绍

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

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

接口功能介绍

请求URL

api.map.baidu.com/api_recog_address/v1/recog?  //GET请求

请求示例

api.map.baidu.com/api_recog_address/v1/recog?address=北京市海淀区信息路甲九号&ak=你的ak

注意：城乡类型判别是付费高级服务，您可以联系我们开通15天试用并了解更多信息。

请求参数

参数名	数据类型	是否必传	默认值	参数含义	示例
address	string	是	无	需要解析的地址	北京市海淀区上地十街10号百度大厦
ak	string	是	无	开发者密钥，可在API控制台申请获得	CO3seS******ObPGW04

返回结果参数

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

参数名		含义	备注	示例
status		状态码	表示请求是否成功	0
address		即请求参数中address信息		北京市海淀区信息路甲九号
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
	township	经济统计维度的乡镇类型置信分。如置信分为10，代表10%的可能性是乡镇	0.0 – 100.0	0.0
	rural	经济统计维度的农村类型置信分。如置信分为0，代表0%的可能性是农村	0.0 – 100.0	0.0

示例代码

{
    "status":0,
    "address":"北京市海淀区信息路甲9号",
    "admin_info":{
        "province":"北京市",
        "city":"北京市",
        "county":"海淀区",
        "town":"上地街道"
    },
    "admin_type":{
        "county_type":"区",
        "town_type":"街道",
        "town_urban_rural":"城市",
        "confidence":100
    },
    "stats_type":{
        "urban":100,
        "township":0,
        "rural":0
    }
}

内容（使用指南）

使用方法

编码说明

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表示百度墨卡托米制坐标

注意：不同类型坐标如需转换，请使用百度地图开放平台提供的标准坐标转换接口。请勿使用其他渠道提供的坐标转换方法，以免影响坐标转换精度。

服务使用限制

服务相关配额及并发请求限制请访问开发者权益页面查看。

内容（常见问题）

服务常见问题

1、服务的使用配额/并发满了要怎么办？

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

2.如何购买该服务？

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

内容（更新日志）

2020年9月16日

V1.0

全新上线

城乡类型判别服务全新上线，支持判断地址所在位置的城乡类别。