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

叠加 MapLibre 底图

deck 图层挂在 MapLibre 的相机上,底图负责地理语境,deck 负责数据,两者共享同一套经纬度与视角。

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

说明

MapboxOverlay 是一个控件,通过 addControl 加入地图。interleaved 为 false 时 deck 用独立画布叠在底图之上,不要求底图支持自定义图层。

视角变化由 MapLibre 驱动,deck 只接收相机状态,因此俯仰与朝向和底图完全一致。悬停提示走 deck 自己的拾取。

配置作用
interleavedfalse 时独立画布叠加,兼容性最好
layers数据层由 deck 管理,与底图图层互不干扰
getTooltip悬停提示走 deck 的拾取
addControl控件生命周期跟随地图

要做三维遮挡(比如楼体挡住飞线)才需要 interleaved: true,此时底图必须支持自定义图层,样式也要同步调整。