Cesium 获取某点地形高度
在地理信息系统 (GIS) 和三维可视化应用中,获取地形高度(即某个地理位置的海拔高度)是一个常见的需求。Cesium 是一个强大的开源 JavaScript 库,用于构建 3D 地图和可视化应用,能够处理来自不同数据源的地形和影像数据。本文将介绍如何在 Cesium 中获取某个点的地形高度。
一、Cesium 简介
Cesium 是一个 WebGL-based 的开源库,能够在网页上创建 3D 地球或地图应用。它支持地形、影像、3D 模型的加载,能够实时渲染复杂的地理空间数据。Cesium 支持多种数据源,如 Google Earth、Bing Maps、OpenStreetMap,以及用户自定义的地理数据。
二、地形高度概念
地形高度指的是某个位置相对于海平面的高度。常见的地形数据源包括 SRTM(Shuttle Radar Topography Mission)和其他地形模型(例如,来自 Cesium ion 的高精度数据)。
三、获取地形高度的基本步骤
要在 Cesium 中获取某个点的地形高度,通常需要通过 Cesium 的 SampledPositionProperty 或者 Terrain 服务来获取该点的实际地面高度。以下是获取地形高度的步骤:
Cesium.sampleTerrainMostDetailed
是 Cesium 提供的一个 API,用于从指定的地形数据提供者 (terrainProvider
) 获取一组位置的高精度地形高度。这通常用于需要高分辨率地形数据的场景。它通过与地形数据源交互,获取最详细(最高分辨率)的地形高度数据。
函数定义
Cesium.sampleTerrainMostDetailed(terrainProvider, positions)
参数说明
- TerrainProvider:
- 这个参数是一个
TerrainProvider
对象,表示地形数据源。常见的地形数据源有Cesium.createWorldTerrain()
(全球地形数据)等。
- 这个参数是一个
- Positions:
- 这是一个包含位置的数组,位置可以是
Cesium.Cartographic
对象的数组。每个位置由经度、纬度和高度组成。通常,这些位置是经纬度坐标,表示你想获取地形高度的点。
- 这是一个包含位置的数组,位置可以是
返回值
- 返回一个
Promise
对象,解析后返回一个包含Cesium.Cartesian3
坐标的数组。每个坐标对应输入位置的精确地形高度。
使用场景
Cesium.sampleTerrainMostDetailed
方法适用于需要从地形提供者那里获取精确的地形高度的场景,例如:
- 获取多个点的海拔高度。
- 用于路径规划和分析时的高度数据采集。
- 需要更精确细节的地形数据(高分辨率地形)时。
示例代码
下面是一个示例,展示了如何使用 Cesium.sampleTerrainMostDetailed
获取多个点的地形高度。
示例步骤:
- 创建一个 Cesium Viewer 实例,并初始化地形数据源。
- 设置一组经纬度坐标,然后使用
sampleTerrainMostDetailed
获取这些位置的地形高度。
<!DOCTYPE html>
<html lang="zh">
<head>
<meta charset="UTF-8">
<title>Cesium sampleTerrainMostDetailed 示例</title>
<script src="https://cesium.com/downloads/cesiumjs/releases/1.100/Build/Cesium/Cesium.js"></script>
<link href="https://cesium.com/downloads/cesiumjs/releases/1.100/Build/Cesium/Widgets/widgets.css" rel="stylesheet">
<style>
#cesiumContainer {
width: 100%;
height: 100vh;
}
</style>
</head>
<body>
<div id="cesiumContainer"></div>
<script>
// 初始化 Cesium Viewer
var viewer = new Cesium.Viewer('cesiumContainer', {
terrainProvider: Cesium.createWorldTerrain() // 使用 Cesium 提供的全球地形数据
});
// 定义要获取高度的经纬度坐标
var positions = [
Cesium.Cartographic.fromDegrees(116.3911, 39.9067), // 北京
Cesium.Cartographic.fromDegrees(118.2437, 34.0522), // 洛杉矶
Cesium.Cartographic.fromDegrees(139.6917, 35.6895) // 东京
];
// 获取这些位置的精确地形高度
Cesium.sampleTerrainMostDetailed(viewer.terrainProvider, positions).then(function(updatedPositions) {
updatedPositions.forEach(function(position, index) {
console.log('位置 ' + (index + 1) + ' 的海拔高度为:' + position.height.toFixed(2) + ' 米');
});
}).catch(function(error) {
console.log('获取地形高度时发生错误:', error);
});
</script>
</body>
</html>
代码解析
-
创建
Cesium.Viewer
实例:var viewer = new Cesium.Viewer('cesiumContainer', { terrainProvider: Cesium.createWorldTerrain() });
这里我们初始化了一个 Cesium Viewer,并指定了全球地形数据源
Cesium.createWorldTerrain()
。 -
定义位置数组:
var positions = [ Cesium.Cartographic.fromDegrees(116.3911, 39.9067), // 北京 Cesium.Cartographic.fromDegrees(118.2437, 34.0522), // 洛杉矶 Cesium.Cartographic.fromDegrees(139.6917, 35.6895) // 东京 ];
我们定义了一个包含多个经纬度的数组,这些点分别位于北京、洛杉矶和东京。
-
调用
sampleTerrainMostDetailed
获取地形高度:Cesium.sampleTerrainMostDetailed(viewer.terrainProvider, positions).then(function(updatedPositions) { updatedPositions.forEach(function(position, index) { console.log('位置 ' + (index + 1) + ' 的海拔高度为:' + position.height.toFixed(2) + ' 米'); }); }).catch(function(error) { console.log('获取地形高度时发生错误:', error); });
sampleTerrainMostDetailed
方法将返回包含Cesium.Cartesian3
坐标的数组,其中每个Cartesian3
对象包含了相应位置的经纬度和精确的地形高度(height
属性)。.then()
回调处理返回的数据,在控制台打印出每个位置的海拔高度。.catch()
捕获错误,确保在出现问题时有适当的处理。
注意事项
- 精度问题:
- 该方法返回的高度是来自最详细的地形数据(如果有的话)。但是,地形数据的精度依赖于所使用的地形提供者。如果使用的是低分辨率的地形数据,可能无法提供非常精确的结果。
- 地形数据可用性:
- 某些地区可能没有详细的地形数据,尤其是在偏远地区。如果
sampleTerrainMostDetailed
无法获取数据,height
属性可能会返回undefined
,需要额外的错误处理。
- 某些地区可能没有详细的地形数据,尤其是在偏远地区。如果
- 性能问题:
- 对于大范围内的多个位置调用
sampleTerrainMostDetailed
可能会导致性能问题,因为每个请求都需要与服务器进行交互。通常最好将多个请求批量处理,而不是频繁的单点请求。
- 对于大范围内的多个位置调用
总结
Cesium.sampleTerrainMostDetailed
是一个用于获取多个地理位置精确地形高度的函数,非常适合用于需要高精度地形数据的场景。它通过提供对地形数据源的精确访问,帮助开发者实现更精细的地理信息分析。
TilesBuilder: TilesBuilder提供一个高效、兼容、优化的数据转换工具,一站式完成数据转换、数据发布、数据预览操作。