Layer、Data 与 Accessor 核心模型

在 MapboxOverlay 中理解 deck.gl Layer、业务数据和 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 返回各自要求的类型。

🧪 小练习

  1. 把 getRadius 改成 item.level * 12,观察点大小变化。
  2. 增加一个 value 字段,让颜色在低值和高值之间切换。

🎉 你已经掌握了 deck.gl 最重要的数据映射模型。