1. 项目概述

在WebGIS开发中，行政区划地图掩膜是一种常见的数据可视化需求。它允许开发者只显示特定行政区域内的地图内容，而将区域外的部分隐藏或模糊处理。这种技术广泛应用于气象、环保、国土规划等领域，用于突出显示特定区域的地理信息。

我最近在一个省级环保监测系统中实现了这个功能，系统需要展示各行政区划内的污染源分布情况。通过SpringBoot后端和Leaflet前端的配合，我们成功实现了高性能的行政区划掩膜效果。下面将分享整个实现过程中的关键技术点和实战经验。

2. 技术选型与原理

2.1 为什么选择Leaflet

Leaflet是一个轻量级的开源JavaScript库，用于构建移动友好的交互式地图。相比OpenLayers等其他地图库，Leaflet具有以下优势：

• 体积小（仅39KB gzipped），加载速度快
• API设计简洁明了，学习曲线平缓
• 插件生态丰富，社区活跃
• 对移动设备支持良好

在实现掩膜效果时，Leaflet的轻量级特性尤为重要，因为我们需要在前端处理大量的GeoJSON数据并实时渲染。

2.2 掩膜的核心原理

GIS中的掩膜效果本质上是通过多边形叠加实现的视觉遮挡。具体原理包括：

1. 图层叠加顺序：底图（通常是遥感影像或基础地图）在下，掩膜多边形在上
2. 多边形绘制：创建一个覆盖整个地图范围的超大多边形，然后在其中"挖出"目标行政区划的区域
3. 视觉处理：给掩膜多边形设置半透明或纯色填充，形成遮挡效果

这种实现方式类似于Photoshop中的图层蒙版，只不过是在地理坐标系下完成的。

3. 环境准备与依赖配置

3.1 后端环境搭建

使用SpringBoot 2.7.x构建后端服务，主要依赖：

<dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>2.2.2</version> </dependency> <dependency> <groupId>org.postgresql</groupId> <artifactId>postgresql</artifactId> <scope>runtime</scope> </dependency> </dependencies>

数据库使用PostgreSQL+PostGIS扩展存储行政区划数据，表结构设计：

CREATE TABLE biz_province ( id BIGSERIAL PRIMARY KEY, name VARCHAR(100) NOT NULL, type VARCHAR(50), geom GEOMETRY(POLYGON, 4326) );

3.2 前端资源引入

在HTML中引入必要的JS/CSS资源：

<!-- Leaflet核心库 --> <link rel="stylesheet" href="https://unpkg.com/leaflet@1.9.3/dist/leaflet.css" /> <script src="https://unpkg.com/leaflet@1.9.3/dist/leaflet.js"></script> <!-- Leaflet插件 --> <script src="js/leaflet-mask.js"></script> <script src="https://unpkg.com/leaflet.sidebar-v2/js/leaflet-sidebar.js"></script> <!-- 其他辅助库 --> <script src="https://cdn.jsdelivr.net/npm/jquery@3.6.0/dist/jquery.min.js"></script>

4. 核心功能实现

4.1 后端接口开发

4.1.1 行政区划列表接口

@GetMapping("/list") @ResponseBody public TableDataInfo list(Province province) { startPage(); List<Province> list = provinceService.selectList(province); return getDataTable(list); }

4.1.2 GeoJSON数据接口

关键点：使用PostGIS的ST_AsGeoJSON函数直接返回GeoJSON格式数据

@GetMapping("/geojson/{id}") @ResponseBody public AjaxResult getGeojson(@PathVariable("id") Long id) { Province province = provinceService.findGeoJsonById(id, null); return AjaxResult.success().put("data", province.getGeomJson()); }

对应的Mapper SQL：

@Select("select st_asgeojson(geom) as geomJson from biz_province where id = #{id}") Province findGeoJsonById(@Param("id")Long id);

4.2 前端地图初始化

基础地图配置：

