基于 Cesium 的 3D 地球,打开浏览器即可使用,无需安装或注册
GitHub Pages · Cloudflare Pages
本文含 AI 生成内容
Locus Earth 是一个开源的 Web 3D 地球应用,交互方式参考 Google Earth。它用原生 ES Modules 编写,没有构建步骤,打开网页就能运行,也可以装到桌面或手机当 PWA 使用。
代码以 MIT 许可开源,网页端和 Android 壳工程都在本仓库里(壳在 androidapk/,见 Android 版)。网页本身不需要安装;APK 只是另一种打开方式,你也可以自行构建、修改和分发。
想改代码?本项目零构建,实现取舍、踩过的坑和排查方法见 docs/dev-notes.md。
浏览
- 3D 地形与全球卫星影像,叠加全球 3D 建筑(OpenStreetMap 数据)。
- 底图切换:Sentinel-2、Blue Marble、夜间灯光、天地图卫星、腾讯地图等。
工具
- 距离与面积测量,折线和多边形都贴合地形;画完可命名保存进收藏夹。
- 标记、轨迹与图形统一收进收藏夹,数据保存在浏览器本地,可导出为 KML(XML)再导入。
- 在地图上右键(手机长按)标记 / 轨迹 / 图形,可直接删除;轨迹与图形还能单独导出为 KML。
- 地点搜索:输入地名直接定位。
区域联动
- 进入丹佛、华盛顿 D.C.、悉尼等覆盖区,自动切换到高精度城市建模。
- 进入中国大陆,功能栏自动出现「街景」按钮,点击地图可跳转 360° 全景。
外观与交互
- 昼夜光照(太阳 / 月亮,可调时间)、建筑白模开关;深浅主题可跟随系统。
- 指南针、恢复俯仰角、可拖动的悬浮工具条,桌面和移动端都已适配。
- Google 3D 模式:网络能访问 Google 时,可加载 Google 的 3D Tiles。该数据是 Cesium ion 上的演示资产,可能被限流或下架。
截图不一定实时更新,最新界面请访问网页。
- 标记 / 街景 / 测量三者互斥:同一时刻只能激活一个,切换时会自动关闭另一个,避免点击冲突。
- 街景跳转需要联网,PWA 离线时不可用。
- 移动端底部托盘可上滑展开,点击手柄收合。
- 浏览器要求:需要支持 WebGL 2 的现代浏览器(近几年的 Chrome / Edge / Firefox / Safari 均可)。
功能栏「设置」进入 /settings.html:
- 外观:明暗主题(跟随系统 / 手动)
- 地形与叠加:3D 地形开关、路网与地名叠加层
- 画质:「高清画质」开关(默认关:瓦片少一半,Cesium ion 按流式数据计费,省下来的都是配额)
- 缓存:「缓存地图瓦片」开关(默认开,影像与地形都走它),以及清除应用缓存 / 瓦片缓存 / 引擎缓存 / 收藏 / 设置数据
- 兼容性诊断:在当前设备上自检 WebGL 2、模块加载与引擎初始化
离线:浏览过的区域,影像与地形瓦片都会存到本地,断网也能看;3D 建筑与搜索仍需联网。
缓存分层、渲染取舍、内核兼容和线上排查方法,都写在 docs/dev-notes.md。
本项目不是原生 App:网页是主体,Android 版只是一个原生 WebView 外壳 —— 它把网页全屏装进一个没有地址栏的窗口里,页面内容仍然从线上实时加载。
| 获取 | 从 Releases 下载 APK;欢迎参考工程构建你自己的App(方法见下方折叠说明) |
| 包名 / 要求 | dev.locusearth.app · Android 7.0(API 24)及以上 |
| 壳的职责 | 全屏无地址栏 · 白名单域名留在壳内 · 其余链接交给系统浏览器 · 首次启动说明「这是网页应用」 |
| 源码位置 | androidapk/(独立 Gradle 工程,与主项目同为 MIT 许可) |
网页更新后不需要重装 APK。 壳里没有任何业务逻辑,网页一改,所有已安装用户立即生效。 只有换图标、改白名单域名、改包名这类壳自身的事才需要重新出包。
点开查看:自己构建 APK / 签名说明
三种方式任选:
| 方式 | 怎么做 |
|---|---|
| GitHub Actions(推荐) | 仓库 Actions → Build Android APK → Run workflow;或推一个 v* tag。产物在 Artifacts 里 |
| 命令行 | cd androidapk && ./gradlew :app:assembleRelease(Windows 用 gradlew.bat) |
| Android Studio | 打开 androidapk/ 目录(不是仓库根)→ Build → Build APK(s) |
签名是可选的:CI 上配了密钥就出正式签名包,没配也能构建成功(自动回退 debug 签名,能装能跑、不能上架)。
Fork 后要发布自己的版本,请按 androidapk/README.md 第六节
生成自己的 keystore,不要复用他人密钥。
安装时需在系统设置里允许「安装未知来源应用」。用自备密钥签名的包, 后续更新必须用同一个密钥签名,否则系统会拒绝覆盖安装。
完整的构建、签名、换图标、加白名单域名、Cloudflare Pages 部署排除等说明,
见 androidapk/README.md。
| 引擎 | CesiumJS 1.118.2 |
| 架构 | 原生 ES Modules,零构建步骤 |
| 形态 | PWA(Service Worker + Manifest) |
本项目由 AI 辅助开发。大语言模型:DeepSeek-V4.1-Flash、Hunyuan4、ChatGPT-4o(计入使用的模型而非 AI 产品;故GitHub Copilot、Workbuddy等聚合平台不算在内)
数据来源:Cesium ion · OpenStreetMap · Natural Earth · 天地图 · 腾讯地图
特别致谢:腾讯街景借助社区维护的第三方查看器 qq-map 打开全景(非腾讯官方服务)。坐标转换见 js/coord-transform.js(WGS-84 ↔ GCJ-02 双向)。
点开查看(Fork / 自部署必读)
项目内置的 Cesium、腾讯地图、天地图密钥都设了域名白名单,仅供本项目演示。
Fork 或部署到自己的域名 / 本地,请改 js/config.js,换成自己申请的免费 Key,并在控制台设置自己的白名单。请不要用别人的密钥消耗其配额。
申请入口:
| 开始时间 | 2026-07-04 |
| 维护 | 个人项目,业余开发,不定期更新 |
| 当前版本 | 8.2 |

