万维易源-子区域查询

行政区划(全国省市区县和乡镇)查询 官方自营会员接口

累计调用

2037万+

会员接口交流群： 1054956818 查看演示

查看加密签名方式 二、请求参数/ Request parameter

非文件上传的POST时，请设置headers['Content-Type'] = 'application/x-www-form-urlencoded', 并把对象形式的数据转成查询字符串
文件上传的POST时，请设置headers['Content-Type'] = 'multipart/form-data'

1、系统级参数（所有接入点都需要的参数）：展开收起

参数名称	类型	示例值	必须	描述
showapi_appid	String	100	是	易源应用id
showapi_sign	String	698d51a19d8a121ce581499d7b701668	是	为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。可选【简单密钥方式】,在url后带上showapi_appid和showapi_sign即可
showapi_timestamp	String	20141114142239	否	客户端时间。格式yyyyMMddHHmmss,如20141114142239 为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。
showapi_res_gzip	String	1或0	否	返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。
...

2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：

参数名称	类型	默认值	示例值	必须	描述
parentId	String		440100000000	是	上级的ID,该ID可以在"区域查询"接入点中查找

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数（所有接入点都会返回的参数）： 展开收起

名称	类型	示例值	描述
showapi_res_body	String	{"city":"昆明","prov":"云南"}	消息体的JSON封装，所有应用级的返回参数将嵌入此对象。
showapi_res_code	int	0	易源返回标志,0为成功，其他为失败。 0成功 -1，系统调用错误 -2，可调用次数或金额为0 -3，读取超时 -4，服务端返回数据解析错误 -5，后端服务器DNS解析错误 -6，服务不存在或未上线 -7, API创建者的网关资源不足 -1000，系统维护 -1002，showapi_appid字段必传 -1003，showapi_sign字段必传 -1004，签名sign验证有误 -1005，showapi_timestamp无效 -1006，app无权限调用接口 -1007，没有订购套餐 -1008，服务商关闭对您的调用权限 -1009，调用频率受限 -1010，找不到您的应用 -1011，子授权app_child_id无效 -1012，子授权已过期或失效 -1013，子授权ip受限 -1014，token权限无效
showapi_res_error	String	用户输入有误!	错误信息的展示
showapi_res_id	String	ce135f6739294c63be0c021b76b6fbff	本次请求id
...

2、应用级参数（系统级输出参数showapi_res_body字段中的json数据结构）： 展开收起

名称	类型	示例值	描述
ret_code	String	0	接口调用是否成功
data	Object[]		子区域列表
- provinceId	String	440000000000	省级编码
- simpleName	String	荔湾	区域名简称
- areaCode	String	020	区号
- cityId	String	440100000000	市级编码
- remark	String		备注
- pinYin	String	Liwan	区域名称的全拼
- prePinYin	String	L	拼音首字母
- parentId	String	440100000000	上级编码
- level	String	3	区域级别 1 省级 2市级 3区县
- areaName	String	荔湾区	区域名称
- lat	String		纬度
- lon	String		经度
- simplePy	String	Lw	简拼
- zipCode	String	510000	邮编
- countyId	String	440103000000	区县编码
...

四、请求示例/ Request example 查看使用向导查看我的showapi_appid与showapi_sign 丨

五、返回示例/ Return example

