deck.gl 是什么与第一个可视化
🎯 引言
学完这篇文章,你能用 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 负责地图与相机,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。
🧪 小练习
- 把
ScatterplotLayer的点数据增加到 5 个,观察它们如何覆盖在 Mapbox 底图上。 - 把
getFillColor改成橙色,并观察它只影响 deck.gl 点,不会修改 Mapbox 底图。
🎉 现在你已经建立了整门课程的核心认知:Mapbox 管地图,deck.gl 管数据图层。
