20 分钟跑起 God‘s Eye View：真实航班、卫星与公共摄像头的实时 3D 地球

20 分钟跑起 God's Eye View：真实航班、卫星与公共摄像头的实时 3D 地球

【免费下载链接】gods-eye-viewA spy satellite simulator in your browser, except the data is real. Live open source spatial intelligence on a photorealistic 3D globe.项目地址: https://gitcode.com/GitHub_Trending/go/gods-eye-view

God's Eye View 是一颗在浏览器里实时转的 3D 开源空间情报地球：航班、船舶、卫星、地震、公共摄像头，全部走真实公开信号，不需要账号，20 个图层里 18 个有免 Key 路径。本文带你先在本机把它跑起来，再玩透三层由浅入深的操作，最后按需贴 Key、排掉四个常见坑。

🧾 起跑前 60 秒：三笔账，先看清

• 硬件：一台有硬件加速的电脑加一个现代浏览器。官方基准是 Apple M5 + Chrome 1440×900，冷启动中位 1.86 秒、全程 60 FPS——参照值，非承诺，出处 docs/PERFORMANCE.md。
• 账号：零。全程无需注册任何东西；只有后面"变强区"贴 Key 时才需要各家的免费账号。
• 时间：终端路径约 5 分钟（取决于网速），加上体验部分 15 分钟内。

一条硬门槛：终端路径要求 Node 24.14.0 及以上或 26.x，25.x 已弃用，npm run doctor会当面提醒你。版本要求写在 package.json 的 engines 字段。

🚦 最短路径：一条主路，一条备路

主路是终端。备路是 Pinokio（8.2 以上版本）：在应用市场搜 God's Eye View，点 Install、再点 Start，Windows、macOS、Linux 都支持；装失败就升级 Pinokio 再试，旧安装器有已知问题。两条路都免 Key 起步，底图默认走 Esri 卫星影像，连不上会自动切 OSM。

git clone https://gitcode.com/GitHub_Trending/go/gods-eye-view cd gods-eye-view npm ci npm run doctor npm run dev

打开http://localhost:4173。

首屏不急着铺信号，而是停在一张 MISSION CONTROL 面板上，四个选项：LIVE_CONTACTS、SPACE_MISSIONS、ENVIRONMENTAL、EXPLORE_MANUALLY。两个容易错过的细节：勾选Don't show this again是唯一能永久关掉它的开关，其余任何关闭方式下回还会出现；URL 拼?welcome=1强制重播、?welcome=0强制隐藏，演示时很好用。策略实现见 src/firstRunExperience.js。

📋 能力全景：先看表，再挑着玩

后文只展开表内条目：先跟一架真实飞机，再换到地面视角，最后把整座控制台交出来。

🛩 第一层·跟机：锁定一架真实航班

点中任意一架飞机，屏幕上立刻发生三件事：相机锁定目标、尾部拖出渐隐航迹、旁边弹出此刻的高度、地速、机型。

按C进入座舱。相机锁在这架真实飞机身上，跟着它一路下降，脚下始终是真实地形。基准里座舱场景稳在 49.6 / 49.2 FPS（运动 / 静止，参照值非承诺，docs/PERFORMANCE.md）。

座舱里 Contacts 面板常驻目标周围250 公里内的实时信号名册，点下一架，相机直接从当前这架切过去、落进下一个座舱，不用回地面。

连按1–7，整颗星球在 CRT、NVG、FLIR、Noir、Snow 之间换外观，不用碰鼠标。基准数字里 Normal、CRT、NVG 都稳 60 FPS，FLIR 49、Noir 47、Snow 42 FPS——雪天滤镜是掉帧最狠的一档。

🏙 第二层·落地：把 3D 开关拨上，再从摄像头看街景

搜索框输入繁忙机场代码，打开3D开关，把镜头推近到停机坪：距离够近时，飞机从符号变成真实 3D 机型，787、ATR-72、Citation、Bell 206、MQ-9 各有独立模型，停在地面的目标还画着滑行拖尾。

再开Cameras图层，飞到奥斯汀、加州、伦敦、加拿大 BC 省、芬兰这些支持城市：摄像头画面不是网页视频挂件，而是直接投影进 3D 城市空间。把覆盖模式切到VIEWSHED，每台摄像头画出自己的覆盖体积，看得清的范围和盲区一眼分出来。

容易错过的一点：摄像头位置来自公开数据，但姿态是估算值——仓库明说可以用 gizmo 拖摄像头本体来校准它的指向。

🎛 第三层·交权：键盘与麦克风接管整座控制台

贴好 OpenAI Key 之后（代价见下一节），点底部GEV MIC授权麦克风，说一句"Outline the state of Texas"——屏幕上出现的会是真实的州界多边形，不是随手画的圈。语音代理会先抓取你当前视野的坐标、街道、活跃图层再作答，而且只确认真正执行成功的动作。不用麦克风也能画：DISPLAY 面板的Draw里选 Area、Line 或 Pin，在真实世界上点顶点、双击结束，标注一样持久。

不用语音也能操作大半台控制台：

🔑 变强区：每把 Key 值什么，代价是什么

所有 Key 都从右下角POWER UP面板粘贴，点SAVE KEYS，应用自己重启生效。Key 只落在本机文件里（Pinokio 是pinokio/ENVIRONMENT，终端克隆是仓库根目录.env），服务器默认只绑 localhost，仅本机可写。每个图层的来源与授权级别查 DATA_SOURCES.md。

🩹 翻车自救：五个条件句，条条能自查

• 看到npm run doctor输出 Node 版本警告 → 先确认你用的是 24.14.0 以上或 26.x（25.x 已弃用）→ 还没好再重跑npm ci && npm run doctor确认环境干净。依据：package.json 的 engines 字段。
• 看到 Traffic、ALPR 图层打开后是空的 → 先git pull更新到最新代码再跑 → 原因写清楚了：旧版请求现在会被公共 Overpass 服务器拒绝，出处 README.md Quick Start 一节的更新提示。
• 看到 Pinokio 安装失败 → 先升级到 8.2 以上重试 → 还没好改走终端路径，两条路跑的是同一个应用。
• 看到 Pinokio 能打开但地球明显卡顿 → 把 Pinokio 显示的本地地址复制到你的日常浏览器里打开 → 已有用户报告内置视图严重卡顿、换外部浏览器后恢复。
• 看到启动比你预期慢 → 先对照官方基准（M5 + Chrome 冷启动中位 1.86 秒、60 FPS，参照值非承诺）→ 还没结论就检查网络到 Esri 瓦片源是否通畅，慢多半出在底图加载。

仓库自己的话是："the present is the cheap part"——实时信号便宜又开放，回看过去才是贵的那部分。你的最小起步动作只有一个：打开 LIVE_CONTACTS，点住你看到的第一架飞机，然后按C。

【免费下载链接】gods-eye-viewA spy satellite simulator in your browser, except the data is real. Live open source spatial intelligence on a photorealistic 3D globe.项目地址: https://gitcode.com/GitHub_Trending/go/gods-eye-view