setTerrain 之后地面还是平的

现象

map.setTerrain({ source: 'terrain', exaggeration: 1.5 }) 执行成功， 但画面没有高度变化。map.getTerrain() 返回对象，说明配置已被接受。 有时控制台报：

Error: Source "terrain" cannot be used as terrain because it is not a raster-dem source.

原因

encoding 有两个取值：terrarium 与 mapbox。 两者解码公式不同，用错时高程会被算成几十米到几千米的偏差。

排查过程

先确认源类型和编码，再确认是否真的取到了瓦片：

var src = map.getSource('terrain');
console.log('源类型', src.type);
console.log('地形配置', map.getTerrain());
map.on('error', function (e) { console.error(e.error && e.error.message); });

用瓦片地址单独下载一张 DEM，检查 PNG 的尺寸与像素值。 256×256 对应 tileSize: 256，512×512 对应 512，不能凭经验填。

解决方案

明确声明 raster-dem、编码与瓦片尺寸，并给足最大级别：

map.addSource('terrain', {
  type: 'raster-dem',
  tiles: ['https://dem.example.cn/{z}/{x}/{y}.png'],
  encoding: 'terrarium',      // 按数据生产方确认
  tileSize: 256,
  minzoom: 0,
  maxzoom: 12,
  attribution: 'DEM © Example'
});

map.setTerrain({ source: 'terrain', exaggeration: 1.5 });

地形生效后，倾斜视角才能看出来。给一个初始俯仰角，避免用户以为没加载：

map.setPitch(55);
map.setBearing(20);

建筑需要贴地时，给 fill-extrusion 图层打开垂直贴地：

map.addLayer({
  id: 'buildings-3d',
  type: 'fill-extrusion',
  source: 'buildings',
  paint: {
    'fill-extrusion-height': ['get', 'height'],
    'fill-extrusion-base': ['get', 'min_height'],
    'fill-extrusion-color': '#c9d3dd',
    'fill-extrusion-opacity': 0.9
  }
});

验证

把 exaggeration 从 1 调到 2，同一机位下山体轮廓明显变化。 在地形起伏大的区域，建筑底部与坡面贴合，不出现悬空。 map.getTerrain() 的 source 与设置一致。