首页 / deck.gl / API 文档

ScreenGridLayer

先看结论

以屏幕像素为单位划分网格，统计落格数据量，缩放时格子大小不变。

最后验证 2026-11-03 · deck.gl 9.0 · 更新 2026-10-27 · 引用本文

new deck.ScreenGridLayer(props)

参数

参数	默认	说明
`cellSizePixels`	`100`	格子边长，像素
`getPosition`	—	点坐标
`getWeight`	`1`	单点权重
`aggregation`	`'SUM'`	统计方式
`colorRange`	内置	色带
`colorDomain`	自动	固定值域，避免缩放时色标跳变
`gpuAggregation`	`true`	GPU 统计

示例

new deck.ScreenGridLayer({
  id: 'screen-grid',
  data: points,
  getPosition: function (d) { return [d.lng, d.lat]; },
  cellSizePixels: 18,
  getWeight: function (d) { return d.v; },
  colorDomain: [0, 200],
  colorRange: [
    [20, 40, 90, 160],
    [30, 110, 170, 190],
    [120, 200, 180, 210],
    [250, 210, 90, 230],
    [235, 90, 60, 240]
  ]
});

屏幕空间聚合的含义

同一格子在不同缩放层级覆盖的地理范围不同，统计值随之改变。这层聚合只回答「屏幕上哪里更密」，不能当作面积统计结果。

格子尺寸的选择

常规屏幕宽 1440 像素，cellSizePixels: 100 只有十几个格子，分布细节被抹平。10 到 20 之间比较常用；再小就会看到数据本身的锯齿。

截图对比要固定视口。窗口大小改变，格子划分随之改变，同一份数据两次截图会给出不同的分布形态。

引用本文

经纬志（2026）。《ScreenGridLayer》。https://www.jingweizhi.com/deckgl/api/screengrid-layer.html（访问日期 2026-11-03）。