Overview
为什么 Entity 很关键
对大多数业务项目来说，Entity 是足够强、足够快、维护成本也最低的抽象层。你不需要一开始就进入 Primitive 和底层渲染，就能完成大量空间表达任务。
Starter Code
实体创建骨架
viewer.entities.add({
name: "monitor-site",
position: Cartesian3.fromDegrees(116.39, 39.90, 20),
point: { pixelSize: 10, color: Color.LIME },
label: { text: "监测点 A", pixelOffset: new Cartesian2(0, -24) },
});Goals
学完后的能力
- 理解 `Entity` 与图形组件的组织方式。
- 独立绘制点、线、面、体和模型。
- 知道什么时候应继续使用 Entity，什么时候该转向 Primitive。
Practice Flow
推荐顺序
- 先创建一个最简单的点和标签。
- 再创建折线和多边形，理解坐标组织。
- 接着加入模型或 billboard。
- 给对象绑定属性和样式。
- 最后测试拾取、隐藏和显隐切换。
Useful For
适合的项目形态
- 设备点位展示。
- 轨迹、围栏和区域表达。
- 地图标绘和监控看板。
Pitfalls
常见问题
- 不同图形的坐标输入方式不完全一样。
- 对象数量过多时，Entity 也会遇到性能瓶颈。
- 不要一开始就把所有样式参数都塞进去，先完成表达闭环。
Rule
经验判断
如果你的目标是“快速把业务数据展示出来”，先选 Entity。只有当表达或性能明显受限时，再转向 Primitive。