【珍藏整理】从地球搭建到空间分析:380 个 Cesium 功能示例源码怎么上手

原创2026-11-14 13:28:141,163 阅读

【珍藏整理】从地球搭建到空间分析:380 个 Cesium 功能示例源码怎么上手

这是一份 Cesium 功能示例源码集合,共 380 个示例,打包在一个压缩包里,解压后即可离线运行。示例按"基础场景 → 底图与数据 → 实体绘制 → 空间分析 → 可视化"逐层展开,覆盖了浏览器三维地球开发中常见的大多数功能点。

选 Demo 时常见的三个麻烦

用过 Cesium(一个开源的 JavaScript 三维地球库)的人,学习时容易卡在三个地方:

  • 接口文档分散:Cesium 接口很多,官方文档只给 API 说明,不告诉你具体怎么组合;
  • Demo 不好找:想要的效果(比如通视分析、风场)要在零散页面里翻找;
  • 环境配置费时间:跑一个示例,往往要先配代理、装依赖、申请在线服务的 token。

这份示例源码的思路是把这三步压掉:所有功能点各占一个 HTML 文件,依赖全部随包附带,打开就能看效果。

380 个示例覆盖哪些功能

示例文件放在 example/ 目录,用"字母 + 序号"命名前缀,前缀代表功能模块。同一示例还配一张效果缩略图,放在 data/exampleIcon/,预览不需要先跑代码。

前缀 功能模块 示例数 代表示例
a 基础场景(建图、底图、事件、离线) 12 a10_createMap.html
b 地形(加载、夸张、天地图地形) 3 b10_terrain.html
c 底图接入(国内主流底图、WMS/WMTS、离线缓存) 28 c15_xyz.html
d 界面交互(选层、提示、量算条、VR 模式) 22 d20_locationBar.html
e 数据加载(GeoJSON、CZML、KML、WFS) 20 e21_czml.html
f 实体与图元(几何体、粒子、水效、城市级组合) 94 f10_entity_model.html
g 3D Tiles 与 BIM 建筑模型 27 g10_bim.html
h 场景与相机(街景、天空盒、漫游、后处理) 43 h10_streetview.html
k 空间分析(测量、通视、填水面、空间查询) 46 k10_sightline.html
m 可视化(风场、热力、图表联动、物理仿真) 46 m10_windLayer.html
index / editor 示例导航页与内置代码编辑器 2 index.html

三档示例分层说明

不确定先看哪个的话,按下面的顺序读比较省力。

入门档:先把地球跑起来

  • a10_createMap.html:最基础的"创建地球"写法,三种初始化方式各一页;
  • c10_baidu.html:以百度底图为例,看国内底图如何接入;
  • c15_wms.html:接自有地图服务时,WMS 协议(一种地图瓦片服务协议)的写法在这里。

进阶档:画东西、加载模型

  • f10_entity_box.html 到 f15_entity_wall.html:从立方体到墙体,逐个过一遍实体(Entity)的画法;
  • f30_particleSystem.html:粒子效果,做水、烟、火焰都从这里改;
  • g10_3dtiles_layers.html:3D Tiles(一种三维瓦片格式,用来管理海量建筑模型)分层加载。

实战档:分析、特效与大数据量

  • k10_sightline.html:通视分析,站在某点能看到哪里;
  • k15_floodByGraphic.html:填水面分析,常用于城市内涝推演;
  • m10_windLayer.html:风场动画;
  • f45_digitalCity.html:多个效果的组合应用,接近真实项目页面。

三个让示例能离线跑的细节 🧰

  • 依赖全在包内:lib/ 目录自带 Cesium、MARS3D、jQuery、ECharts、mapV、Three.js 等,不需要再装依赖,也不依赖网络接口;
  • ES5 兼容:代码用 ES5(老版 JavaScript 语法)编写,较旧的浏览器和老内核环境直接能打开;
  • 插件化结构:示例基于 MARS3D(Cesium 的二次封装框架)开发,lib/mars3d/plugins/ 下按 heatmap、wind、mapv、supermap 等插件分目录,找 API 文档有固定入口;
  • 内置编辑器:example/editor.html 可以在页内直接改示例代码看效果,example/config/config.json 里放场景配置,不用每次重新刷新。

适合谁、不太适合谁 👥

适合

人群 用法
Cesium 初学者 按文件前缀浏览,先搞清楚这个库能做到什么
项目开发者 直接找同名功能的示例,改参数、抄结构
内网 / 离线团队 整个包拷进内网即可演示,不依赖外网

不太适合

  • 想深究 Cesium 内核 API 的人——示例侧重应用层写法,API 细节要回到官方文档对照;
  • 新项目要求 TypeScript、ES Module 的——示例是纯 ES5 + 全局变量写法,参考逻辑可以,代码结构不建议照搬。

快速跑通第一个示例 🚀

  1. 获取仓库(需要 clone 时使用):git clone https://gitcode.com/open-source-toolkit/d161c;
  2. 解压根目录的 mars3d-es5-example.rar;
  3. 用浏览器打开 example/index.html,进入示例导航页;
  4. 按文件名前缀定位功能,如 c10_baidu.html、k10_sightline.html;
  5. 具体运行条件和注意事项见 README.md。

下一步建议 🔗

  • 先挑一个和自己需求最接近的示例在本地跑通,再对照 lib/mars3d/plugins/ 里的对应插件,把实现搬进自己的项目;
  • 示例仅供参考,接入生产环境前用真实数据验证效果和性能;
  • 使用中发现问题或有新示例,可以通过仓库反馈渠道提交。
登录后查看全文
Cesium技术380个功能示例源码