行政区查询 最后更新时间: 2021年01月22日
本章主要介绍高德JS API提供的行政区查询服务,包括以下两块内容:
- 获取下级行政区信息
- 绘制行政区划边界
行政区查询服务
行政区查询服务(AMap.DistrictSearch
)提供行政区信息的查询,使用该服务可以获取到行政区域的区号、城市编码、中心点、边界、下辖区域等详细信息,为基于行政区域的地图功能提供支持。
使用行政区划查询服务前要先引入该插件,具体的引入方式请参考教程:插件的使用。
获取下级行政区信息
在开发地图产品的时候,经常会有获取某一行政区下所有下级行政区信息的需求。以获取中国所有省份信息为例,相关代码是:
AMap.plugin('AMap.DistrictSearch', function () {
var districtSearch = new AMap.DistrictSearch({
// 关键字对应的行政区级别,country表示国家
level: 'country',
// 显示下级行政区级数,1表示返回下一级行政区
subdistrict: 1
})
// 搜索所有省/直辖市信息
districtSearch.search('中国', function(status, result) {
// 查询成功时,result即为对应的行政区信息
})
})
除了获取所有省份/直辖市信息外,您可以通过修改level
和subdistrict
并配合search
传入对应keyword
查询对应信息。
绘制行政区划边界
除了获取下级行政区信息外,有时我们还需要获得行政区域的边界信息实现一些功能,比如在地图上将行政区的边界绘制出来,这里以绘制朝阳区的边界举例,主要包含以下三步:
- 创建
AMap.DistrictSearch
对象 - 搜索朝阳区的边界信息
- 将边界信息用
AMap.Polygon
绘制到地图上
相关代码如下:
AMap.plugin('AMap.DistrictSearch', function () {
// 创建行政区查询对象
var district = new AMap.DistrictSearch({
// 返回行政区边界坐标等具体信息
extensions: 'all',
// 设置查询行政区级别为 区
level: 'district'
})
district.search('朝阳区', function(status, result) {
// 获取朝阳区的边界信息
var bounds = result.districtList[0].boundaries
var polygons = []
if (bounds) {
for (var i = 0, l = bounds.length; i < l; i++) {
//生成行政区划polygon
var polygon = new AMap.Polygon({
map: map,
strokeWeight: 1,
path: bounds[i],
fillOpacity: 0.7,
fillColor: '#CCF3FF',
strokeColor: '#CC66CC'
})
polygons.push(polygon)
}
// 地图自适应
map.setFitView()
}
})
})
UI组件-行政区划浏览
DistrictExplorer
(行政区划浏览) 提供了全国范围内到区县一级的行政区划数据(含边界),同时提供一些辅助功能,比如区划面绘制、事件监听,以及快速判断经纬度所属的子级区划等。
更多关于行政区划浏览组件的信息,请查看 UI组件库-行政区划浏览参考文档。