用途:介绍 CesiumJS 1.144 的高层、数据驱动的 Entity API,用于把位置、朝向与一种或多种 Graphics 组合成由 EntityCollection 管理的实体,并通过 DataSource 加载外部数据格式自动填充实体集合。采用 ES 模块导入:import { ... } from "cesium";。
主要能力:支持 Point、Billboard、Label、Model、Polygon(含空洞与拉伸)、Polyline、Box、Cylinder、Ellipsoid、Ellipse、Corridor、Rectangle、Wall 等 Graphics 类型;EntityCollection 提供 getById、getOrCreateEntity、values、remove、removeById、removeAll、suspendEvents/resumeEvents 批量更新以及 zoomTo 批量取景;支持父子实体显隐、Entity 描述与自定义属性、导出 KML(exportKml);DataSource 支持 GeoJsonDataSource、KmlDataSource、CzmlDataSource、GpxDataSource 与 CustomDataSource,并支持实体聚合(clustering)。
使用方式:通过 viewer.entities.add 添加实体,或加载数据源后 viewer.dataSources.add(ds) 并 await viewer.zoomTo(ds)。经纬度用 Cartesian3.fromDegrees(longitude, latitude, height?),注意经度在前、西半球经度为负。添加实体后应调用 viewer.zoomTo 或 viewer.flyTo 取景。
适用场景:在地球上展示点线面、模型、标注等矢量要素,加载 GeoJSON/KML/CZML/GPX 数据,做区域或全球范围的实体集合展示与聚合。
限制与边界:*Graphics 类属于本技能,*Geometry 类应归 cesiumjs-primitives,Property(SampledProperty、CallbackProperty、MaterialProperty 子类)应归 cesiumjs-time-properties;非常大的静态 GeoJSON 建议改用 GeoJsonPrimitive。entity.show=false 仅隐藏但计数和 getById 仍生效,需用 removeById 真正删除。其余细节资料暂未提供。