Cesium 类

Math

方法	描述
Cesium.Math.toDegrees(radians)	将弧度转换为角度
Cesium.Math.toRadians(degrees)	将角度转换为弧度
Cesium.Math.randomBetween(min, max)	生成一个指定范围内的随机数
Cesium.Math.clamp(value, min, max)	将一个值限制在指定范围内
Cesium.Math.lerp(p, q, time)	计算两个值的线性插值

toDegrees

// 弧度 -> 角度
const degrees = Cesium.Math.toDegrees(Math.PI)
console.log(degrees) // 180

// 角度 -> 弧度
const radians = Cesium.Math.toRadians(180)
console.log(radians) // 3.14159265358979

randomBetween

const random = Cesium.Math.randomBetween(1, 10)
console.log(random)

clamp

const value = 15
const clamp = Cesium.Math.clamp(value, 0, 10)
console.log("clamp", clamp) // 10

lerp

const lerp = Cesium.Math.lerp(0, 2, 5)
console.log(lerp) // 10

Ellipsoid

方法	描述
Cesium.Ellipsoid.WGS84	表示WGS84标准椭球体
Cesium.Ellipsoid.WGS84.cartesianToCartographic(cartesian3)	将笛卡尔坐标转换为经纬度弧度坐标

笛卡尔转经纬度弧度

// 经纬度 -> 笛卡尔
const cartesian3 = Cesium.Cartesian3.fromDegrees(114, 30, 2000)
// 笛卡尔 -> 经纬度（弧度）
const cartographicPosition =
      Cesium.Ellipsoid.WGS84.cartesianToCartographic(cartesian3)
// 弧度 -> 角度
const lon = Cesium.Math.toDegrees(cartographicPosition.longitude)
const lat = Cesium.Math.toDegrees(cartographicPosition.latitude)
const height = cartographicPosition.height
console.log(lon) // 114.00000000000001
console.log(lat) // 30.00000000000001
console.log(height) // 2000.0000000002346

js

sampleTerrain

sampleTerrain 方法用于从 地形数据中采样特定位置高度 的方法。

语法：

Cesium.sampleTerrain(terrainProvider, level, positions, rejectOnTileFail)

参数：

参数	描述
terrainProvider	地图中使用的地形 provider
level	查询地形的层次细节
positions	要查询地形中高度的位置点坐标，可以数组存放多个
rejectOnTileFail	默认为 false。为 true 时，若地形高度请求失败，则 Promise 直接抛出错误，为 false 时，则为 undefined

// 地形Provider
const terrainProvider = await Cesium.createWorldTerrainAsync({
  requestVertexNormals: true,
  requestWaterMask: true,
});

const viewer = new Cesium.Viewer("cesiumContainer", {
  infoBox: false,
  terrainProvider: terrainProvider,
});

// positions可以是多个点的集合
const positions = [Cesium.Cartographic.fromDegrees(86.925145, 27.988257)];
const updatedPositions = await Cesium.sampleTerrain(terrainProvider, 11, positions);

console.log(`当前点的高度是 ${updatedPositions[0].height} 米`);

CustomDataSource

CustomDataSource 是 Cesium 中的一个数据源类，允许你将 自定义的空间数据（例如点、线、面等）添加到场景中。

const viewer = new Cesium.Viewer("cesiumContainer", {
  infoBox: false,
});

const customDataSource = new Cesium.CustomDataSource("myDataSource");

// 将自定义数据源添加到viewer
viewer.dataSources.add(customDataSource);
// 移除所有数据源
viewer.dataSources.removeAll();

还可以向 customDataSource 中添加 Entity 实体：

const viewer = new Cesium.Viewer("cesiumContainer", {
  infoBox: false,
});

const customDataSource = new Cesium.CustomDataSource("myDataSource");
// 将自定义数据源添加到viewer
viewer.dataSources.add(customDataSource);

// 想数据源中添加一个点
const entity = customDataSource.entities.add({
  id: "1001",
  name: "Point_1001",
  position: Cesium.Cartesian3.fromDegrees(114.169, 22.319, 100),
  point: {
    pixelSize: 10,
    color: Cesium.Color.RED,
  },
  label: {
    text: "Point_1001",
    font: "14pt sans-serif",
    fillColor: Cesium.Color.WHITE,
  },
});

// 允许随时更新实体对象
entity.position = Cesium.Cartesian3.fromDegrees(120.0, 30.0, 200);
entity.point.pixelSize = 15;

// 获取实体
const entityById = customDataSource.entities.getById("1001");
// 获取所有实体
const entities = customDataSource.entities.values;

// 移除已添加的实体
customDataSource.entities.remove(entity);
// 移除所有已添加的实体
customDataSource.entities.removeAll();