常用基础图层
🎯 引言
学完这篇文章,你能根据数据的几何类型选择 ScatterplotLayer、GeoJsonLayer、PathLayer、PolygonLayer、IconLayer 或 TextLayer,并把它们组合到同一张 Mapbox 地图上。
🧱 点、线、面和标注
WebGIS 中常见的几何表达可以先按三类理解:点表示位置,线表示路径,面表示封闭区域。deck.gl 为它们提供了不同图层:
| Layer | 适合的数据 | 常见表达 |
|---|---|---|
ScatterplotLayer | 点坐标 | 站点、设备、POI |
PathLayer | 坐标数组 | 道路、航线、河流 |
PolygonLayer | 闭合坐标数组 | 区域、建筑轮廓 |
GeoJsonLayer | GeoJSON Feature 或 FeatureCollection | 标准点线面数据 |
IconLayer | 点坐标和图标信息 | 设备状态、方向标记 |
TextLayer | 点坐标和文字 | 名称、编号、标签 |
⚖️ deck.gl Layer 与 Mapbox Layer
Mapbox 可以通过 GeoJSON Source 和 fill、line、circle 等 Layer 绘制常规地图要素。deck.gl 也能绘制相同的几何类型,但它更适合数据量较大、样式需要按数据计算或需要 GPU 聚合和动画的场景。
可以这样思考:
底图样式、道路和常规少量业务图层 → Mapbox Layer
动态数据、复杂 accessor、大量点线面和动画 → deck.gl Layer
这不是硬性限制,实际选择还要看数据量、交互方式和现有地图样式。
🛠 最小组合示例
下面的图层全部通过同一个 MapboxOverlay 叠加到 Mapbox 地图上:
const layers = [
new PolygonLayer({
id: 'area',
data: areas,
getPolygon: (item) => item.polygon,
getFillColor: [245, 158, 11, 70],
}),
new PathLayer({
id: 'route',
data: routes,
getPath: (item) => item.path,
getColor: [16, 185, 129, 230],
getWidth: 8,
}),
new ScatterplotLayer({
id: 'stations',
data: stations,
getPosition: (item) => item.position,
getRadius: 500,
getFillColor: [37, 99, 235, 230],
}),
];
overlay.setProps({ layers });
同一张地图还可以叠加 GeoJsonLayer、IconLayer 和 TextLayer,分别承担边界、图标和文字标注的绘制:
如果两个填充面使用相同或非常接近的高度并且互相覆盖,深度缓冲区可能无法稳定判断前后关系,缩放时就会出现闪动。这种现象叫 z-fighting,通常应避免共面重叠,或明确设置图层的高度和绘制顺序。
💡 如何选择
- 数据已经是 GeoJSON,优先考虑
GeoJsonLayer,可以保留 Feature 的结构。 - 只有坐标数组时,点用
ScatterplotLayer,线用PathLayer,面用PolygonLayer。 - 图标需要根据数据切换时使用
IconLayer,名称和编号使用TextLayer。 - 需要和 Mapbox 的道路、地名保持同一张地图时,让 Mapbox 提供底图,让 deck.gl 提供业务图层。
🧾 小节总结
- 点、线、面分别对应 ScatterplotLayer、PathLayer 和 PolygonLayer。
- GeoJsonLayer 适合标准 GeoJSON 数据。
- IconLayer 和 TextLayer 用于图标与文字标注。
- Mapbox Layer 和 deck.gl Layer 是两套不同的图层系统。
❓ 知识问答
Q1:GeoJsonLayer 和 Mapbox 的 GeoJSON Layer 有什么区别?
前者是 deck.gl Layer,适合数据驱动的 GPU 绘制;后者是 Mapbox 样式图层,适合融入 Mapbox 的 source、filter 和样式系统。
Q2:一个地图可以同时放 Mapbox Layer 和 deck.gl Layer 吗?
可以。MapboxOverlay 会让 deck.gl 图层与 Mapbox 地图共享相机。
Q3:文字为什么可能被图形遮挡?
图层顺序和深度关系会影响可读性。通常先绘制面,再绘制线、点和文字,并根据需要调整图层顺序或深度设置。
🧪 小练习
- 给
PathLayer增加一条路径,观察它和 Mapbox 道路的空间关系。 - 给
TextLayer增加一个站点名称,并调整getPixelOffset。
🎉 现在你可以把多种 deck.gl 图层组合成一张有地图语境的可视化。