var mymap = L.map('map', { center: [35, 105], zoom: 5, preferCanvas: true // 使用Canvas渲染提高性能 }); // 添加底图 L.tileLayer('https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png', { attribution: '&copy; <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a> contributors' }).addTo(mymap);

4.3 掩膜功能实现

4.3.1 行政区划选择

function initHnTownTable() { var options = { url: prefix + "/list", columns: [ { field: 'id', title: '', visible: false }, { field: 'name', title: '省份' }, { field: 'type', title: '类别' }, { title: '操作', formatter: function(value, row) { return '<a class="btn btn-success btn-xs" href="javascript:void(0)" onclick="previewTown('' + row.id + '',''+row.name+'')">定位</a>'; } }] }; $.table.init(options); }

4.3.2 掩膜核心逻辑

function showMask(geojson) { var showPolygons = []; var pArray = []; // 处理GeoJSON坐标数据 geojson.coordinates.forEach(function(ring) { var points = ring.map(function(coord) { return {lat: coord[1], lng: coord[0]}; }); pArray = pArray.concat(points); pArray.push(pArray[0]); // 闭合多边形 }); var polygon = L.polygon(pArray, { color: 'green' }); showPolygons.push(polygon); // 创建掩膜层 var mask = L.mask({ showPolygons: showPolygons, color: '#C0C0C0', fillOpacity: 1, renderer: L.canvas({ padding: 1 }) }); showLayerGroup.addLayer(mask); }

5. 性能优化与问题解决

5.1 大数据量处理

当处理省级行政区划时，GeoJSON数据可能非常大。我们采用了以下优化措施：

1. 简化几何图形：使用PostGIS的ST_Simplify函数降低几何复杂度

SELECT ST_AsGeoJSON(ST_Simplify(geom, 0.01)) as geomJson FROM biz_province WHERE id = #{id}

2. 前端分级加载：根据缩放级别加载不同精度的数据

function getSimplifyLevel(zoom) { if (zoom < 6) return 0.05; if (zoom < 9) return 0.01; return 0.005; }

5.2 常见问题排查

5.2.1 掩膜边缘闪烁问题

现象：缩放地图时掩膜边缘出现闪烁或缝隙解决方案：

1. 在L.mask配置中增加renderer: L.canvas({ padding: 1 })
2. 确保多边形坐标闭合（首尾点相同）

5.2.2 性能瓶颈

现象：加载大型行政区划时页面卡顿优化方案：

1. 使用Web Worker处理GeoJSON解析
2. 实现渐进式渲染，先显示简化版，后台加载完整版

6. 扩展应用与进阶技巧

6.1 多级行政区划掩膜

通过扩展后端接口，可以实现市、县多级行政区划的掩膜：

@GetMapping("/geojson/{level}/{code}") @ResponseBody public AjaxResult getGeojsonByLevel( @PathVariable("level") String level, @PathVariable("code") String code) { String tableName = "biz_" + level; // biz_city, biz_county等 String sql = "SELECT ST_AsGeoJSON(geom) as geomJson FROM " + tableName + " WHERE code = ?"; // 执行查询... }

6.2 动态掩膜效果

结合Leaflet的动画功能，可以实现动态变化的掩膜效果：

function animateMask(opacity) { if(!currentMask) return; currentMask.setStyle({fillOpacity: opacity}); if(opacity < 1) { setTimeout(function() { animateMask(opacity + 0.05); }, 50); } }

7. 项目总结与经验分享

在实际项目中，行政区划掩膜功能虽然原理简单，但要实现高性能、稳定的效果仍需注意以下几点：

1. 坐标系一致性：确保前后端使用相同的坐标系（推荐WGS84）
2. 数据预处理：对行政区划数据进行拓扑检查和简化处理
3. 内存管理：及时清理不再使用的图层，避免内存泄漏
4. 移动端适配：针对移动设备优化触摸交互和渲染性能

一个实用的调试技巧是在开发过程中添加临时图层显示原始GeoJSON数据，方便验证数据准确性：

L.geoJSON(geojson, { style: {color: 'red', weight: 2} }).addTo(mymap);

通过这个项目，我们发现Leaflet配合SpringBoot能够很好地满足WebGIS开发的需求，特别是其轻量级和灵活性使得实现复杂的地图效果变得相对简单。对于需要更复杂GIS功能的场景，可以考虑扩展使用Turf.js等空间分析库。