首页 / deck.gl / API 文档
BitmapLayer
先看结论
把一张图片铺在指定的经纬度范围里，常用来做单幅影像或瓦片底图。
new deck.BitmapLayer(props)
参数
| 参数 | 默认 | 说明 |
|---|---|---|
image | — | 图片地址、HTMLImageElement 或 canvas |
bounds | — | [西, 南, 东, 北] |
opacity | 1 | 整体透明度 |
desaturate | 0 | 去饱和程度，0 到 1 |
tintColor | [255,255,255] | 整体色调 |
transparentColor | — | 指定颜色视为透明，用于去底 |
示例
new deck.BitmapLayer({
id: 'image',
image: 'https://example.com/scan.png',
bounds: [116.2, 39.7, 116.6, 40.0],
opacity: 0.85,
desaturate: 0.4
});边界与坐标
bounds 的顺序是西、南、东、北，写成
[minLng, minLat, maxLng, maxLat]。
顺序颠倒时图片会翻转，看起来像数据整体镜像。
瓦片场景
单个 BitmapLayer 只画一张图。多层级瓦片用
TileLayer 调度，由 renderSubLayers
为每个瓦片创建一个 BitmapLayer。
跨域图片会画不出来。图片服务器需要允许 CORS， 否则画布被污染，纹理上传失败且控制台不报错。
经纬志（2026）。《BitmapLayer》。https://www.jingweizhi.com/deckgl/api/bitmap-layer.html（访问日期 2026-11-03）。