【珍藏整理】从地球搭建到空间分析:380 个 Cesium 功能示例源码怎么上手
【珍藏整理】从地球搭建到空间分析: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 + 全局变量写法,参考逻辑可以,代码结构不建议照搬。
快速跑通第一个示例 🚀
- 获取仓库(需要 clone 时使用):
git clone https://gitcode.com/open-source-toolkit/d161c; - 解压根目录的
mars3d-es5-example.rar; - 用浏览器打开
example/index.html,进入示例导航页; - 按文件名前缀定位功能,如
c10_baidu.html、k10_sightline.html; - 具体运行条件和注意事项见 README.md。
下一步建议 🔗
- 先挑一个和自己需求最接近的示例在本地跑通,再对照
lib/mars3d/plugins/里的对应插件,把实现搬进自己的项目; - 示例仅供参考,接入生产环境前用真实数据验证效果和性能;
- 使用中发现问题或有新示例,可以通过仓库反馈渠道提交。
登录后查看全文