常用基础图层

在 Mapbox 底图上使用 deck.gl 绘制点、线、面、图标和文字。

🎯 引言

学完这篇文章,你能根据数据的几何类型选择 ScatterplotLayer、GeoJsonLayer、PathLayer、PolygonLayer、IconLayer 或 TextLayer,并把它们组合到同一张 Mapbox 地图上。

🧱 点、线、面和标注

WebGIS 中常见的几何表达可以先按三类理解:点表示位置,线表示路径,面表示封闭区域。deck.gl 为它们提供了不同图层:

Layer适合的数据常见表达
ScatterplotLayer点坐标站点、设备、POI
PathLayer坐标数组道路、航线、河流
PolygonLayer闭合坐标数组区域、建筑轮廓
GeoJsonLayerGeoJSON 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:文字为什么可能被图形遮挡?

图层顺序和深度关系会影响可读性。通常先绘制面,再绘制线、点和文字,并根据需要调整图层顺序或深度设置。

🧪 小练习

  1. 给 PathLayer 增加一条路径,观察它和 Mapbox 道路的空间关系。
  2. 给 TextLayer 增加一个站点名称,并调整 getPixelOffset。

🎉 现在你可以把多种 deck.gl 图层组合成一张有地图语境的可视化。