AI 地图
产品服务
解决方案
文档与支持
定价
更新时间: 2026/07/27 10:37
您当前查看的是 JSAPI GL 历史版本文档。该版本仅用于维护现有项目,不建议用于新项目开发。新项目请使用 JSAPI 4.0,如需升级现有项目,请参考升级指南
You are viewing the legacy JSAPI GL documentation. This version is maintained for existing projects only and is not recommended for new development. For new projects, use the JSAPI 4.0 documentation. If you are upgrading an existing project, please refer to the Migration Guide.
简易行政区划图层
简介

DistrictLayer图层,支持以jsapi方式获取的新版行政区划数据,并进行行政区划图层展示。
该行政区划图层支持多级行政区划的数据获取与展示,并提供了行政区合并为大区的特色功能。

DEMO详情
多级省区
行政大区
DistrictLayer类参考

构造函数:

构造函数说明

BMapGL.DistrictLayer(options, callback)

行政区划聚合图层构造函数

参数说明:

构造函数类型说明

options

Object

行政区划图层样式配置对象

callback

Function

回调函数

options属性变量:

options属性类型说明

name

Array

欲获取的行政区划名称,格式为字符串或数组。如果是大区情况,只能采用字符串格式,如"(北京,天津,河北),山东"

kind

number

行政区划显示级别,0为省级行政区划,1为市级行政区划,2为区级行政区划

strokeColor

string

描边颜色,默认为'#ff0'

strokeOpacity

number

描边线透明度

strokeWeight

number

描边线粗细,默认为1

fillColor

string

填充颜色,默认为'#00f'。格式为字符串或数组。注意,目前行政区划没有名称标识,数组颜色与返回子层级区域顺序一一对应,暂不支持对子层级的特定市区县设置指定颜色。

viewport

boolean

是否自动根据行政区划来调节到最佳显示视野,默认为false

方法:

方法名说明

map.addDistrictLayer(district: DistrictLayer)

地图上添加行政区划图层,参数district为指定的行政区划实例

map.removeDistrictLayer(district: DistrictLayer)

地图上移除指定的行政区划图层,参数district为指定的行政区划实例

searchBoundary(options, callback(res))

搜索某个行政区划,通过回调函数实现自定义行政区划绘制。其中参数options同上面的构造函数的参数配置,callback(res)为回调函数。

使用示例
1. 创建地图参照展示地图
2. 创建行政区划聚合图层,并添加到地图上

创建行政区划图层类,其继承自Overlay,通过map.addoverlay()方法将创建的点覆盖物添加到地图上。

var dist = new BMapGL.DistrictLayer({
name: '(北京,天津,河北省)',
fillColor: '#5e8bff',
fillOpacity: 1,
});
map.addDistrictLayer(dist);

上一篇

三方标准图层

下一篇

区域掩膜
本篇文章对您是否有帮助?