行政区划查询

所有文档

服务概览

快速开始

使用准备

接口文档

服务功能

行政区划查询

相关资料

更新日志常见问题资源下载使用指南

服务功能

下载开发文档

接口说明

该服务用于查询行政区划信息。可以根据用户输入的搜索条件，帮助用户快速的查找特定的行政区域信息。

api服务地址

https://api.map.baidu.com/api_region_search/v1/?keyword=山东&sub_admin=2&ak=您的ak
//get请求

请求参数

参数名称	参数含义	示例	类型	默认值	必选
keyword	检索行政区划关键字。行政区划区域检索不支持多关键字检索关键字可填写：行政区名称（"中华人民共和国"/"中国"/"全国"，省、市、区和镇名称）以及 adcode； adcode信息可参考（百度地图行政区划adcode映射表）	若sub_admin=2 检索关键字搜索省份（例如河北），能够显示市（例如石家庄市），区（例如桥西区）	string	无	是
ak	用户服务访问密钥	co3sesdqc***obpgw04	string	无	是
sub_admin	行政区划显示子级级数（可显示行政区划级别包含多级行政区划：国家（仅限中国）、省/直辖市、市、区/县、乡镇/街道）	显示下级行政区划级数可填入：0、1、2、3等数字，并以此类推 0：不返回下级行政区； 1：返回下一级行政区； 2：返回下两级行政区； 3：返回下三级行政区；	string	0	否
extensions_code	是否召回国标行政区划编码，1(召回)；0(不召回)	1(召回)或者0(不召回)	string	0	否
boundary	是否返回区划边界数据 0 不返回区划边界坐标点 1 返回区划边界坐标点	0 或1 仅返回所查询的行政区划边界数据，不返回子级数据仅支持输出省市区的边界数据，暂不支持输出乡镇、街道的边界数据	string	0	否
boundarycode	需要返回边界数据的行政区划编码	110112 若输入adcode，则返回adcode对应的行政区划的边界数据若不输入adcode或adcase错误，则返回keyword匹配到的第一个行政区划的边界数据	string	/	否

返回参数

参数名		含义	备注	示例
status		状态码	本次api访问状态，如果成功返回0，如果失败返回其他数字。（见服务状态码）	0
data_version		行政区划数据版本		20201101
result_size		行政区划个数	检索到的包含关键字（keyword）信息的行政区划个数。如keyword=朝阳，返回result_size=44 检索结果中包括“北京市朝阳区”，“辽宁省朝阳市”及其他42个带有“朝阳”关键字的乡镇街道信息。	44
districts
	code	行政区划编码
	name	行政区划名称
	level	行政区划级别	0：全国 1：省份（直辖市会在province和city中显示） 2：市（直辖市会在province和city中显示） 3：区/县 4：镇/乡/街道
	districts	下级行政区列表		包含请求下级行政区划内容
polyline		行政区划的边界数据	当一个行政区范围，由完全分隔两块或者多块的地块组成，每块地的 polyline 坐标串以 \| 分隔

示例代码

填写您的ak

输入ak可生成包含ip/sn校验方式的代码

php

python

java

bash


<?php 
// 此处填写你在控制台-应用管理-创建应用后获取的ak
    $ak ='您的ak';
// 发起一个http get请求，并返回请求的结果
// $url字段为请求的地址
// $param字段为请求的参数
functionrequest_get($url ='', $param =array()){
if(empty($url)||empty($param)){
returnfalse;
}
        $geturl = $url ."?".http_build_query($param);
        $curl =curl_init();// 初始化curl
curl_setopt($curl,curlopt_ssl_verifypeer,false);// 跳过证书检查   
curl_setopt($curl,curlopt_ssl_verifyhost,2);// 从证书中检查ssl加密算法是否存在
curl_setopt($curl,curlopt_url, $geturl);// 抓取指定网页
curl_setopt($curl,curlopt_timeout,1000);// 设置超时时间1秒
curl_setopt($curl,curlopt_returntransfer,1);// curl不直接输出到屏幕
curl_setopt($curl,curlopt_header,0);// 设置header
        $data =curl_exec($curl);// 运行curl
if(!$data){
print("an error occured in function request_get(): ".curl_error($curl)."\n");
}
curl_close($curl);
return $data;
}
// 请求地址
    $url ='https://api.map.baidu.com/api_region_search/v1/';
// 构造请求参数
    $param['keyword']='山东';
    $param['sub_admin']='2';
    $param['ak']= $ak;
    $res =request_get($url, $param);
// 将原始返回的结果打印出来
print("请求的原始返回结果为:\n");
print($res ."\n");
?>

json


{
"status":0,
"data_version":"20220722",
"result_size":1,
"districts":[
{
"code":"",
"name":"山东省",
"level":1,
"districts":[
{
"code":"",
"name":"日照市",
"level":2,
"districts":[]
},
{
"code":"",
"name":"青岛市",
"level":2,
"districts":[]
},
{
"code":"",
"name":"济南市",
"level":2,
"districts":[]
},
{
"code":"",
"name":"潍坊市",
"level":2,
"districts":[]
},
{
"code":"",
"name":"济宁市",
"level":2,
"districts":[]
},
{
"code":"",
"name":"菏泽市",
"level":2,
"districts":[]
},
{
"code":"",
"name":"烟台市",
"level":2,
"districts":[]
},
{
"code":"",
"name":"滨州市",
"level":2,
"districts":[]
},
{
"code":"",
"name":"德州市",
"level":2,
"districts":[]
},
{
"code":"",
"name":"淄博市",
"level":2,
"districts":[]
},
{
"code":"",
"name":"枣庄市",
"level":2,
"districts":[]
},
{
"code":"",
"name":"泰安市",
"level":2,
"districts":[]
},
{
"code":"",
"name":"聊城市",
"level":2,
"districts":[]
},
{
"code":"",
"name":"威海市",
"level":2,
"districts":[]
},
{
"code":"",
"name":"临沂市",
"level":2,
"districts":[]
},
{
"code":"",
"name":"东营市",
"level":2,
"districts":[]
}
]
}
]
}

在线运行

参数	值	备注	必选
keyword		检索行政区划关键字。行政区划区域检索不支持多关键字检索关键字可填写：行政区名称（"中华人民共和国"/"中国"/"全国"，省、市、区和镇名称）以及 adcode； adcode信息可参考（百度地图行政区划adcode映射表）	是
sub_admin		行政区划显示子级级数（可显示行政区划级别包含多级行政区划：国家（仅限中国）、省/直辖市、市、区/县、乡镇/街道）	否

服务状态码