Cesium入门之十一：认识Cesium中的Entity

Entity类简介

Entity类是Cesium中描述和呈现地球上实体对象的核心类。它具有丰富的属性和方法，用于控制和定制地理实体的外观和行为。Entity对象可以表示各种地理实体，如点、线、面等，并具有位置、方向、模型、标牌、折线、多边形等属性，通过设置这些属性可以实现各种类型的地理可视化。此外，Entity类还提供了其他一些常用的方法和属性，如描述信息、可见性和自定义属性等。通过使用Entity类，可以在Cesium中创建并定制地球上的实体对象，以实现复杂的地理可视化和交互效果。

Entity在Cesium中的作用

Entity是Cesium中非常重要的类，它为我们提供了一种灵活、强大的方式来描述、呈现和操控地球上的实体对象。通过Entity，我们可以利用Cesium强大的功能和多样化的图形对象，创建出下面这些丰富、生动的地理可视化场景。

1. 地理信息表达：Entity允许我们以更直观和语义化的方式来表达地理信息。通过设置Entity的位置、方向、形状、样式等属性，我们可以创建点、线、面等各种类型的地理实体，并将它们与具体的坐标和视觉效果联系起来。
2. 可视化呈现：使用Entity，我们可以在地球上以图形、模型、标牌等多种形式呈现地理实体，从而实现地理可视化。Entity提供了丰富的图形对象，如点（Point）、线（Polyline）、面（Polygon）、模型（Model）等，它们允许我们灵活地控制实体的外观和样式。
3. 动态更新：Entity支持实时动态更新，可以通过设置位置、方向等属性的回调函数来实现地理实体的实时更新。这样，我们可以根据实时数据或交互操作来改变实体的状态，从而实现实时演示、动画效果等。
4. 交互与事件处理：Entity允许我们为地理实体设置事件处理函数，例如鼠标点击、悬停等事件。通过监听这些事件，我们可以实现与实体的交互，例如弹出信息窗体、高亮选中的实体、执行相关操作等。
5. 扩展与自定义：通过继承Entity类，我们可以扩展和自定义实体的功能。可以通过添加新的属性、方法和事件处理函数，来满足特定需求或实现定制化的地理实体。

Entity的常用属性

1. id：用于唯一标识Entity的字符串。可以根据需要设置自定义的ID，方便后续对Entity进行查找和操作。
2. name：用于描述Entity的名称，通常作为标签或标识符展示在地图或场景中。
3. position：描述Entity的位置。可以是一个Cartesian3对象，表示地理坐标的三维位置，或是一个回调函数，动态更新位置。
4. orientation：描述Entity的方向。可以是一个Quaternion对象，表示Entity的旋转方向，或是一个回调函数，动态更新方向。
5. model：描述Entity的3D模型。可以使用ModelGraphics对象设置模型的URI、缩放比例、颜色等属性。
6. billboard：描述Entity的标牌。可以使用BillboardGraphics对象设置标牌的图片、大小、颜色等属性。
7. polyline：描述Entity的折线。可以使用PolylineGraphics对象设置折线的位置、颜色、宽度等属性。
8. polygon：描述Entity的多边形。可以使用PolygonGraphics对象设置多边形的位置、颜色、透明度等属性。
9. description：描述Entity的详细信息。可以是纯文本或使用HTML格式的富文本。通常用于显示实体的描述、属性或其他相关信息。
10. show：控制Entity的可见性。可以设置为true或false来显示或隐藏Entity。

使用Entity创建点、线、面

在Cesium中，Entity对象是一个可视化图形对象，可以用于在地球上显示各种类型的实体，如点、线、面等。它具有各种属性，可用于定义实体的位置、形状、样式等。常用的Entity图形对象和其属性如下：

常用的Entity图形对象及其属性

1. 点（Point）:
   • position：实体的位置。可以使用Cesium.Cartesian3.fromDegrees或其他方法来指定地理位置。
   • point：用于定义点的样式，包括pixelSize（像素大小），color（颜色）等属性。
2. 线（Polyline）:
   • polyline：用于定义线的形状和样式。包括positions（点的位置数组），width（宽度），material（材质）等属性。
3. 面（Polygon）:
   • polygon：用于定义面的形状和样式。包括hierarchy（点的位置数组），extrudedHeight（拉伸高度），material（材质）等属性。
