技能介绍

要解决什么问题

在浏览器里做三维地球或 Web GIS，Cesium JS 的 API 面很广：从 Viewer 初始化、Cesium.Ion.defaultAccessToken 到影像/地形/3D Tiles 加载，再到 Entity 与 Primitive 两套建模方式，新手往往卡在坐标系、异步加载和性能取舍上。本技能把常见开发路径整理成可查阅的说明与可复制的模板，而不是只罗列官方文档目录。

技能如何组织

场景与坐标：覆盖 CesiumWidget 轻量容器、Viewer 配置项，以及 Cartesian2 / Cartesian3 / Cartographic 之间的转换习惯（例如优先用 Cartesian3.fromDegrees()、角度用 Cesium.Math 工具）。

数据与对象：

影像：ArcGisMapServerImageryProvider、UrlTemplateImageryProvider（XYZ/TMS）等
地形与 3D Tiles（倾斜摄影、大模型 LOD）
矢量与实体：Entity 高级 API；大量静态点用 Primitive / PointPrimitiveCollection

交互与分析：相机控制、拾取与绘制、天气/后处理/雷达等场景特效，以及可视域、剖面、淹没等空间分析思路；时间轴与动画也有对应章节。

assets/templates/ 下提供 basic_viewer.html、data_loading_examples.js、entity_examples.js 等，可按任务拆函数迁入项目；API 摘要见技能内 references/api_summary.md，复杂案例仍建议对照 Sandcastle 与官方论坛。

适用边界与注意点

Entity 写法直观但海量点会拖性能；静态几何与大批量标注应下沉到 Primitive 并注意销毁（viewer.entities.remove、scene.primitives.remove）。
异步 fromUrl 类加载务必做错误处理，并用 Cesium.defined() 判空。
本技能是开发指引与示例汇编，不替代 Cesium 版本变更后的完整 API 阅读；生产环境需自行核对 Ion 令牌、服务协议与数据坐标系。