Layer、Data 与 Accessor 核心模型
🎯 引言
学完这篇文章,你能把业务数据映射成点的位置、颜色和大小,并通过 MapboxOverlay 更新地图上的 deck.gl 图层。
🧱 Layer、data 与 id
deck.gl 的 Layer 是一份“如何绘制数据”的声明。data 提供业务记录,id 标识当前图层,其他配置决定每条记录应该变成什么图形。
const layer = new ScatterplotLayer({
id: 'stations',
data: stations,
getPosition: (station) => [station.lng, station.lat],
});
id 需要在同一组图层中保持稳定。更新数据时,通常重新创建新的 Layer 配置,再把完整的图层数组交给 overlay.setProps,deck.gl 会根据 id 比较并复用可以复用的 GPU 资源。
⚡ Accessor 如何映射数据
Accessor 是从一条数据记录中取出图形属性的函数。常用 accessor 包括:
getPosition:返回[longitude, latitude],表示点的位置。getFillColor:返回 RGB 或 RGBA 数组,表示填充颜色。getRadius:返回点的大小,具体单位由radiusUnits决定。
常量 accessor 表示所有数据使用同一个值:
getRadius: 120,
getFillColor: [37, 99, 235, 220],
函数 accessor 可以根据当前数据记录计算值:
getRadius: (station) => station.value * 10,
getFillColor: (station) => station.value > 50
? [220, 38, 38, 220]
: [37, 99, 235, 220],
Mapbox 不会读取 data 或 accessor。它只提供地图空间和相机,数据到 GPU 属性的转换由 deck.gl Layer 完成。
🛠 在 MapboxOverlay 中使用
const layer = new ScatterplotLayer({
id: 'stations',
data,
getPosition: (item) => [item.lng, item.lat],
getRadius: (item) => item.value * 10,
getFillColor: (item) => item.value > 50
? [255, 0, 0, 220]
: [0, 120, 255, 220],
});
overlay.setProps({
layers: [layer],
});
下面的点大小和颜色都由 level 字段计算,底图仍然由 Mapbox 提供:
🪤 常见错误
getPosition 返回的经纬度顺序必须是 [longitude, latitude]。如果把它写成 [latitude, longitude],图形通常会出现在完全错误的位置。
另外,getRadius 的数值含义取决于 radiusUnits。默认地理单位适合表达空间半径,pixels 更适合让屏幕上的点保持固定大小,选择时要结合地图缩放行为。
🧾 小节总结
- Layer 描述绘制方式,data 提供业务记录,id 标识图层。
- Accessor 把字段转换成位置、颜色、大小等 GPU 属性。
- 常量 accessor 适合统一样式,函数 accessor 适合按记录计算。
overlay.setProps({ layers })是 Mapbox 模式下更新 deck.gl 图层的入口。
❓ 知识问答
Q1:Mapbox 会处理 deck.gl 的 data 吗?
不会。Mapbox 负责地图和相机,deck.gl Layer 负责读取 data 并生成 GPU 属性。
Q2:为什么 Layer 要有稳定的 id?
deck.gl 用它判断新旧配置是否属于同一个图层,从而复用资源并更新变化的属性。
Q3:一个字段可以同时控制颜色和大小吗?
可以。同一个字段可以分别被 getFillColor 和 getRadius 读取,只要两个 accessor 返回各自要求的类型。
🧪 小练习
- 把
getRadius改成item.level * 12,观察点大小变化。 - 增加一个
value字段,让颜色在低值和高值之间切换。
🎉 你已经掌握了 deck.gl 最重要的数据映射模型。
