deck.gl 是什么与第一个可视化

理解 Mapbox 与 deck.gl 的职责分工,并在 Mapbox 地图上叠加第一个 ScatterplotLayer。

🎯 引言

学完这篇文章,你能用 Mapbox 提供地图和相机,用 deck.gl 在地图上绘制一组 GPU 点图层,并理解后续课程统一使用的技术结构。

🧱 deck.gl 的定位

deck.gl 是面向地理数据的 GPU 可视化框架,擅长把大量点、线、面、轨迹和聚合结果转换成可交互的图形。它通过 WebGL 使用 GPU 绘制图形,图层配置围绕“数据如何映射成图形”展开。

在真实 WebGIS 项目中,deck.gl 通常和地图引擎配合使用:

Mapbox:地图、底图、Camera、地图样式与地图事件
deck.gl:业务数据图层、GPU 属性、拾取、聚合与动画

deck.gl 也可以独立创建 Canvas,但本课程从第一篇开始统一采用 Mapbox + MapboxOverlay + deck.gl Layer。这样每篇文章都在有地理语境的地图上学习数据可视化。

🧩 MapboxOverlay:连接两套系统

MapboxOverlay 是 @deck.gl/mapbox 提供的适配层,作用是把 deck.gl 的 Layer 接入已经创建好的 Mapbox 地图。Mapbox 继续负责底图和相机,Overlay 接收 deck.gl 图层,并让它们跟随地图的拖动、缩放和旋转。

代码中的 map.addControl(overlay) 把适配层挂到地图上,overlay.setProps({ layers }) 则负责告诉 deck.gl 当前要绘制哪些业务图层。涉及共享 WebGL、图层顺序和事件分工时,还需要进一步理解 interleaved。

📦 安装依赖

示例使用 Node.js 22.9.0,主要包版本为 mapbox-gl@3.14.0、@deck.gl/core@9.4.0、@deck.gl/layers@9.4.0 和 @deck.gl/mapbox@9.4.0:

npm install mapbox-gl@3.14.0 @deck.gl/core@9.4.0 @deck.gl/layers@9.4.0 @deck.gl/mapbox@9.4.0

代码中的 MAPBOX_TOKEN 代表你已经准备好的 Mapbox 公共访问 Token。

⚖️ Mapbox、deck.gl 与 Three.js

Mapbox 是地图引擎,负责道路、地名、底图样式和相机;deck.gl 是数据可视化框架,负责把业务数据绘制成点、线、面和 3D 图形。两者可以同时存在,但 Mapbox Layer 和 deck.gl Layer 是两套不同的图层系统。

Three.js 更偏向通用 3D 场景,可以自由组织模型、灯光、材质和动画。需要表达城市点位、路径、行政区、热力或轨迹等结构化地理数据时,deck.gl 的数据驱动图层更直接;需要制作高度自定义的 3D 场景时,再考虑 Three.js。

🚀 第一个 Mapbox + deck.gl 图层

下面的代码保留了 Mapbox 初始化的必要部分,重点观察 MapboxOverlay 和 ScatterplotLayer:

import mapboxgl from 'mapbox-gl';
import { MapboxOverlay } from '@deck.gl/mapbox';
import { ScatterplotLayer } from '@deck.gl/layers';

mapboxgl.accessToken = MAPBOX_TOKEN;

const map = new mapboxgl.Map({
    container: 'map',
    style: 'mapbox://styles/mapbox/light-v11',
    center: [116.42, 39.91],
    zoom: 9.5,
});

const overlay = new MapboxOverlay({
    interleaved: true,
    layers: [],
});

map.addControl(overlay);

overlay.setProps({
    layers: [new ScatterplotLayer({
        id: 'stations',
        data: [
            { position: [116.36, 39.88] },
            { position: [116.42, 39.91] },
            { position: [116.48, 39.94] },
        ],
        getPosition: (item) => item.position,
        getRadius: 500,
        getFillColor: [37, 99, 235, 220],
    })],
});

map 负责显示底图和控制相机,overlay 是 Mapbox 与 deck.gl 之间的适配层,ScatterplotLayer 只关心点数据和点的样式。拖动、缩放或旋转地图时,deck.gl 图层会跟随 Mapbox 相机移动。

下面是同一结构在页面中的真实效果:

示例需要 Mapbox Token 才能加载底图。组件未配置 Token 时会显示配置提示,不会绘制一个脱离地图的独立 Canvas。

🧾 小节总结

  • Mapbox 负责地图与相机,deck.gl 负责业务数据可视化。
  • MapboxOverlay 把 deck.gl 图层接入 Mapbox 地图。
  • ScatterplotLayer 用数据和 accessor 绘制点。
  • 本课程后续示例默认使用 MapboxOverlay,地图视角由 Mapbox 管理。

❓ 知识问答

Q1:deck.gl 是 Mapbox 的一个普通图层吗?

不是。deck.gl 是独立的 GPU 可视化框架,MapboxOverlay 只是让它能够和 Mapbox 地图协作。

Q2:为什么示例里没有 initialViewState?

这里使用 Mapbox 模式,中心点和缩放级别由 Mapbox 的 center、zoom 等相机参数管理。

Q3:什么时候会直接使用 Deck?

需要脱离地图引擎绘制独立可视化画布时可以使用 standalone Deck。本课程的 WebGIS 示例统一使用 MapboxOverlay。

🧪 小练习

  1. 把 ScatterplotLayer 的点数据增加到 5 个,观察它们如何覆盖在 Mapbox 底图上。
  2. 把 getFillColor 改成橙色,并观察它只影响 deck.gl 点,不会修改 Mapbox 底图。

🎉 现在你已经建立了整门课程的核心认知:Mapbox 管地图,deck.gl 管数据图层。