百度地图开放平台
更新时间: 2026/11/12 17:04
PolygonLayer图层

我们可以通过 BMap.PolygonLayer 在地图上添加面图层,批量展示面数据,常用于行政区划、区域热力等场景。面图层在颜色填充、描边的基础上,还支持纹理填充。

添加面图层

面图层可以设置填充颜色、透明度和描边等属性。通过 strokeColor、strokeWeight设置描边样式;

var fillLayer = new BMap.PolygonLayer({
fillColor: '#2a6cf6', // 设置填充颜色
fillOpacity: 0.3, // 设置填充透明度,取值范围0-1
strokeColor: '#ffffff', // 设置描边颜色
strokeWeight: 1 // 设置描边宽度,单位为像素
});
map.addLayer(fillLayer);
fillLayer.setData(geojson); // 设置面图层的数据
设置纹理填充

面的内部除了纯色填充,还支持使用图片纹理平铺填充,通过 fillTextureUrl 指定纹理图片地址,并可通过 fillTextureSize 设置单张图片的平铺宽度:

var fillLayer = new BMap.PolygonLayer({
fillTextureUrl: 'images/pattern.png', // 设置纹理图片地址,设置后启用平铺填充
fillTextureSize: 32, // 设置单张纹理在屏幕上的宽度,单位为像素
fillTextureAlphaOnly: false // 为 false 时使用纹理图片自身的颜色
});
通过数据控制面样式

与线图层、点图层相同,面图层的样式属性也支持表达式,渲染时会读取每个面的 properties属性数据并实时求值。
如下示例,通过 match 表达式对特定区域高亮显示:

var fillLayer = new BMap.PolygonLayer({
fillColor: [
'match', ['get', 'name'],
'海淀区', 'red',
'朝阳区', 'blue',
'通州区', 'green',
'丰台区', 'pink',
'房山区', 'orange',
'#aecde8' // 当name字段没有匹配到时,默认使用的颜色
],
fillOpacity: 0.6,
strokeColor: '#fff',
strokeWeight: 1.5
});

注意,fillTextureUrl、fillTextureSize 等纹理相关属性仅支持固定值,不支持表达式。

监听事件

支持监听面图层的事件,监听事件前,需要在创建图层时通过 enablePicked 开启拾取能力:

var fillLayer = new BMap.PolygonLayer({
enablePicked: true, // 开启拾取
fillColor: '#2a6cf6',
fillOpacity: 0.3
});
fillLayer.addEventListener('click', function (e) {
if (e.value && e.value.dataIndex !== -1) {
var properties = e.value.dataItem.properties; // 获取被点击面的属性数据
alert('您点击了:' + properties.name);
}
});
相关类参考

BMap.PolygonLayer

上一篇

线图层

下一篇

自定义图层
本篇文章对您是否有帮助?