bilawalsidhu/gods-eye-view

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/bilawalsidhu/gods-eye-view.svg?style=card)](https://bestofgithub.dev/repo/bilawalsidhu/gods-eye-view)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/bilawalsidhu/gods-eye-view.svg)](https://bestofgithub.dev/repo/bilawalsidhu/gods-eye-view)

Loading README…

Layer	What you get	Source	Auth
🗺️ Map Stack	Esri satellite imagery, Google Photorealistic 3D, OSM, plus additional ion-hosted stacks	Esri / Google / Ion / OSM	🟢 Esri satellite + OSM · 🟡 ion-hosted Google 3D + world terrain · 🔴 direct Google + place search
✈️ Live Flights	11,000+ live aircraft + route history	OpenSky + adsb.lol	🟢 (🟡 optional for more polling credits)
🎖️ Military Flights	ADS-B military traffic in amber, emergency broadcasts in red	adsb.lol	🟢
📡 GNSS Integrity	Regional navigation accuracy scores; anomalies do not confirm interference	adsb.lol, GPSJAM aggregation	🟢
🔥 Fire Perimeters	Incident boundaries and reported containment	WFIGS / NIFC	🟢
🚢 Live Vessels	Thousands of ships worldwide	AISStream	🟡
🛰️ Satellites	838-object catalog, color-coded by class with a live legend — the DENSE chip drops in the whole Starlink shell	CelesTrak	🟢
🌍 Earthquakes	Global seismic activity, last 24h	USGS	🟢
◍ Air quality	Live AQHI on the published 1–10+ health-risk scale, with a Weather-panel card showing the band legend and the highest readings in view. Canada only — ECCC is the first registered provider	ECCC MSC GeoMet	🟢
🚗 Traffic	Simulated vehicles on OSM roads. With TomTom, live flow speeds drive the simulation and congestion colors below ~8 km; individual vehicle positions are not live observations	TomTom + OSM	🟢 simulation · 🟡 live flow speeds
📹 CCTV Mesh	~4,000 public cameras (shared cap) projected into the 3D space — Austin · Texas (TxDOT) · California (Caltrans) · London (TfL) · Ontario (511, free developer key) · Finland (Fintraffic) · British Columbia (DriveBC) · Estonia (Tallinn, Tarktee) · Delaware (DelDOT live video) · New South Wales (Live Traffic NSW) · Calgary · Norway (Statens vegvesen) · Toronto · King County (WA) · Washington (WSDOT) · Catalonia (Servei Català de Trànsit) · Hong Kong (Transport Department) · Taiwan (Freeway Bureau, MOTC), plus opt-in New York City (NYC DOT TMC, needs your own NYC DOT agreement), opt-in Lithuania (Via Lietuva / Eismoinfo, photo licence unconfirmed) and opt-in Florida (FL511, individual personal use only; other use needs FDOT's written consent). Positions are published; poses are estimated priors you calibrate by dragging a gizmo on the camera itself	City APIs	🟢
📷 Mapped ALPR Cameras	License-plate-reader camera locations tagged by OpenStreetMap contributors, loaded one city-sized view at a time, with SHOW NEAREST. Locations and tags only: no plate data, no video	OpenStreetMap (incl. DeFlock mapping)	🟢
📷 Street Level	Street-level photos behind one panel, one chip per provider: coverage on the streets, image cones, an embedded viewer with full-screen EXPAND. Mapillary, Google Street View, KartaView and Panoramax	Mapillary · Google · KartaView · Panoramax	🟢 KartaView, Panoramax · 🟡 Mapillary token · 🔴 Google Maps key
📻 Radio	Geolocated world radio with an analog tuner — drag the needle across up to 750 stations and the globe flies to each broadcaster	Radio Browser / broadcasters	🟢
🚌 Transit	Live buses, trams, metros, trains and ferries with delayed playback between reports, selected-vehicle trails, and mode-coloured DETECT labels — Boston, Austin, Minneapolis, Helsinki, the Netherlands, Norway, South East Queensland, and nine in Ontario: Toronto (surface vehicles; the subway publishes no positions), Mississauga, Hamilton, Durham Region, York Region, Guelph, Burlington, Barrie and Kingston	Operator GTFS-Realtime feeds	🟢
🚲 Bikeshare	Live station availability	GBFS	🟢
🧭 Directions	Click A and B on the globe for a street-following drive, walk or cycle route draped on the terrain with turn-by-turn steps — then FLY the camera along it. No key, no geocoder, no mic	OSRM on FOSSGIS servers (OpenStreetMap)	🟢
🔥 Active Fires	Live NASA FIRMS detections, trailing 24h	NASA FIRMS	🟡
🚀 Space Missions	Rolling 30-day launches with payload, stage, and recovery detail	Launch Library 2	🟢 (🔴 optional paid token raises the allowance)
🎖️ Mapped Installations	Viewport-bounded military-site context from community mapping — incomplete by nature, and labeled that way	OpenStreetMap	🟢
🌬️ Wind	Animated 10 m forecast wind with an optional speed, temperature or pressure color field and a reading at map center	NOAA GFS / ECMWF IFS	🟢
🌦️ Observed Weather	Rain radar (contiguous US), Satellite clouds (GOES regional or global infrared, Clouds only or Full image) and Lightning density (Americas and Pacific) on one history timeline	NOAA nowCOAST	🟢
🌀 Cyclones	Advisory positions, forecast tracks and uncertainty cones for the Atlantic and eastern/central North Pacific	NOAA NHC / CPHC	🟢

You have	The globe you get
🟢 Nothing	Esri World Imagery satellite basemap + keyless terrain, in 2D. OSM takes over automatically if Esri is unreachable; if terrain is unavailable the globe continues without it
🟡 A free Cesium ion token	Google Photorealistic 3D cities and world terrain — eligible personal, non-commercial use; current ion terms and quotas apply
🔴 A Google Maps key	The same 3D direct from Google, plus Google place search — the billing-enabled, metered route

Mission	How
🚁 Ask the planet	"Why are all these military helicopters flying in circles?" Select a military track — it silently backfills ~24 h of real trace history — and see what it's been doing, resolved as stacked 3D loops.
✈️ Final approach	Click-track an airliner lining up for a runway, hop into the cockpit, and ride it down.
🌃 Night watch	Fly to your own city, switch to NVG, and let the detection mesh and HUD read the scene.
🚢 Port call	Vessels on over the Port of Long Beach. Click a tanker for its tactical card and wake trail — then hit NEAREST in the CCTV panel and look at the same water through a public camera.
📻 Tokyo FM	Orbit Shibuya with the Radio layer on — then drag the analog tuner needle: every position snaps to a real station and the globe flies to whoever's broadcasting.
🔥 Fire line	FIRMS over California. Click a detection — the camera dives to it — read the intensity, then hit NEAREST in the CCTV panel for a ground view.
🚶 Ask for a walking route 🎙️	Tell the world where you want to go and watch a real street-following route trace itself through the 3D city — then "fly it": banked turns, eased ends, a camera that leads the path like a drone shot.
📏 Measure LAX to DFW 🎙️	"How far is LAX from DFW?" — an arrow spans the country, the distance lands in the caption, and the endpoints stay pinned to the real world as you orbit.
🚀 Launch replay	Open Space Missions, pick a launch from the last 30 days, and ride the T-minus countdown through ascent to orbit — scrub it at 0.25×–4×. Labeled `RECONSTRUCTED ESTIMATE`, because it is one.
🪦 Walk the boneyard	Fly from regional context down into dense, fully resolved rows of retired aircraft.
🏗️ Orbit Three Gorges	Sweep the dam and its terrain at a glance — then flip on the Dams layer and find 703 more.

	Key	Why	Get it
🟡	Cesium ion	🗺️ Google Photorealistic 3D, world terrain, and additional ion-hosted imagery stacks. The free Community plan is for eligible individual, personal/non-commercial use and has quotas	cesium.com/ion — use a public `assets:read` token and check current pricing/eligibility
🔴	Google Maps	Direct Google Photorealistic 3D, Google place search and Street View (Map Tiles API; Street View also needs the Maps JavaScript API)	Google Cloud Console — URL-restrict it
🔴	OpenAI	🎙️ Voice + AI HUD summary through an API key. Provider Settings also offers USE CHATGPT OAUTH for cloud voice without removing the API-key option	platform.openai.com — API-key usage is metered, see costs below
🟡	AISStream	🚢 Live global ships	aisstream.io — free signup
🟡	NASA FIRMS	🔥 Live active fires	firms.modaps.eosdis.nasa.gov — free
🟡	TomTom	🚦 Live flow speeds and congestion colors for the simulated traffic layer	my.tomtom.com — free tier available
🟡	Mapillary	📷 Street Level coverage and photos. A public client token by design (see SECURITY.md)	mapillary.com/dashboard/developers — register an app, copy its Client Token

	Key	Why	Get it
🟡	OpenSky	✈️ More flight-polling credits (🟢 anonymous works without)	opensky-network.org
🔴	Launch Library 2	🚀 Optional paid token for higher limits (🟢 no key needed for public access)	thespacedevs.com/supportus

bilawalsidhu/gods-eye-view

🌐 God's Eye View

A spy-satellite simulator in your browser — then you realize the sources are public and the data is real.

🌍 Why This Exists

🎛️ What This Thing Does

⚡ Quick Start

Path 1 — One click, no terminal

Path 2 — Terminal / coding agent

Path 3 — Docker

Then power it up — in the app, not in a file

🕐 The First Five Minutes

🛩️ The Cockpit

🎙️ Talk to It

🛰️ What's on the Globe

📷 Street Level

🎖️ Field Missions

🔧 Under the Hood

🔑 API Keys

Choose the capabilities you want

Cherry on top

💸 What it actually costs

🧗 The floor is low on purpose

🔒 Sharing an instance

📋 Responsible & Open

🧭 What's Next

	Cost reality
🟢 Most layers	$0, no signup. OpenSky anon, USGS, CelesTrak, adsb.lol, city CCTV, Radio Browser, GBFS, Launch Library 2, transit feeds, OSRM routing, NOAA and ECMWF weather, OpenStreetMap ALPR mapping, bundled datasets.
🟡 The free-key tier	$0 with a signup. AISStream, FIRMS, TomTom, OpenSky, plus Cesium ion for eligible personal/non-commercial use. Provider quotas and eligibility still apply.
🗺️ Google 3D tiles	Free through an eligible Cesium ion Community account within its quota; metered through a direct Google key. Use the direct route for Google place search or commercial deployment, verify current provider terms, and set budget alerts where billing is enabled.
🔴 OpenAI voice	API-key sessions keep the live spend readout, STD/MINI model toggle, $2 warning, and $5 hard cap. ChatGPT OAuth is an explicit choice in Provider Settings. Its usage is tracked without an API-dollar estimate or spend cap. The voice context window stays deliberately short.