该服务用于查询行政区划信息。可以根据用户输入的搜索条件,帮助用户快速的查找特定的行政区域信息。
https://api.map.baidu.com/api_region_search/v1/?keyword=山东&sub_admin=2&ak=您的ak
//GET请求
参数名称 | 参数含义 | 示例 | 类型 | 默认值 | 必选 |
---|---|---|---|---|---|
keyword | 检索行政区划关键字。 | 若sub_admin=2 | string | 无 | 是 |
ak | 用户服务访问密钥 | CO3seSdqC***ObPGW04 | string | 无 | 是 |
sub_admin | 行政区划显示子级级数 | 显示下级行政区划级数 | string | 0 | 否 |
extensions_code | 是否召回国标行政区划编码,1(召回);0(不召回) | 1(召回)或者0(不召回) | string | 0 | 否 |
boundary | 是否返回区划边界数据 | 0 或1 | string | 0 | 否 |
boundarycode | 需要返回边界数据的行政区划编码 | 110112 | 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可生成包含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(); // 初始化curlcurl_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); // 运行curlif (!$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 | 行政区划显示子级级数 (可显示行政区划级别包含多级行政区划:国家(仅限中国)、省/直辖市、市、区/县、乡镇/街道) | 否 |
0 | OK | 正常状态 |
-1 | Keyword is empty | 关键字为空 |
-3 | Unknown error | 未知错误 |
上一篇
下一篇
本篇文章对您是否有帮助?