God's Eye View: Open-Source 3D Globe Aggregates Global Real-Time Signals with Sci-Fi UI

Project Overview

God's Eye View (formerly WorldView) is an open-source web application that unifies globally broadcast public geospatial signals onto a single interactive 3D globe. The project reached 25.9K+ GitHub stars quickly and its author's YouTube series has over 5 million views. All data comes from open broadcasts—no classified or private sources—and the code is MIT-licensed for local deployment.

Data Layers and Sources

The platform integrates 13 geospatial layer categories. Ten layers work without any API key; only photorealistic 3D cities, AI voice, and a few enhanced feeds require paid keys. Every layer explicitly labels its data status: real-time, delayed, simulated, or estimated—never mixing real and synthetic data.

Global real-time flights/military aircraft – OpenSky and adsb.lol fallback; ADS-B transponder signals; no key required.

Ocean vessel tracking – AISStream; free key enhances coverage; AIS beacon positions.

Satellites & ISS – CelesTrak public TLE orbital elements; SGP4 algorithm computes real-time positions; no key.

24-hour global earthquakes – USGS seismic network; real-time epicenters and parameters; no key.

City public cameras – Overseas public traffic cameras; projected onto 3D buildings with VIEWSHED visibility analysis; no key.

Global traffic conditions – TomTom + OSM; without key falls back to simulated flow marked SIMULATED; no key.

Radio stations, bike shares, wildfires, space launches, subsea cables, dams, data centers, military facilities – Public open datasets; mostly keyless; static infrastructure plus dynamic environmental data.

Six Core Features

Immersive target tracking with cockpit view – Click any flight to lock camera, show fading trajectory, and display altitude, speed, heading, aircraft type. Press C to enter nose-first cockpit view, follow the aircraft, and switch between nearby targets via the 250 km contacts list. H toggles HUD, D enables detection boxes, Esc exits.

Sensor visual simulations via GLSL shaders – Keys 1‑7 switch between CRT radar, NVG night vision, FLIR thermal, Noir black-and-white, and Snow filters. Each mode adjusts target contrast and information hierarchy to mimic real sensor characteristics.

3D city camera viewshed analysis – CCTV layer places camera positions onto photorealistic 3D buildings. Enabling VIEWSHED renders the camera's visible area and blind spots; one-click jumps to the camera nearest a congested road segment. Note: some overseas cameras return 403 in mainland China due to upstream restrictions, not a project bug.

AI voice control of the globe – With an OpenAI Realtime key, the voice agent reads current camera coordinates, zoom, and active layers for contextual understanding. Example commands: "Fly me to Tokyo", "Open flight layer, filter nearest helicopter", "Count all flights over Texas now", "Draw a measuring line between Eiffel Tower and Louvre", "Switch to night vision, track ISS". Voice also supports drawing administrative boundaries, walking routes, and distance measurements. Keys are proxied server-side, never exposed to the browser; a session cost cap prevents overruns. Without a key the voice module disables while other features remain functional.

Space launch trajectory replay with transparency – Space Missions includes ~30 days of rocket launches. A timeline slider plays back at 0.25×–4× speed. Purely reconstructed trajectories are prominently labeled RECONSTRUCTED ESTIMATE to avoid confusion with official telemetry.

Scene director and shareable serialized URLs – Record camera animations for demos; the current view, filters, layer toggles, and tracked targets are encoded into a URL. Recipients open the link and instantly reproduce the exact observation scene.

Underlying Principles and Boundaries

All sources are publicly broadcast – Aircraft ADS-B, ship AIS, satellite TLEs, and earthquake feeds are openly transmitted or published by official agencies. No classified or private surveillance data is used.

Inherent data latency – Flight and ship updates refresh every 15–30 seconds. Client-side dead-reckoning and interpolation smooth animation but must not be used for navigation or emergency decisions .

Strict separation of real vs. simulated data – Simulated traffic, estimated camera orientations, and reconstructed rocket paths are forced to display SIMULATED/ESTIMATE badges.

Explicit project red lines – Documentation states: no facial recognition, no tracking of ordinary individuals; only aircraft, vessels, infrastructure, and natural events are observed.

Tech Stack

Vanilla JavaScript + CesiumJS 3D globe engine + Vite build; no heavy frontend frameworks. Target heading uses world-space coordinate calculations so aircraft and ship icons always align with true geographic direction regardless of camera rotation.

