全部服务产品
开发者频道
定价
登录

所有文档

行政区划查询

服务功能
下载开发文档
接口说明

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

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***ObPGW04string
sub_admin

行政区划显示子级级数
(可显示行政区划级别包含多级行政区划:国家(仅限中国)、省/直辖市、市、区/县、乡镇/街道)

显示下级行政区划级数
可填入:0、1、2、3等数字,并以此类推
0:不返回下级行政区;
1:返回下一级行政区;
2:返回下两级行政区;
3:返回下三级行政区;

string0
extensions_code是否召回国标行政区划编码,1(召回);0(不召回)1(召回)或者0(不召回)string0
boundary

是否返回区划边界数据
0 不返回区划边界坐标点
1 返回区划边界坐标点

0 或1
仅返回所查询的行政区划边界数据,不返回子级数据
仅支持输出省市区的边界数据,暂不支持输出乡镇、街道的边界数据

string0
boundarycode需要返回边界数据的行政区划编码

110112
若输入adcode,则返回adcode对应的行政区划的边界数据
若不输入adcode或adcode输入错误,则返回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
// 此处填写你在控制台-应用管理-创建应用后获取的AK
$ak = '您的AK';
// 发起一个http get请求,并返回请求的结果
// $url字段为请求的地址
// $param字段为请求的参数
function request_get($url = '', $param = array()) {
if (empty($url) || empty($param)) {
return false;
}
$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");
?>
{
"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
行政区划显示子级级数
(可显示行政区划级别包含多级行政区划:国家(仅限中国)、省/直辖市、市、区/县、乡镇/街道)
服务状态码
返回码英文描述定义
0OK正常状态
-1Keyword is empty关键字为空
-3Unknown error未知错误

上一篇

使用准备

下一篇

更新日志

本篇文章对您是否有帮助?