4. 模型（Model）:
   • model：用于定义模型的URL，即加载的模型文件路径。
   • position：模型的位置。
   • orientation：模型的方向。
   • scale：模型的比例。
   • minimumPixelSize：模型的最小显示大小。
5. 标签（Label）：
   • label：用于定义标签的属性，包括text（文本内容），font（字体），pixelOffset（偏移量）等。

创建点、线、面的方法

创建点

通过在Entity中配置point属性来创建点，代码如下：

// 创建一个点
const pointEntity = new Cesium.Entity({
  position:Cesium.Cartesian3.fromDegrees( -74.01881302800248,40.69114333714821),
  point:{
    pixelSize:10,
    color:Cesium.Color.RED
  }
})

创建线

通过在Entity中配置polyline属性来创建线，代码如下：

// 创建一个线实体
const lineEntity = new Cesium.Entity({
  polyline: {
    positions: Cesium.Cartesian3.fromDegreesArray([
      -75.61777, 40.03883,
      -80.42087, 25.79065
    ]),
    width: 5,
    material: Cesium.Color.BLUE
  }
})

创建面

通过在Entity中配置polygon属性来创建面，代码如下：

// 创建一个面实体
const polygonEntity = new Cesium.Entity({
  polygon: {
    hierarchy: Cesium.Cartesian3.fromDegreesArray([
      -72.0, 40.0,
      -70.0, 35.0,
      -75.0, 30.0
    ]),
    extrudedHeight: 0,
    material: Cesium.Color.GREEN.withAlpha(0.5)
  }
})

将点、线、面添加到viewer中

要将点、线、面添加到viewer中，我们只需要调用viewer.entities.add()方法就可以了， 将上面创建的点、线、面添加到viewer中的代码如下：

const addEntity = () => {
  viewer.entities.add(pointEntity)
  viewer.entities.add(lineEntity)
  viewer.entities.add(polygonEntity)
}

上述代码完成后，运行程序，刷新浏览器， 看下效果

修改Entity的外观和样式

要控制Entity对象的外观和样式，可以使用Entity对象的属性来定义其外观特征

点（Point）的外观样式

• pixelSize：设置点的大小（以像素为单位）。
• color：设置点的颜色。
• outlineColor：设置点的边界颜色。
• outlineWidth：设置点的边界宽度。 给上面的点的实体添加外观样式，代码如下

// 创建一个点
const pointEntity = new Cesium.Entity({
  position:Cesium.Cartesian3.fromDegrees( -74.01881302800248,40.69114333714821),
  point:{
    pixelSize:10,
    color:Cesium.Color.RED,
    outlineColor: Cesium.Color.BLACK,
    outlineWidth: 1
  }
})

线（Polyline）的外观样式

• width：设置线的宽度。
• material：设置线的材质，可以使用Cesium.Material提供的材质类型，如Cesium.ColorMaterialProperty、Cesium.ImageMaterialProperty等。 给上面的线的实体添加外观样式，代码如下

// 创建一个线实体
const lineEntity = new Cesium.Entity({
  polyline: {
    positions: Cesium.Cartesian3.fromDegreesArray([
      -75.61777, 40.03883,
      -80.42087, 25.79065
    ]),
    width: 5,
    material: new Cesium.PolylineOutlineMaterialProperty({
      color: Cesium.Color.GREEN,
      outlineWidth: 1,
      outlineColor: Cesium.Color.BLACK
    })
  }
})

面（Polygon）的外观样式

• material：设置面的材质，可以使用Cesium.Material提供的材质类型，如Cesium.ColorMaterialProperty、Cesium.ImageMaterialProperty等。 给上面的面的实体添加外观样式，代码如下

// 创建一个面实体
const polygonEntity = new Cesium.Entity({
  polygon: {
    hierarchy: Cesium.Cartesian3.fromDegreesArray([
      -72.0, 40.0,
      -70.0, 35.0,
      -75.0, 30.0
    ]),
    extrudedHeight: 0,
    material: Cesium.Color.GREEN.withAlpha(0.5)
  }
})

Cesium中的Entity类提供了在地球空间上创建、控制和可视化对象的强大功能。通过使用Entity类，我们可以创建各种点、线、面和图标等实体对象，并对其进行交互、更新和管理。

这里只是介绍了Entity类的简单应用，更多功能小伙伴们可以自行探索，今天就到这里，有问题的小伙伴评论区留言，喜欢的小伙伴点赞关注加收藏哦！