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

从瓦片采样高度

用 sampleHeight 在瓦片集表面取高度,把标记贴到任意曲面。

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

采样的前提

瓦片必须已经渲染过,否则 sampleHeight 返回 undefined。示例等第一帧 postRender 之后再采样,确保瓦片已经在深度缓冲里。

采样范围

只在当前视锥与已加载的瓦片范围内有效,把相机移开后采样值可能变空。批量采样前先确认 sampleHeightSupported 为 true。

接口参数说明
sampleHeight(carto)Cartographic返回米或 undefined
Cartographic.fromCartesian世界坐标转经纬度
sampleHeightSupported—浏览器能力

采样开销随点数线性增长,几百个点会明显拖慢帧率;成片贴附应改用几何贴合或后处理描边。