高德地图 JS API—简易行政区图

本章介绍 v1.4.10 版本正式发布的简易行政区图层。为了满足基于行政区块的数据可视化、行政区边界展示等开发需求，我们通过AMap.DistrictLayer插件提供了一组简易行政区图层，包括：

1. 世界简易行政区图层 AMap.DistrictLayer.World
2. 国家简易行政区图层 AMap.DistrictLayer.Country
3. 省市简易行政区图层 AMap.DistrictLayer.Province

这些图层各自的使用场景为:

世界简易行政区图层

在使用这组图层之前首先需要引入AMap.DistrictLayer插件，有两种方式。

创建

世界简易行政区图的创建方法如下：JavaScript

var disWorld = new AMap.DistrictLayer.World({
    zIndex:10,
    styles:{
        'nation-stroke':function(props){
            if(props.type=='Nation_Border_China'){
                return 'red'
            }else{
                return 'white'
            }
        },
        'coastline-stroke': [0.8, 0.63, 1, 1], 
        'fill':function(props){
            return getColorBySOC(props.SOC)
        }
    }
})

样式颜色配置

通过在创建的时候传入styles属性，可以为简易行政区图设定各面的填充颜色和描边颜色。styles各字段的值可以是颜色值，也可以是一个返回颜色值的回调函数function。支持的颜色格式有：

1. #RRGGBB，如：'#FFFFFF'

2. rgba()，如：'rgba(255,255,255,1)'

3. rgb()，如：'rgb(255,255,255)'

4. [r,g,b,a]，如：[1,1,1,1]

5. ''，代表不赋予颜色

回调函数入参说明

回调函数的入参为 API 为方便开发者进行业务数据与行政区数据映射而提供的一组字段，映射之后由回调函数生成对应的颜色值。世界简易行政区图层的回调函数的入参为：

国家简易行政区图层

创建

初始化的时候可以通过SOC字段设定显示的国家，通过depth字段设定数据的层级深度，depth为0的时候只显示国家面，depth为1的时候显示省级，当国家为中国时设置depth为2的可以显示市一级。JavaScript

var disCountry = new AMap.DistrictLayer.Country({
    zIndex:10,
    SOC:'CHN',
    depth:2,
    styles:{
        'nation-stroke':'#22ffff',
        'coastline-stroke':[0.8, 0.63, 0.94, 1],
        'province-stroke':'white',
        'city-stroke': 'rgba(255,255,255,0.5)',//中国特有字段
        'fill':function(props){//中国特有字段
           return getColorByDGP(props.adcode_pro)
        }
    }
})

回调函数入参说明

省市简易行政区图层

创建

创建时通过districts设定需要显示的行政区的adcode，通过depth字段设定数据的层级深度，depth为0的时候只显示省面，depth为1的时候显示市级，当depth为2的可以显示县一级。

adcode与省市行政区对照表JavaScript

var disProvince = new AMap.DistrictLayer.Province({
    zIndex:12,
    adcode:['130000'],
    depth:2,
    styles:{
        'fill':function(properties){
            var adcode = properties.adcode;
            return getColorByAdcode(adcode);
        },
        'province-stroke':'cornflowerblue',
        'city-stroke': 'white',//中国地级市边界
        'county-stroke': 'rgba(255,255,255,0.5)'//中国区县边界  
    }
})

回调函数入参说明