首页 / deck.gl / API 文档
MapView
先看结论
最常用的视图类型。把经纬度映射到 Web Mercator 平面并处理相机变换。
new deck.MapView(props)
参数
| 参数 | 默认 | 说明 |
|---|---|---|
controller | true | 控制器对象可配置具体的交互 |
repeat | false | 东西方向重复绘制整个世界 |
nearFarScale | 1 | 近远裁剪面缩放，深度冲突时调大 |
fovy | 50 | 视场角，影响透视强度 |
padding | null | 适配范围时预留的内边距 |
控制器常用配置
| 键 | 含义 |
|---|---|
dragPan | 拖拽平移 |
dragRotate | 拖拽旋转，二维场景关掉 |
scrollZoom | 滚轮缩放 |
doubleClickZoom | 双击放大 |
minZoom / maxZoom | 缩放区间 |
inertia | 惯性滑动，移动端体验更顺 |
touchRotate | 双指旋转 |
与瓦片底图
MapView 使用 Web Mercator，瓦片地址模板里的
{z}/{x}/{y} 与之对应。底图不是同一个投影时，
数据会系统性地偏移，靠调整 modelMatrix 硬凑并不可取。
new deck.Deck({
views: new deck.MapView({ repeat: true }),
initialViewState: { longitude: 0, latitude: 0, zoom: 1 }
});repeat 打开后拾取也重复。同一个要素在西侧与东侧各有一份， 点击统计不能只按下标去重，要按数据 id 去重。
经纬志（2026）。《MapView》。https://www.jingweizhi.com/deckgl/api/map-view.html（访问日期 2026-11-03）。