Local Deployment Guide

Environment Requirements

Node.js 24.14.x or 26.x – other versions likely cause dependency failures.

Modern Chrome/Edge; legacy browsers unsupported.

Critical: Do not open index.html directly; must run via dev server.

Three-Step Deployment

Clone repository

git clone https://github.com/bilawalsidhu/gods-eye-view.git
cd gods-eye-view

Copy environment template and fill keys

# Windows PowerShell
Copy-Item .env.example .env
# Mac/Linux
cp .env.example .env

Edit .env :

# Required: Google Maps API Key for photorealistic 3D tiles
GOOGLE_MAPS_API_KEY=xxx
# Optional: OpenAI key for voice control
OPENAI_API_KEY=xxx
# Optional enhancements
AISSTREAM_API_KEY=xxx
TOMTOM_API_KEY=xxx
FIRMS_API_KEY=xxx

Google offers 1,000 free 3D Tile sessions per month (max 3 hours each); enable budget alerts and quota limits in Google Cloud to avoid surprise charges.

Install dependencies and start

npm install
npm run dev -- --host localhost --port 4173

Access http://localhost:4173 in browser.

Common Pitfalls

3D buildings fail to load: Google key missing billing, Photorealistic 3D Tiles API not enabled, or referrer restrictions block requests.

Cameras blank: upstream public camera APIs rate-limited or blocked; a data-source issue, not fixable in the project.

Few aircraft shown: automatic fallback to adsb.lol; coverage varies by region.

LAN sharing: change --host localhost to --host 0.0.0.0. Warning: LAN exposure shares your API keys with all local users; lower provider quotas beforehand.

Port 4173 occupied: change --port value.

Zero-Key Experience Limits

Without a Google key, photorealistic 3D cities cannot load; base globe, flight, satellite, and earthquake layers theoretically load but some versions may block initialization entirely. For basic layer testing, a minimal Google test key is recommended.

Recommended Use Cases

Aviation enthusiasts – Track transoceanic airliners, enter cockpit view, compare routes.

Geography/space education – Follow ISS, replay rocket launches, visualize subsea cables; great for teaching.

OSINT learners – Fuse multiple open geospatial sources in one view; study multi-source visualization.

Frontend/3D developers – Reference implementation for WebGL rendering, real-time data streams, geographic interpolation, and large-scene entity management.

Comparative Landscape

Google Earth – Focuses on static/historical imagery; lacks real-time flight, ship, signal aggregation, cockpit view, night vision, voice interaction.

FlightRadar24 – Professional flight tracking only; single-domain, closed-source, no multi-source integration.

God's Eye View – Core advantage: unified multi-source public signals on a 3D canvas + highly interactive immersive perspectives + fully open-source for extension . Drawbacks: relies on third-party paid map APIs; some overseas data sources unstable from mainland China.

Controversies and Limitations

Controversy 1: Military-style UI causes misperception. Author clarifies: visuals are interaction design only; all data is publicly verifiable; no special intelligence channels.

Controversy 2: Heavy dependence on Google and OpenAI commercial APIs reduces free-tier usability. Fact: 10 layers are keyless, but top-tier 3D cities and voice need paid services. Cesium ion and OSM imagery are offered as alternative base layers to reduce Google reliance.

Hard limitations:

All real-time data has 10+ second latency; interpolation is visual smoothing, not instantaneous truth.

Public cameras cover only a few overseas cities; no domestic Chinese open camera feeds.

Third-party data sources may change APIs, rate-limit, or shut down at any time, causing layer availability to fluctuate.

UI is English-only; no official Chinese localization yet.

Who Should Deploy – And Who Shouldn't

Recommended for: Aviation/space hobbyists, GIS visualization developers, OSINT students, geography educators, frontend 3D researchers.

Not recommended for: Users wanting completely free out-of-the-box experience without API keys; those unable to obtain keys; those intolerant of overseas network instability; those needing 24/7 stable high-volume camera feeds.

The project's greatest value isn't its flashy HUD or infrared filters—it demonstrates that scattered, dry public data, when wrapped in excellent visualization and interaction, can yield a near-cinematic observation platform. The code is fully open and auditable; every data source is clearly attributed, bringing "global observation" capability from specialized agencies down to everyday developers.

Project repository: https://github.com/bilawalsidhu/gods-eye-view