{
	"showapi_res_code": 0,
	"showapi_res_error": "",
	"showapi_res_id":"ce135f6739294c63be0c021b76b6fbff",
    "showapi_res_body": {
		"ret_code": 0,
		"flag": true,
		"data": [
			{
				"provinceId": "440000000000",
				"simpleName": "荔湾",
				"lon": "113.2442",
				"areaCode": "020",
				"cityId": "440100000000",
				"remark": "",
				"prePinYin": "L",
				"id": "440103000000",
				"pinYin": "Liwan",
				"parentId": "440100000000",
				"level": 3,
				"areaName": "荔湾区",
				"simplePy": "LW",
				"zipCode": "510000",
				"countyId": "440103000000",
				"lat": "23.12592",
				"wholeName": "中国,广东省,广州市,荔湾区"
			},
			{
				"provinceId": "440000000000",
				"simpleName": "越秀",
				"lon": "113.26683",
				"areaCode": "020",
				"cityId": "440100000000",
				"remark": "",
				"prePinYin": "Y",
				"id": "440104000000",
				"pinYin": "Yuexiu",
				"parentId": "440100000000",
				"level": 3,
				"areaName": "越秀区",
				"simplePy": "YX",
				"zipCode": "510000",
				"countyId": "440104000000",
				"lat": "23.12897",
				"wholeName": "中国,广东省,广州市,越秀区"
			},
			{
				"provinceId": "440000000000",
				"simpleName": "海珠",
				"lon": "113.26197",
				"areaCode": "020",
				"cityId": "440100000000",
				"remark": "",
				"prePinYin": "H",
				"id": "440105000000",
				"pinYin": "Haizhu",
				"parentId": "440100000000",
				"level": 3,
				"areaName": "海珠区",
				"simplePy": "HZ",
				"zipCode": "510000",
				"countyId": "440105000000",
				"lat": "23.10379",
				"wholeName": "中国,广东省,广州市,海珠区"
			},
			{
				"provinceId": "440000000000",
				"simpleName": "天河",
				"lon": "113.36112",
				"areaCode": "020",
				"cityId": "440100000000",
				"remark": "",
				"prePinYin": "T",
				"id": "440106000000",
				"pinYin": "Tianhe",
				"parentId": "440100000000",
				"level": 3,
				"areaName": "天河区",
				"simplePy": "TH",
				"zipCode": "510000",
				"countyId": "440106000000",
				"lat": "23.12467",
				"wholeName": "中国,广东省,广州市,天河区"
			},
			{
				"provinceId": "440000000000",
				"simpleName": "白云",
				"lon": "113.27307",
				"areaCode": "020",
				"cityId": "440100000000",
				"remark": "",
				"prePinYin": "B",
				"id": "440111000000",
				"pinYin": "Baiyun",
				"parentId": "440100000000",
				"level": 3,
				"areaName": "白云区",
				"simplePy": "BY",
				"zipCode": "510000",
				"countyId": "440111000000",
				"lat": "23.15787",
				"wholeName": "中国,广东省,广州市,白云区"
			},
			{
				"provinceId": "440000000000",
				"simpleName": "黄埔",
				"lon": "113.45895",
				"areaCode": "020",
				"cityId": "440100000000",
				"remark": "",
				"prePinYin": "H",
				"id": "440112000000",
				"pinYin": "Huangpu",
				"parentId": "440100000000",
				"level": 3,
				"areaName": "黄埔区",
				"simplePy": "HP",
				"zipCode": "510700",
				"countyId": "440112000000",
				"lat": "23.10642",
				"wholeName": "中国,广东省,广州市,黄埔区"
			},
			{
				"provinceId": "440000000000",
				"simpleName": "番禺",
				"lon": "113.38397",
				"areaCode": "020",
				"cityId": "440100000000",
				"remark": "",
				"prePinYin": "P",
				"id": "440113000000",
				"pinYin": "Panyu",
				"parentId": "440100000000",
				"level": 3,
				"areaName": "番禺区",
				"simplePy": "PY",
				"zipCode": "511400",
				"countyId": "440113000000",
				"lat": "22.93599",
				"wholeName": "中国,广东省,广州市,番禺区"
			},
			{
				"provinceId": "440000000000",
				"simpleName": "花都",
				"lon": "113.22033",
				"areaCode": "020",
				"cityId": "440100000000",
				"remark": "",
				"prePinYin": "H",
				"id": "440114000000",
				"pinYin": "Huadu",
				"parentId": "440100000000",
				"level": 3,
				"areaName": "花都区",
				"simplePy": "HD",
				"zipCode": "510800",
				"countyId": "440114000000",
				"lat": "23.40358",
				"wholeName": "中国,广东省,广州市,花都区"
			},
			{
				"provinceId": "440000000000",
				"simpleName": "从化",
				"lon": "113.587386",
				"areaCode": "020",
				"cityId": "440100000000",
				"remark": "",
				"prePinYin": "C",
				"id": "440117000000",
				"pinYin": "Conghua",
				"parentId": "440100000000",
				"level": 3,
				"areaName": "从化区",
				"simplePy": "CH",
				"zipCode": "510900",
				"countyId": "440117000000",
				"lat": "23.545283",
				"wholeName": "中国,广东省,广州市,从化区"
			},
			{
				"provinceId": "440000000000",
				"simpleName": "增城",
				"lon": "113.829579",
				"areaCode": "020",
				"cityId": "440100000000",
				"remark": "",
				"prePinYin": "Z",
				"id": "440118000000",
				"pinYin": "Zengcheng",
				"parentId": "440100000000",
				"level": 3,
				"areaName": "增城区",
				"simplePy": "ZC",
				"zipCode": "511300",
				"countyId": "440118000000",
				"lat": "23.290497",
				"wholeName": "中国,广东省,广州市,增城区"
			},
			{
				"provinceId": "440000000000",
				"simpleName": "南沙",
				"lon": "113.60845",
				"areaCode": "020",
				"cityId": "440100000000",
				"remark": "国家级新区6",
				"prePinYin": "N",
				"id": "440115000000",
				"pinYin": "Nansha",
				"parentId": "440100000000",
				"level": 3,
				"areaName": "南沙新区",
				"simplePy": "NS",
				"zipCode": "511458",
				"countyId": "440115000000",
				"lat": "22.77144",
				"wholeName": "中国,广东省,广州市,南沙新区"
			}
		]
	}
}

一个会员资源包即可调用【所有会员接口】
注册即免费送会员包（流量次数限制）
if （会员包到期 or 次数用完 or 流量用完） then 会员包失效 end
可购买多个资源包，会自动递延生效串联使用

行政区划(全国省市区县和乡镇)查询官方自营会员接口

1、接口介绍

2、使用场景

3、产品优势对比

4、我们的实力

5、合作伙伴

一、接入点/ API point

查看加密签名方式二、请求参数/ Request parameter

三、返回参数/ Return parameter

四、请求示例/ Request example 查看使用向导 查看我的showapi_appid与showapi_sign 丨

五、返回示例/ Return example

提供方联系方式/ Contact Information

易源·API市场

行政区划(全国省市区县和乡镇)查询 官方自营 会员接口