ShowAPI,自营为主的数据交易市场
立即注册

行政区划(全国省市区县和乡镇)查询

提供者: 易源官方 全部收费

最新最全的全国省、市、区县、乡镇的分级查询,同时支持县级以上的邮政编码、区号、经纬度的查询。国内数据与国家民政部统计的数据同步更新,其准确性和及时性可以保证。本接口同时收录了港澳台的相关数据,欢迎使用.

浏览量:8798

调用量:3630669

使用人数:1428

点赞:15

申请使用 查看演示
文档 授权签名(重要) 联系信息 价格一览表 接口演示
API说明(接口商自定义)
区划信息说明
接入点列表
区域查询
子区域查询
数据结构列表
区域信息
资源列表
·SDK及代码示例
规则中心
·名词解释
·常见问题

接入点说明

查询某个级别下的区划信息.

请求URL地址

http://route.showapi.com/1149-1
注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。

请求参数

HTTP协议,支持GET/POST方法。
非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。
1.系统级参数(所有接入点都需要的参数):+点此展开
2.应用级参数(每个接入点有自己的参数):
参数名称 类型 默认值 示例值 必须 描述
level String 2 区域级别
areaName String 区域名称
page String 1 1 当前页数,分页时用
maxSize String 20 5 每页获取的最大数据条数,最大值为20

返回参数

以JSON格式返回结果。
1.系统级参数(所有接入点都会返回的参数):+点此展开
2.应用级参数(系统级输出参数showapi_res_body字段中的json数据结构):
名称 类型 示例值 描述
ret_code Number 0 接口调用是否成功,0为成功,其他值为失败
  • 请求实例
  • java_sdk
  • 纯java
  • curl
  • php
  • android
  • python
String res=new ShowApiRequest("http://route.showapi.com/1149-1","my_appId","my_appSecret")
           .addTextPara("level","2")
           .addTextPara("areaName","州")
           .addTextPara("page","1")
           .addTextPara("maxSize","5")
           .post();
