经纬志
首页 / Cesium / 使用示例

采样模型表面高度

用 sampleHeight 读取渲染结果的高度,把标注贴到模型表面。

CesiumJS 1.121 · 更新 2026-10-28
源码与运行效果
运行效果

sampleHeight 读的是什么

它读取当前渲染结果的高度值,包括地形、模型和 3D Tiles。传入的是经纬度(Cartographic),返回米,采样不到时返回 undefined。

为什么等一帧

模型加载是异步的,刚加入场景时还没参与渲染,采样会全部落空。示例等到第一次 postRender 之后再采样,保证模型已经在画面里。

接口入参返回
scene.sampleHeightSupported—布尔能力位
scene.sampleHeight(carto)Cartographic高度或 undefined
Cartographic.fromCartesianCartesian3世界坐标转经纬度

采样是逐点调用的,几百个点就会明显卡顿;大面积贴附更适合用贴地图元或瓦片属性,而不是密集采样。