经纬志
首页 / deck.gl / 使用示例

碰撞避让

标签密集时自动隐藏相互重叠的低优先级项,只保留重要地名。避让在 GPU 侧完成,不需要预先排版。

deck.gl 9.0 · 更新 2026-10-28
源码与运行效果
运行效果

说明

CollisionFilterExtension 给每个文本实例做包围盒测试,getCollisionPriority 越大越先保留。collisionGroup 相同的图层共享一套避让结果。

关闭 collisionEnabled 可以对比有无避让的差别,方便调参。

配置作用
extensionsCollisionFilterExtension 提供避让能力
collisionEnabled总开关
collisionGroup同组图层共享避让结果
getCollisionPriority0 到 1,越大越优先

优先级不要都设成同一个值,否则保留谁取决于渲染顺序,缩放时会出现标签闪烁。