1. 为什么需要多级行政区可视化
第一次接触高德地图的DistrictSearch插件时,我完全被它强大的行政区查询能力震撼到了。这个插件不仅能查询省市区的基本信息,还能获取精确的边界坐标数据。在实际项目中,我们经常需要展示从省级到区级的完整行政区划,比如疫情地图、物流配送范围规划等场景。
传统的做法是使用GeoJSON数据,但这种方式有几个明显的痛点:数据更新不及时、文件体积庞大、无法动态调整显示层级。而DistrictSearch API完美解决了这些问题,它提供的是实时、动态的行政区数据查询能力。我记得去年做一个全国物流网络项目时,客户要求能随时查看各省、各市的配送范围,用DistrictSearch只用了不到100行代码就实现了这个功能。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 快速上手DistrictSearch基础查询
2.1 初始化地图与插件
要使用DistrictSearch,首先需要在HTML中引入高德地图JS API和DistrictSearch插件:
html复制<script src="https://webapi.amap.com/maps?v=2.0&key=你的key&plugin=AMap.DistrictSearch"></script>
初始化地图和DistrictSearch对象的代码如下:
javascript复制const map = new AMap.Map('container', {
viewMode: '3D',
zoom: 4,
center: [116.397428, 39.90923] // 默认北京中心点
});
const district = new AMap.DistrictSearch({
extensions: 'all', // 返回边界坐标
level: 'province', // 查询级别
subdistrict: 1 // 返回下级行政区
});
这里有几个关键参数需要注意:
extensions: 'all'必须设置才能获取边界坐标level控制查询的行政区级别,可选值有 province/city/districtsubdistrict设置为1表示需要下级行政区信息
2.2 执行行政区查询
查询一个省份的基本信息和边界数据非常简单:
javascript复制district.search('广东省', function(status, result) {
if (status === 'complete') {
const data = result.districtList[0];
console.log('中心点坐标:', data.center);
console.log('边界数据:', data.boundaries);
console.log('下级行政区:', data.districtList);
}
});
在实际项目中,我建议把这些查询封装成Promise形式,方便后续的异步操作:
javascript复制function searchDistrict(name) {
return new Promise((resolve) => {
district.search(name, (status, result) => {
resolve(status === 'complete' ? result.districtList[0] : null);
});
});
}
3. 多级行政区递归查询实战
3.1 递归查询策略设计
要实现从省到市再到区的完整可视化,我们需要设计递归查询策略。这里分享一个我在实际项目中验证过的方案:
- 先查询
