【Cesium入门教程】第三篇：Cesium 实体(Entity)与数据源(DataSources)

往期回顾：

【Cesium入门教程】第一篇：Cesium简介与快速入门

【Cesium入门教程】第二篇：基础操作与地图控制

1、实体(Entity)的概念

在Cesium中，实体(Entity)是用来描述具有几何形状和属性的对象的基类。实体可以是点、线、面、模型等，它们可以包含额外的信息，如名称、描述和标签。实体在Cesium中非常有用，因为它们可以被轻松地添加、更新和删除，从而为场景添加丰富的交互性。

添加实体

下面是如何在Cesium中添加一个点实体的示例：

constpointEntity = viewer.entities.add({
   position:Cesium.Cartesian3.fromDegrees(103.1, 25.0),
   point:{
       color:Cesium.Color.YELLOW,
       pixelSize:10,
   },
   name:'Sample Point',
   description:'This is a description for the sample point.'
});

在这个例子中，我们创建了一个点实体，并设置了其位置、颜色、大小和描述。

删除实体

删除实体可以通过调用remove方法来实现：

viewer.entities.remove(pointEntity);

CallbackProperty

Cesium中的CallbackProperty允许开发者定义一个回调函数，这个函数可以在每个帧中被调用，以动态地更新实体的属性。这对于创建动态效果非常有用，例如：

constdynamicPoint = viewer.entities.add({
   position:newCesium.CallbackProperty(() => {
       consttime = Cesium.JulianDate.now();
       constx = Cesium.Math.lerp(Cesium.Cartesian2.fromDegrees(102.0,20.0), Cesium.Cartesian2.fromDegrees(103.0,25.0), (time.secondsOfDay %86400) /86400);
       returnCesium.Cartesian3.fromDegrees(x.y, x.x);
   },false),
   point: {
       color: Cesium.Color.CYAN,
       pixelSize:10,
   }
});

上述代码创建了一个随时间动态变化位置的点实体。

2、数据源(DataSources)

数据源是Cesium中用于加载和管理地理数据的组件。它可以处理多种格式的数据，包括GeoJSON、TopoJSON、KML和CZML。

加载GeoJSON数据

GeoJSON是一种编码各种地理数据结构的JSON格式。以下是如何加载GeoJSON数据的示例：

constgeoJsonData ={
   "type":"FeatureCollection",
   "features":[
       {
           "type":"Feature",
           "geometry":{
               "type":"Point",
               "coordinates":[-122.39,47.5]
           }
       }
   ]
};
constgeoJsonPromise =Cesium.GeoJsonDataSource.load(geoJsonData);
geoJsonPromise.then(function(dataSource) {
   viewer.dataSources.add(dataSource);
   viewer.zoomTo(dataSource);
});

加载TopoJSON数据

TopoJSON是GeoJSON的一种扩展，它通过整合共享边来减少数据冗余。加载TopoJSON数据的步骤与GeoJSON类似，但需要指定TopoJSON数据源：

consttopoJsonPromise =Cesium.GeoJsonDataSource.load('path/to/topojson.data');
topoJsonPromise.then(function(dataSource) {
   viewer.dataSources.add(dataSource);
   viewer.zoomTo(dataSource);
});

加载KML数据

KML是Google Earth使用的地理数据格式。在Cesium中加载KML数据，可以使用KmlDataSource：

constkmlPromise =Cesium.KmlDataSource.load('path/to/placemark.kml');
kmlPromise.then(function(dataSource) {
   viewer.dataSources.add(dataSource);
   viewer.zoomTo(dataSource);
});

加载CZML数据

CZML是专为Cesium设计的动态数据格式，它使用JSON数组来描述随时间变化的图形属性：

constczmlPromise =Cesium.CzmlDataSource.load('path/to/document.czml');
czmlPromise.then(function(dataSource) {
   viewer.dataSources.add(dataSource);
   viewer.trackedEntity = dataSource.entities.getById('ID_of_Entity');
});

在上述示例中，除了加载CZML数据源，我们还设置了trackedEntity，这允许相机自动跟踪数据源中的特定实体。

3、结语

本教程详细介绍了Cesium中的实体和数据源的概念、创建、加载和删除方法。

实体和数据源是Cesium中进行地理数据可视化的基础，它们为创建动态和交互式地图提供了强大的工具。

理解这些概念对于开发复杂的Cesium应用十分重要。

想学习更多高级cesium开发技能可以了解特训营的课程内容