Cesium开发基础篇｜04空间数据可视化之Entity

前面介绍了Cesium如何加载影像数据、地形数据、以及矢量数据，但是作为一个完整的三维系统，仅仅包括这些数据还是远远不够的。当然，还需要一些其他数据，比如空间可视化数据、三维数据数据等，今天我们先从空间数据的可视化说起，后面会有专门的章节介绍三维数据方面的加载。

Cesium在空间数据可视化方面提供了两种类型的API，一种是面向图形开发人员的低级（原始）API，通过Primitive类实现，对于那些对计算机图形学知识很了解的同学可以采用Primitive API，后面章节会有详细介绍；另一种是用于数据驱动的高级（实体）API，通过Entity类实现，相对于Primitive API，Entity API实现起来更简单一些，特别建议初学者使用。Entity API 实际上是对Primitive API的二次封装，底层调用的仍然是Primitive API，目的就是为我们提供灵活的、易学、易用的高性能可视化界面。本章节内容主要介绍后者Entity API，Primitive API放在后面的高级篇里讲解。

1

Entity支持的图形类型

通过在Cesium API文档中查看Entity类的构造函数，我们发现Entity支持的图形类型都是以Graphics结尾的，一共有17种类型。如下图所示，列出了Entity支持的图形类型以及对应的js类。

下面，简单介绍一下每一种类型的Graphic添加方式。

1）billboard 广告牌

2）box 盒子

3）corridor 走廊

4）cylinder 圆柱、圆锥

5）ellipse 椭圆或拉伸的椭圆

6）ellipsoid 椭球体

7）label 标签

8）model 模型

9）tileset 3D Tiles瓦片集

10）path 路径

11）plane 平面

12）point 点

13）polygon 多边形

14）polyline 多线段

15）polylineVolume 多线段柱体

16）rectangle 矩形

17）wall 墙

2

Entity 聚合

同时，针对Billboard、Label、Point，Cesium 提供了 EntityCluster 类用于实现聚合效果，但必须结合 PinBuilder 类实现。下面为实现聚合效果的核心代码：

3

Entity 管理

上面介绍了Entity的图形类型，有这么多类型的实体，Cesium是如何管理这些实体对象的呢，这就需要我们从初始化Viewer对象开始说起了。当我们初始化Viewer类之后，会得到一个实例化对象viewer，这个viewer会包含一个属性 entities ，它的类型是 EntityCollection ，也就是 Entity 的集合，它包括了 EntityCollection 类里面的所有属性和方法。所以 Cesium 管理 Entity 本质上是通过 EntityCollection 类进行管理的，比如add（添加Entity）、contains（是否存在某个Entity）、getById（通过ID获取Entity）、remove（移除某个Entity）、removeAll（移除所有的Entity）、removeById（通过ID移除Entity）方法等。

4

Entity 拾取

在三维场景种，很常见的一种交互方式，就是鼠标点击三维场景种某一个几何图形，查看该图形的包含的属性信息，并显示在对应的信息窗体中。单击事件通过 ScreenSpaceEventHandler 类注册，拾取到的信息可通过以下两种方式获取。

scene.pick：获取窗体坐标处最顶部的实体；

scene.drillPick：窗体坐标处的实体列表。

5

Entity 固定

在实际的应用系统中，会有这样的需求，要求画的实体附着在地形表面、或三维建筑表面（比如视频融合），这时候就需要设置xxGraphics的相关属性了，可通过 heightReference 或 classificationType 这两个属性去控制。属性值描述如下：

heightReference属性值：

NONE：位置绝对（默认值）；

CLAMP_TO_GROUND：位置固定在地形上；

RELATIVE_TO_GROUND：位置高度是指地形上方的高度

classificationType属性值：

      TERRAIN：将仅对地形进行分类;

      CESIUM_3D_TILE：将仅对3D Tiles进行分类;

      BOTH ：将同时对Terrain和3D Tiles进行分类。

其中corridor 、 ellipse 、 polygon 、 polyline 、 rectangle 可通过设置 classificationType 属性值显示仅贴地、仅贴建筑或者两者都贴的效果，billboard 、 box 、 corridor 、 cylinder 、 ellipse 、 ellipsoid 、 label 、 model 、 point 、 polygon 、 tectangle通过设置 heightReference 属性值为 CLAMP_TO_GROUND 显示贴地效果。这里需要注意的是，如果是polyline必须设置 clampToGround 属性为 true 。

end