System.out.println(res);

                  public static void main(String path[]) throws Exception {
									URL u=new URL("http://route.showapi.com/1149-1?showapi_appid=myappid&level=&areaName=&page=&maxSize=&showapi_sign=mysecret");
									InputStream in=u.openStream();
									ByteArrayOutputStream out=new ByteArrayOutputStream();
									try {
										byte buf[]=new byte[1024];
										int read = 0;
										while ((read = in.read(buf)) > 0) {
											out.write(buf, 0, read);
										}
									}  finally {
										if (in != null) {
											in.close();
										}
									}
									byte b[]=out.toByteArray( );
									System.out.println(new String(b,"utf-8"));
							}
						 
						
						//字段值为中文、空格、特殊符号的地方需要做urlencode,编码为utf-8。用js的方式就是:
						//encodeURIComponent('中文')
						//比如"中文"转换后就是%25E4%25B8%25AD%25E6%2596%2587
            curl   "http://route.showapi.com/1149-1?showapi_appid=123&showapi_timestamp=20151214132239&showapi_sign=use_my_sign&level=2&areaName=州&page=1&maxSize=5&"
						
						 //md5签名方式--非简单签名
               			<?php
							header("Content-Type:text/html;charset=UTF-8");
							date_default_timezone_set("PRC");
							$showapi_appid = 'xxxxxx';  //替换此值,在官网的"我的应用"中找到相关值
							$showapi_secret = 'xxxxxxxxx';  //替换此值,在官网的"我的应用"中找到相关值 
							$paramArr = array(
							     'showapi_appid'=> $showapi_appid,
								 'level'=> "",
								 'areaName'=> "",
								 'page'=> "",
								 'maxSize'=> ""
							     //添加其他参数
							);
							
							//创建参数(包括签名的处理)
							function createParam ($paramArr,$showapi_secret) {
							     $paraStr = "";
							     $signStr = "";
							     ksort($paramArr);
							     foreach ($paramArr as $key => $val) {
							         if ($key != '' && $val != '') {
							             $signStr .= $key.$val;
							             $paraStr .= $key.'='.urlencode($val).'&';
							         }
							     }
							     $signStr .= $showapi_secret;//排好序的参数加上secret,进行md5
							     $sign = strtolower(md5($signStr));
							     $paraStr .= 'showapi_sign='.$sign;//将md5后的值作为参数,便于服务器的效验
							     echo "排好序的参数:".$signStr."
\r\n"; return $paraStr; } $param = createParam($paramArr,$showapi_secret); $url = 'http://route.showapi.com/1149-1?'.$param; echo "请求的url:".$url."
\r\n"; $result = file_get_contents($url); echo "返回的json数据:
\r\n"; print $result.'
\r\n'; $result = json_decode($result); echo "
\r\n取出showapi_res_code的值:
\r\n"; print_r($result->showapi_res_code); echo "
\r\n"; ?>
						//以下代码为纯java实现,并未依赖第三方框架,具体传入参数请参看接口描述详情页.
						protected Handler mHandler =  new Handler();
						protected void onCreate(Bundle savedInstanceState) {
								super.onCreate(savedInstanceState);
								setContentView(R.layout.activity_main);
								final TextView txt = (TextView) this.findViewById(R.id.textView1);
								Button myBtn = (Button) this.findViewById(R.id.button1);
								myBtn.setOnClickListener(new OnClickListener() {
									public void onClick(View v) {
										new Thread(){
											//在新线程中发送网络请求
											public void run() {
												String appid="xxx";//要替换成自己的
												String secret="xxxxxxx";//要替换成自己的
												final String res=new ShowApiRequest( "http://route.showapi.com/1149-1", appid, secret)
                    .addTextPara("level", "")
                                .addTextPara("areaName", "")
                                .addTextPara("page", "")
                                .addTextPara("maxSize", "")
            .post();
												
												System.out.println(res);
												//把返回内容通过handler对象更新到界面
												mHandler.post(new Thread(){
													public void run() {
														txt.setText(res+"  "+new Date());
													}
												});
											}
										}.start();
										
										
									}
								});
						}

						
#python3.5
from urllib import    request, parse
import json

print('send data....')
showapi_appid="xxxxxxxxxx"  #替换此值
showapi_sign="xxxxxxxxxx"   #替换此值
url="http://route.showapi.com/1149-1"
send_data = parse.urlencode([
    ('showapi_appid', showapi_appid)
    ,('showapi_sign', showapi_sign)
                    ,('level', "")
                    ,('areaName', "")
                    ,('page', "")
                    ,('maxSize', "")
    
  ])

req = request.Request(url)
try:
       response = request.urlopen(req, data=send_data.encode('utf-8'), timeout = 10) # 10秒超时反馈
except Exception as e:
    print(e)
result = response.read().decode('utf-8')
result_json = json.loads(result)
print ('result_json data is:', result_json)

						

返回实例

{
	"showapi_res_code": 0,
	"showapi_res_error": "",
	"showapi_res_body": {
		"ret_code": 0,
		"flag": true,
		"page":1,
		"maxSize":5,
		"data": [
			{
				"provinceId": "330000000000",
				"simpleName": "衢州",
				"lon": "118.87263",
				"areaCode": "0570",
				"cityId": "330800000000",
				"remark": "",
				"prePinYin": "Q",
				"id": "330800000000",
				"pinYin": "Quzhou",
				"parentId": "330000000000",
				"level": 2,
				"areaName": "衢州市",
				"simplePy": "QZ",
				"zipCode": "324000",
				"countyId": "0",
				"lat": "28.941708",
				"wholeName": "中国,浙江省,衢州市"
			},
			{
				"provinceId": "340000000000",
				"simpleName": "滁州",
				"lon": "118.316264",
				"areaCode": "0550",
				"cityId": "341100000000",
				"remark": "",
				"prePinYin": "C",
				"id": "341100000000",
				"pinYin": "Chuzhou",
				"parentId": "340000000000",
				"level": 2,
				"areaName": "滁州市",
				"simplePy": "CZ",
				"zipCode": "239000",
				"countyId": "0",
				"lat": "32.303627",
				"wholeName": "中国,安徽省,滁州市"
			},
			{
				"provinceId": "340000000000",
				"simpleName": "宿州",
				"lon": "116.984084",
				"areaCode": "0557",
				"cityId": "341300000000",
				"remark": "",
				"prePinYin": "S",
				"id": "341300000000",
				"pinYin": "Suzhou",
				"parentId": "340000000000",
				"level": 2,
				"areaName": "宿州市",
				"simplePy": "SZ",
				"zipCode": "234000",
				"countyId": "0",
				"lat": "33.633891",
				"wholeName": "中国,安徽省,宿州市"
			},
			{
				"provinceId": "340000000000",
				"simpleName": "亳州",
				"lon": "115.782939",
				"areaCode": "0558",
				"cityId": "341600000000",
				"remark": "",
				"prePinYin": "B",
				"id": "341600000000",
				"pinYin": "Bozhou",
				"parentId": "340000000000",
				"level": 2,
				"areaName": "亳州市",
				"simplePy": "BZ",
				"zipCode": "236000",
				"countyId": "0",
				"lat": "33.869338",
				"wholeName": "中国,安徽省,亳州市"
			},
			{
				"provinceId": "340000000000",
				"simpleName": "池州",
				"lon": "117.489157",
				"areaCode": "0566",
				"cityId": "341700000000",
				"remark": "",
				"prePinYin": "C",
				"id": "341700000000",
				"pinYin": "Chizhou",
				"parentId": "340000000000",
				"level": 2,
				"areaName": "池州市",
				"simplePy": "CZ",
				"zipCode": "247100",
				"countyId": "0",
				"lat": "30.656037",
				"wholeName": "中国,安徽省,池州市"
			}
		]
	}
}




请求地址 请求参数 返回参数 请求示例 返回示例
接入点列表
区域查询
子区域查询
  • 即充即用流量包(区域查询)

一次性礼包

0时间:1年

  • 50次调用
  • 不限调用频率
  • 手机认证 要求
  •  
领取

2元

2 时间:1年

  • 20000次调用
  • 不限调用频率
订购套餐
  • 包月套餐(区域查询)

10元包月

10 时间:包月(30天)

  • 50000次每天
  • 50次/秒调用频率
订购套餐