Cesium-1.143 中文版 API一、Cesium 概述二、核心功能三、主要应用场景四、Cesium 中文版 API 详解五、中文版 API 的翻译过程六、快速上手示例楔子为了方便光大 GISer 更好的使用 Cesium这里提供 Cesium-1.143 中文版镜像后续会随较大更新版本而更新。访问方式资源链接Cesium中文版API1.143https://cesium.vip/接下来介绍一下 Cesium 入门指南从三维地球引擎的核心能力到中文版 API 文档的获取、价值与共建。一、Cesium 概述1.1 什么是 CesiumCesium正式名称为CesiumJS是一个开源的 JavaScript 库用于在浏览器中创建世界级的 3D 地球和 2D 地图且无需任何插件。它基于 WebGL 技术将地理空间数据与高性能图形渲染结合使开发者能够在网页端呈现厘米级精度的三维地理场景。Cesium 由CesiumGS 公司前身为 Analytical Graphics Inc.即 AGI主导开发与维护并拥有一个活跃的开源社区。其设计目标是让任意设备或浏览器都能流畅地加载、可视化和分析大规模的时空地理数据。一句话理解如果 OpenLayers / Leaflet 是二维地图的利器那么 Cesium 就是三维地球与时空数据可视化的标杆。1.2 技术基石Cesium 的能力建立在一组开放标准与成熟技术之上技术 / 标准作用WebGL浏览器端 GPU 硬件加速渲染支撑海量几何与纹理3D TilesOGC 社区标准用于流式加载大规模三维地理数据倾斜摄影、BIM、点云glTF / GLB高效的 3D 模型格式“JPEG of 3D”Cesium 官方推荐模型格式CZMLCesium 专用时空数据描述语言用于描述随时间变化的动态实体GeoJSON / KML通用矢量与标注数据格式WGS84统一的坐标参考系保证全球数据对齐1.3 核心特点跨平台、零插件纯前端运行支持桌面与移动端的主流浏览器。时间动态Time-Dynamic原生支持时间轴与时钟可回放卫星轨迹、车辆运动等随时间演变的数据。大规模三维数据借助 3D Tiles 流式加载技术可流畅展示城市级倾斜摄影、BIM 模型与亿级点云。开放与可互操作兼容 OGC 标准易于与 GIS、BIM、IoT 等系统对接。高精度地形与影像内置多种影像与地形服务提供方支持自定义接入。二、核心功能2.1 三维地球与地图渲染Cesium 的核心是Viewer对象它封装了场景Scene、相机Camera、图层ImageryLayer、地形Globe与时间Clock等子系统。只需几行代码即可初始化一个可交互的三维地球constviewernewCesium.Viewer(cesiumContainer,{terrain:Cesium.Terrain.fromWorldTerrain(),baseLayer:Cesium.ImageryLayer.fromWorldImagery()});2.2 时间动态数据Time-DynamicCesium 天生为时空而生。通过JulianDate、Clock、SampledPositionProperty等类型可以描述实体在任意时刻的位置、朝向与属性并在时间轴上自由播放、暂停与倍速回放。conststartCesium.JulianDate.fromIso8601(2024-01-01T00:00:00Z);viewer.clock.startTimestart;viewer.clock.currentTimestart;viewer.clock.multiplier60;// 60 倍速卫星过境预报、飞行器轨迹、车辆 GPS 回放等场景均依赖这一能力。2.3 3D Tiles 与大规模三维数据3D Tiles是 Cesium 处理超大规模三维地理数据的核心。它能够分块、分层级LOD地流式加载数据使浏览器在有限内存下也能渲染整座城市倾斜摄影Photogrammetry无人机航拍重建的实景三维模型BIM / 建筑模型设计阶段的建筑信息模型点云Point Cloud激光雷达等采集的亿级点数据实例化模型Instances重复结构如路灯、树木的高效表达2.4 影像与地形Cesium 提供统一的ImageryProvider与地形接口可接入全球影像Bing、ArcGIS、天地图、自定义 TMS/WMTS地形高程Quantized Mesh、Google Photorealistic 3D Tiles、自定义地形服务多源图层叠加与透明度控制2.5 实体 APIEntity与图元PrimitiveCesium 提供两类编程模型Entity API高级、面向数据以实体为单位描述点、线、面、模型、标签等自动管理底层细节适合快速开发。Primitive API底层、面向性能直接操作几何与外观性能最优适合海量静态数据的极致优化。viewer.entities.add({position:Cesium.Cartesian3.fromDegrees(116.39,39.9),point:{pixelSize:10,color:Cesium.Color.RED},label:{text:北京,font:14pt sans-serif}});2.6 相机与交互控制Cesium 的相机系统支持飞行flyTo、跟踪trackedEntity、第一/第三人称视角以及鼠标键盘交互缩放、倾斜、平移。结合ScreenSpaceEventHandler可自定义拾取与交互逻辑。2.7 空间分析能力借助 Cesium 的几何与数学工具可实现通视分析Line of Sight视域分析Viewshed / Frustum体积计算Volume限高分析、天际线分析距离 / 面积量算三、主要应用场景3.1 智慧城市与数字孪生将城市倾斜摄影、BIM、地下管网与 IoT 实时数据融合构建可交互的数字孪生城市用于规划展示、应急指挥与资产管理。3.2 航空航天与卫星可视化卫星轨道、地面站覆盖、星座组网结合时间轴回放卫星过境与任务过程。3.3 军事与国防仿真战场环境三维推演、兵力机动模拟、通视与雷达覆盖分析等。3.4 气象与环境监测气象云图、污染扩散、海浪流场等时空数据的动态呈现。3.5 教育与科研地理、测绘、遥感等课程的三维教学演示与科研成果展示。四、Cesium 中文版 API 详解4.1 为什么需要中文版 API尽管 Cesium 功能强大但其官方文档cesium.com/learn与本地Build/Documentation全部为英文且包含大量地理信息、图形学、计算机术语。对英语基础薄弱或刚接触三维地理开发的国内开发者而言存在明显门槛阅读官方 API 耗时概念理解易偏差团队内部文档难以统一新人上手慢关键时刻查得到英文、读不懂含义中文版 API 文档正是在这一背景下对 Cesium 完整 API 参考文档进行系统翻译的成果。4.2 中文版 API 的内容覆盖本中文版 API 对 Cesium 发布包内Build/Documentation目录下的全部文档文件进行了翻译覆盖类别说明类Class如Viewer、Entity、Cesium3DTileset、Camera等数百个类全局函数Global Functions如binarySearch、sampleTerrain、createWorldTerrainAsync等枚举Enum如ArcType、VerticalOrigin、ClassificationType等类型定义Typedef如MetadataValue、HeadingPitchRollValues等描述、参数、返回值、示例每个成员的描述文本、参数说明、See Also 与示例翻译既覆盖类成员的description功能描述也覆盖参数表td.description、参数描述param-desc等细节力求读中文即懂含义。4.3 资源获取方式中文版 API 文档以静态 HTML 文件形式提供与官方结构完全一致本地文件翻译成果位于 Cesium 包的Build/Documentation/目录下如Build/Documentation/global.html、Build/Documentation/Viewer.html等直接用浏览器打开即可。离线浏览将所有文档文件放入任意静态服务器或直接双击打开无需联网适合内网与涉密环境。与官方在线版对照中文文档的文件名、锚点anchor与官方一一对应可中英文并排对照阅读快速定位原始出处。提示文档中的类名、方法名、属性名、类型名、枚举值、URL、代码块等均保持英文原文仅对描述性散文进行翻译以确保与代码世界的一致性避免翻译后与源码对不上的问题。4.4 对国内开发者的价值降低学习曲线术语与概念用母语表达理解速度显著提升。加速项目落地查阅 API 不再被语言卡住开发效率提高。统一团队认知团队共用中文文档减少沟通歧义。利于知识沉淀便于内部培训、技术文档与 Wiki 的二次整理。五、中文版 API 的翻译过程5.1 翻译范围与粒度翻译以描述块为最小单元覆盖文档中的div.description成员主描述td.description.last参数 / 属性说明单元格div.param-desc参数详细描述ul.see-list参见See Also交叉引用div.help页脚帮助信息同时为兼顾技术准确性以下刻意保留英文代码路径、URL、类名、方法名、属性名、类型名、枚举值内联代码code、JS 代码块WebGL、3D、URL等专有缩写optional、构造函数选项骨架Object with the following properties:、表头Name/Type/Description等5.2 翻译约定术语一致性专有名词与代码标识符不翻译如Cartesian3、Entity、buildModuleUrl。通用术语建立统一译法如Globe→地球、Camera→相机、Terrain→地形、Imagery→影像、Primitive→图元。长句按中文表达习惯拆分优先信、达兼顾雅。六、快速上手示例下面一个最小可运行示例展示如何创建一个带地形与影像的 Cesium 地球并添加一个实体。对照中文版 API阅读Viewer、Cartesian3、Color等类的说明可更快理解每个参数的含义。!DOCTYPEhtmlhtmllangzh-CNheadmetacharsetutf-8title我的第一个 Cesium 应用/titlescriptsrchttps://cesium.com/downloads/cesiumjs/releases/1.143/Build/Cesium/Cesium.js/scriptlinkhrefhttps://cesium.com/downloads/cesiumjs/releases/1.143/Build/Cesium/Widgets/widgets.cssrelstylesheetstyle#cesiumContainer{width:100%;height:100vh;}/style/headbodydividcesiumContainer/divscript// 创建 Viewer详见中文版 APIViewer 类constviewernewCesium.Viewer(cesiumContainer,{terrain:Cesium.Terrain.fromWorldTerrain(),baseLayer:Cesium.ImageryLayer.fromWorldImagery()});// 添加一个实体详见中文版 APIEntity、Cartesian3、Colorviewer.entities.add({name:示例点,position:Cesium.Cartesian3.fromDegrees(116.39,39.9,100),point:{pixelSize:12,color:Cesium.Color.RED},label:{text:北京,font:16pt sans-serif,pixelOffset:newCesium.Cartesian2(0,-24)}});// 飞向该位置详见中文版 APICamera.flyToviewer.camera.flyTo({destination:Cesium.Cartesian3.fromDegrees(116.39,39.9,1500000)});/script/body/html