bilawalsidhu/gods-eye-viewEin Spionagesatelliten-Simulator in deinem Browser, nur dass die Daten real sind. Live Open-Source-Raumfahrtaufklärung auf einem fotorealistischen 3D-Globus.
Fotorealistischer 3D-Globus. Live-Flugzeuge, Schiffe, Satelliten, Erdbeben, Verkehr und öffentliche Kameras, mit klar gekennzeichneten modellierten Ansichten, wenn kein Live-Feed verfügbar ist. Freihändige Sprachsteuerung durch einen Echtzeit-KI-Agenten.
Kein Ort bleibt zurück.
▶️ Vom Projekt hinter der viralen God's Eye View-Serie (ehemals WorldView) — 5M+ auf YouTube
Ihr habt gefragt, also passiert es. God's Eye View ist Open Source. Verfolge die Welt live. Sprich mit ihr. Brich sie. Erweitere sie.
Die meiste Open-Source-Intelligence ist ein Stapel Browser-Tabs. Die Signale sind reichlich vorhanden, aber die Schnittstelle ist der Engpass. God's Eye View verwandelt diese Signale in einen Ort: Die Welt sendet bereits – Flugzeugtransponder, Schiffssignale, Orbitalelemente, Seismographen, öffentliche Kameras – und das macht sie auf einer fotorealistischen 3D-Erde in Echtzeit sichtbar. Keine Geheimhaltungsstufe erforderlich; es ist durchgehend öffentliches Signal, und die Schnittstelle läuft in deinem Browser, unter deiner Kontrolle.
Die halbe Magie liegt darin, dass es wie ein verbotenes Cockpit aussieht. Die andere Hälfte ist, dass jede Zeile Code überprüfbar ist.
Die Live-Ebenen basieren auf öffentlichen Feeds: Das Verkehrsflugzeug, das über deinen Bildschirm fliegt, meldet Telemetrie, die Kamera ist an einem veröffentlichten Standort installiert, und die ISS-Position wird aus aktuellen Orbitalelementen abgeleitet. Der Client rendert Flüge absichtlich ein Abfrageintervall hinter der Echtzeit, damit er reibungslos interpolieren kann. Einige Erlebnisse sind modelliert statt live: Schlüsselloser Verkehr ist als Simulation gekennzeichnet, Kamerapositionen werden bis zur Kalibrierung geschätzt, und die Wiedergabe des Startaufstiegs ist als REKONSTRUIERTE SCHÄTZUNG markiert. Jede Ebene hält ihre Quelle und ihren Aktualitätsstatus sichtbar, einschließlich teilweiser, verzögerter, simulierter und nicht verfügbarer Zustände.
Erfordert Node.js 24.14.x oder 26.x (durch package.json erzwungen).
.env.example → .env und setze GOOGLE_MAPS_API_KEY.3. Öffnen Sie **`http://localhost:4173`**. Der Kaltstart liegt auf einem aktuellen Laptop bei unter zwei Sekunden (Median 1,86 s in einer zeitpunktbezogenen M5/Chrome-Erfassung — [docs/PERFORMANCE.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/docs/PERFORMANCE.md); eine Vergleichsbasis, keine Hardware-Anforderung). Eine Karte für den ersten Start bietet an, eine Mission für Sie vorzubereiten — **Live-Kontakte**, **Weltraummissionen**, **Umwelt** — oder überlässt Ihnen die manuelle Erkundung.
> [!TIP]
> **Kein Programmierer? Lassen Sie eine KI diese ganze Seite für Sie erledigen.** Ein Ein-Klick-Installer ist in Arbeit — bis dahin installieren Sie einen Coding-Agenten ([Claude Code](https://claude.com/claude-code), [Codex](https://openai.com/codex/), [Cursor](https://cursor.com) oder [Antigravity](https://antigravity.google)) und fügen Sie dies ein:
>
> ```text
> Klone https://github.com/bilawalsidhu/gods-eye-view und richte es auf meinem Rechner ein.
> Installiere alles, was es braucht, führe mich Schritt für Schritt durch die Beschaffung
> des erforderlichen Google-Maps-API-Schlüssels (plus alle optionalen kostenlosen Schlüssel,
> die ich möchte), lege die Schlüssel in .env ab und hilf mir, eine Abrechnungswarnung
> und ein Nutzungskontingent für den Google-Schlüssel einzurichten, damit ich nicht
> über das Budget hinausgehe. Starte dann den Dev-Server und öffne ihn in meinem Browser.
> Ich bin kein Entwickler — erkläre mir, was du tust, während du es tust, und frage mich
> vor jedem Schritt, der Geld kosten könnte.
> ```
**Dieser eine Schlüssel ist die gesamte Eintrittsgebühr.** Alles in dieser README ist farbcodiert — 🟢 benötigt nichts · 🟡 kostenloser Schlüssel · 🔴 gebührenpflichtig — und Google Maps ist der einzige 🔴, den Sie brauchen: Er kauft den fotorealistischen Planeten, und der Großteil des Globus leuchtet von dort an 🟢 auf. Für typisches Solo-Erkunden rechnen Sie mit **0 $ bei den meisten Ebenen** und Kleingeld bei den zwei gebührenpflichtigen: Google gewährt derzeit **1.000 kostenlose 3D-Tile-Sitzungen pro Monat** — jede gut für bis zu drei Stunden Rendering, was für eine einzelne Person sehr schwer auszuschöpfen ist — und Sprache hat eine eingebaute Obergrenze von 5 $ pro Sitzung. Vollständige Karte in [Schlüssel & Kosten](#-api-keys), vollständige ehrliche Aufschlüsselung in [Was es tatsächlich kostet](#-what-it-actually-costs).
Der Dev-Server bindet an **localhost** — Ihre Schlüssel bleiben auf Ihrem Rechner. Sicheres Teilen im LAN wird in [Freigeben einer Instanz](#-sharing-an-instance) und [SECURITY.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/SECURITY.md) behandelt.
**macOS-Verknüpfung:** `./scripts/dev-fresh.sh` leert den Vite-Cache und zieht Ihre Schlüssel direkt aus dem Schlüsselbund.
---
## 🕐 Die ersten fünf Minuten
Kein Konto, keine Anmeldung. Die Karte für den ersten Start bietet an, eine Mission für Sie vorzubereiten — oder Sie durchlaufen diesen Parcours selbst. Irgendwann in diesen fünf Minuten fühlt es sich nicht mehr wie eine Demo an:
1. **Erhellen Sie den Himmel.** Nehmen Sie die **Live-Kontakte**-Mission (oder aktivieren Sie **Flüge** selbst) — Tausende Live-Flugzeuge, die auf echter Telemetrie gleiten, das Erkennungsnetz liest bereits die Szene. Klicken Sie eines an: Die Kamera verriegelt, eine Spur wird dahinter gezeichnet, und seine Live-Telemetriekarte erscheint.
2. **Übernehmen Sie die Steuerung.** Drücken Sie **COCKPIT** auf Ihrem verfolgten Flugzeug und fliegen Sie es hinunter, wobei Sie die Sensoren mitten im Flug wechseln: NVG in Ironbow-FLIR. Das Cockpit trägt seinen eigenen Briefing-Streifen — nahe Live-Signale, regionale Schlagzeilen und echtes lokales Wetter, mit einem optionalen **WX**-Modus, der volumetrische Wolken aus tatsächlichen Beobachtungen rund um Ihr Flugzeug rendert — und **Kontakte** hält die 250-km-Liste nur einen Klick (oder einen Satz) entfernt: Springen Sie von Flugzeug zu Flugzeug und fallen Sie direkt ins nächste Cockpit.
3. **Lande auf einem belebten Flughafen.** Suchen Sie einen und steigen Sie mit aktivierten **3D**-Flugzeugen zu den Rollwegen hinab — Bodenkontakte, Rollspuren, das gesamte Vorfeld arbeitet in Echtzeit.
4. **Blicken Sie durch eine öffentliche Kamera.** Aktivieren Sie **CCTV** über Austin, London oder Kalifornien. Die Feeds sind keine Webcam-Einbettungen — sie projizieren *in* die 3D-Stadt. Wechseln Sie die Abdeckung auf **VIEWSHED**, und jede Kamera zeichnet ihr geschätztes Abdeckungsvolumen — wohin sie reicht und wo sie blind wird.
5. **Färben Sie die Straßen mit Stoßverkehr.** Aktivieren Sie **Verkehr** und tauchen Sie unter ~8 km — der Fluss pro Fahrzeug färbt sich nach den echten Staus (mit einem TomTom-Schlüssel; ohne Schlüssel ist es eine beschriftete Simulation). Drücken Sie dann **NEAREST** im CCTV-Panel und beobachten Sie den Stau durch die Kamera, die darauf gerichtet ist.
6. **Verfolgen Sie etwas im Orbit.** Aktivieren Sie **Satelliten** und klicken Sie die ISS — Sie reiten in Orbitaldistanz mit, inklusive Orbitring.
7. **Wechseln Sie die Optik.** Tippen Sie `1`–`7` — CRT, NVG, FLIR — und der gesamte Live-Planet rendert durch einen anderen Sensor neu.
8. **Sprechen Sie mit ihm** *(benötigt einen OpenAI-Schlüssel)*: *„Bring mich zu LAX und wähle das nächste luftgestützte Flugzeug aus."*
9. **Kommen Sie nach Hause.** Drücken Sie **Globus zurücksetzen** — oder sagen Sie einfach *„herauszoomen auf eine Globus-Ansicht."*
**Tastatur:** `1`–`7` visuelle Stile · `H` HUD · `D` Erkennung · `C` Cockpit · `Esc` raus.
---
## 🎙️ Sprechen Sie mit ihm
> Sprache benötigt einen **OpenAI-Schlüssel**. Ohne einen läuft die gesamte App weiter — die Mikrofontaste meldet nur, dass Sprache nicht verfügbar ist. Derselbe Schlüssel treibt die **KI-HUD-Zusammenfassung**: eine knappe, fünf Wörter umfassende Aufklärungs-Leseart der aktuellen Ansicht, die sich bei Bewegung neu generiert.
Klicken Sie auf **GEV MIC**, gewähren Sie dem Mikrofon Zugriff und sprechen Sie einfach. Das ist mehr als eine sprachgesteuerte Fernbedienung:
- **🧠 Es weiß, worauf es blickt.** Der Agent zieht vor der Antwort Live-Szenenkontext — einschließlich Koordinaten, Straßennamen, aktiver Ebenen und Ansichtsmaßstab. Fragen Sie mitten im Flug *„welche Stadt ist das?"*, und es weiß es.
- **🎯 Entitäts-Fragen.** Klicken Sie ein beliebiges Flugzeug, Schiff oder Rechenzentrum an und fragen Sie *„was ist das?"* Es antwortet mit der Live-Telemetrie des Objekts.
- **👁️ Visuelle Verankerung.** Auf Straßenebene liest es einen Viewport-Screenshot, um lesbare Beschilderung und Gebäudenamen zu identifizieren, und ist angewiesen, niemals Beschriftungen zu halluzinieren.
- **🎬 Filmische Bildgestaltung.** *„Zeig mir die Flugzeuge über uns"* zieht die Kamera zurück, neigt sie und rahmt den Live-Verkehr wie ein Regisseur.
- **🔒 Ehrlich und sicher.** Der Agent bestätigt nur Aktionen, die erfolgreich waren. Ihr `OPENAI_API_KEY` berührt niemals den Browser; der Client erhält nur ein kurzlebiges Sitzungstoken.
Achtundzwanzig Werkzeuge, vier Aufgaben — die folgenden Befehle stammen direkt aus der Sprachtest-Suite und dem Werkzeug-Playbook des Produkts:
**🎥 Direkt steuern** — Drohnen-Operator-Kameraverben:
> 🗣️ *„Bring mich nach Tokio."* · *„Umkreise diesen Bereich langsam."* · *„Zeichne die Gehroute vom Kapitol zum Zilker Park."* → *„Fliege die Route, die wir gerade gezeichnet haben."* · *„Herauszoomen auf eine Globus-Ansicht."*
**🖊️ Annotieren** — ein Whiteboard über der realen Welt:
> 🗣️ *„Umreiße den Bundesstaat Texas."* · *„Annotiere das Texas State Capitol und sein Gelände"* — es zeichnet die **tatsächliche umschließende Grenze**, keinen Kreis. · *„Wie weit ist der Eiffelturm vom Louvre entfernt?"* — ein Verbindungspfeil erscheint und es spricht die Entfernung aus. Alles bleibt bestehen, bis Sie *„Karte löschen"* sagen.
**🔎 Verhören** — Analystenabfragen gegen die Live-Ebenen:
> 🗣️ *„Wie viele Flüge sind gerade über Texas?"* · *„Welche Schiffe sind auf dem Weg nach Oakland?"* · *„Was ist das größte Feuer in der Nähe von Los Angeles?"* · *„Fliegt etwas über vierzigtausend Fuß?"* · *„Wann fliegt die ISS als Nächstes vorbei?"*
**🎛️ Bedienen** — die gesamte Konsole, freihändig:
> 🗣️ *„Wechsle zu Nachtsicht und aktiviere die Flug-Ebene."* · *„Aktiviere die Kamera-Viewsheds."* · *„Spiele einen Nachrichtenradiosender in der Nähe von Austin."* · *„Verfolge dieses Flugzeug."* → *„Cockpit betreten."*
**Und die Schnellfeuer-Stufe** — ein Satz pro Aktion:
> 🗣️ *„Zeig mir die globale Infrastruktur."* (inszeniert die Ebenen und zieht sich zum Globus zurück) · *„Spiele Orbital Watch."* (eine vollständige filmische Szene) · *„Setze die Erkennungsdichte auf fünfzig Prozent."* · *„Nächster Kontakt — nur Hubschrauber."* (mitten im Cockpit) · *„Zeig mir Weltraummissionen."* · *„Wechsle zu Bing-Luftbild."* · *„Schärfe das Bild ein wenig."* · *„Wechsle zum taktischen Layout."* · *„Was ist gerade aktiviert?"*
*Fragen Sie nach Radio in der Nähe von irgendwo, und der Globus beginnt zu senden — jede Station ist ein realer Ort, zu dem Sie fliegen können.*
---
## 🛰️ Was auf dem Globus ist
Dreizehn Live-Ebenen. **Zehn davon benötigen überhaupt nichts** — kein Schlüssel, kein Konto, keine Anmeldung.
| Ebene | Was Sie erhalten | Quelle | Auth |
|-------|--------------|--------|------|
| 🗺️ **Kartenstapel** | Google Photorealistic 3D, Bing-Luftbild, OSM | Google / Ion / OSM | 🔴 Google (erforderlich) · 🟡 ion für Bing · 🟢 OSM |
| ✈️ **Live-Flüge** | Tausende Live-Flugzeuge + Routenverlauf | OpenSky + adsb.lol | 🟢 (🟡 optional für mehr Abfrageguthaben) |
| 🎖️ **Militärflüge** | ADS-B-Militärverkehr in Bernstein | adsb.lol | 🟢 |
| 🚢 **Live-Schiffe** | Tausende Schiffe weltweit | AISStream | 🟡 |
| 🛰️ **Satelliten** | Ein Kernkatalog von etwa 840 Objekten, farbcodiert nach Klasse mit einer Live-Legende — der **DENSE**-Chip fügt die gesamte Starlink-Hülle hinzu | CelesTrak | 🟢 |
| 🌍 **Erdbeben** | Globale seismische Aktivität, letzte 24 h | USGS | 🟢 |
| 🚗 **Verkehr** | Live-Stauung, die den Fluss pro Fahrzeug auf Straßenebene antreibt — tauchen Sie unter ~8 km, und die Punkte färben sich nach echten Staus. Ohne Schlüssel ist es eine ungefähre Simulation | TomTom + OSM | 🟢 (🟡 TomTom macht es echt — besorgen Sie sich einen) |
| 📹 **CCTV-Netz** | ~800 öffentliche Kameras, die *in* den 3D-Raum projiziert werden — Austin · Kalifornien (Caltrans) · London (TfL). Positionen sind veröffentlicht; Posen sind geschätzte Priors, **die Sie durch Ziehen eines Gizmos auf der Kamera selbst kalibrieren** | Stadt-APIs | 🟢 |
| 📻 **Radio** | Geolokalisiertes Weltradio mit einem **analogen Tuner** — ziehen Sie die Nadel über bis zu 750 Stationen, und der Globus fliegt zu jedem Sender | Radio Browser / Rundfunkanstalten | 🟢 |
| 🚲 **Bikesharing** | Live-Verfügbarkeit der Stationen | GBFS | 🟢 |
| 🔥 **Aktive Brände** | Live-NASA-FIRMS-Erkennungen, letzte 24 h | NASA FIRMS | 🟡 |
| 🚀 **Weltraummissionen** | Rollierende 30-Tage-Starts mit Nutzlast-, Stufen- und Bergungsdetails | Launch Library 2 | 🟢 (🟡 optionales Token erhöht das Kontingent) |
| 🎖️ **Kartierte Anlagen** | Viewport-begrenzter Kontext militärischer Standorte aus Community-Kartierung — von Natur aus unvollständig und so beschriftet | OpenStreetMap | 🟢 |
**Ebenfalls auf dem Globus:** Nachbarschafts-Overlays · ein optionaler Cockpit-WX-Wolkeneffekt. **Gebündelte statische Infrastruktur:** Rechenzentren (4.351), Staudämme (704) und Seekabel (712).
**Eine Ebene fehlt, die Sie möchten?** Eröffnen Sie ein Issue — oder fügen Sie sie hinzu und senden Sie den PR.
---
## 🎖️ Feldmissionen
Sobald die Grundlagen sitzen, führen Sie diese aus:
| Mission | Wie |
|---|---|
| **🚁 Frag den Planeten** | *„Warum fliegen all diese Militärhubschrauber im Kreis?"* Wählen Sie eine Militärspur — sie füllt still ~24 h echter Spurverlauf nach — und sehen Sie, was sie getan hat, aufgelöst als gestapelte 3D-Schleifen. |
| **✈️ Endanflug** | Klicken Sie ein Verkehrsflugzeug an, das sich für eine Landebahn ausrichtet, springen Sie ins **Cockpit** und fliegen Sie es hinunter. |
| **🌃 Nachtwache** | Fliegen Sie zu Ihrer eigenen Stadt, wechseln Sie zu **NVG** und lassen Sie das Erkennungsnetz und das HUD die Szene lesen. |
| **🚢 Hafenanlauf** | Schiffe über dem Hafen von Long Beach. Klicken Sie einen Tanker für seine taktische Karte und Kielspur an — drücken Sie dann **NEAREST** im CCTV-Panel und betrachten Sie dasselbe Wasser durch eine öffentliche Kamera. |
| **📻 Tokio FM** | Umkreisen Sie Shibuya mit aktivierter **Radio**-Ebene — ziehen Sie dann die analoge Tunernadel: Jede Position rastet auf eine echte Station ein, und der Globus fliegt zu dem, der gerade sendet. |
| **🔥 Feuerlinie** | FIRMS über Kalifornien. Klicken Sie eine Erkennung an — die Kamera taucht zu ihr hinab — lesen Sie die Intensität und drücken Sie dann **NEAREST** im CCTV-Panel für eine Bodenansicht. |
| **🚶 Gehroute anfordern** *🎙️* | Sagen Sie der Welt, wohin Sie möchten, und beobachten Sie, wie sich eine echte straßenfolgende Route durch die 3D-Stadt zieht — dann *„fliegen Sie sie"*: banked turns, sanfte Enden, eine Kamera, die den Weg wie eine Drohnenaufnahme führt. |
| **📏 LAX nach DFW messen** *🎙️* | *„Wie weit ist LAX von DFW entfernt?"* — ein Pfeil spannt sich über das Land, die Entfernung landet in der Bildunterschrift, und die Endpunkte bleiben beim Umkreisen an der realen Welt verankert. |
| **🚀 Start-Wiederholung** | Öffnen Sie **Weltraummissionen**, wählen Sie einen Start der letzten 30 Tage und reiten Sie den T-minus-Countdown durch den Aufstieg bis in den Orbit — spulen Sie bei 0,25×–4×. Beschriftet `RECONSTRUCTED ESTIMATE`, weil es eine ist. |
| **🪦 Durch den Friedhof gehen** | Fliegen Sie vom regionalen Kontext hinab in dichte, vollständig aufgelöste Reihen ausgemusterter Flugzeuge. |
| **🏗️ Three Gorges umkreisen** | Überfliegen Sie den Staudamm und sein Gelände auf einen Blick — aktivieren Sie dann die **Staudämme**-Ebene und finden Sie 703 weitere. |
| **🌊 Dem Rückgrat folgen** | Tauchen Sie mit aktivierten **Seekabeln** zu den Bahamas — beschriftete Routen offenbaren sich unter dem Wasser, 712 weltweit. |
*🎙️ = Sprachmissionen — sie benötigen einen OpenAI-Schlüssel.*
*Fragen Sie den Planeten: die letzten ~24 Stunden echter Spurverlauf eines Militärkontakts, aufgelöst als gestapelte 3D-Schleifen.*
*„Zeichne die Gehroute … jetzt fliege sie" — banked turns, sanfte Enden, die Kamera führt den Weg wie eine Drohnenaufnahme.*
*Durch den Friedhof gehen: Reihen ausgemusterter Flugzeugzellen, vollständig in 3D aufgelöst.*
*Start-Wiederholung: ein Falcon-9-Aufstieg, beschriftet `RECONSTRUCTED ESTIMATE`, abspulbar bei 0,25×–4×.*
*Dem Rückgrat folgen: die Seekabelrouten unter den Bahamas.*
---
## 🔧 Unter der Haube
Einige der Technik, die es real statt wie eine Tech-Demo wirken lässt:
- **Weltstabile Symbole.** Flugzeuge und Schiffe zeigen bei jedem Kamerawinkel entlang ihrer *echten realen Kursrichtung* — verfolgt oder nicht, direkt nach unten oder über den Horizont — mittels bildschirmraumbezogener Kursprojektion pro Frame. Kein Drehen, kein Viewport-Sperren.
- **Sanfte Bewegung aus ruckeligen Daten.** Live-Feeds kommen alle 15–30 s; der Globus rendert ein Intervall hinter der Echtzeit und interpoliert zwischen bekannten Fixpunkten. Tote-Rechnung füllt die Lücken.
- **Ehrliche Satelliten.** SGP4-Propagation mit Orbitringen, die über GMST-Neuausrichtung an ihren Satelliten verriegelt bleiben — kein Drift, kein Flackern pro Sekunde.
- **Sitzt auf dem echten Boden.** Entitätshöhen laufen durch ein echtes vertikales Datum — geoidbewusst, gegen das *gerenderte* Geländenetz abgetastet — sodass Flugzeuge auf Vorfeldern parken und Kameras an Straßenecken stehen, statt zu schweben.
- **Gibt Ihr Kontingent aus, als wäre es sein eigenes.** Die kostenpflichtigen Feeds laufen hinter gecachten, budgetgesteuerten Proxys — ein OpenSky-Guthabenregler, ein tägliches TomTom-Tile-Budget, auf der Festplatte gecachte TLEs — sodass ein Nachmittag Erkunden kein API-Kontingent verbrennt.
- **Lokale Schlüsselverwaltung zuerst.** Geheimnistragende Anbieter wie OpenAI, AISStream, OpenSky-OAuth, TomTom und FIRMS werden serverseitig vermittelt. Proxy-Ziele sind fest oder auf eine Whitelist gesetzt, und die risikoreicheren Pfade fügen begrenzte Anfragen, Timeouts, Antwortobergrenzen und bereinigte Fehler hinzu, wo angemessen. Die einzigen Anbieteranmeldedaten, die absichtlich dem Browser ausgesetzt sind, sind Google Maps und Cesium ion; schränken Sie beide beim Anbieter ein.
- **Kein Framework.** Vanilla JavaScript, **CesiumJS** und **Vite** — plus **Google Photorealistic 3D Tiles** für den Planeten und die **OpenAI Realtime API** für Sprache. Schnell zu lesen, schnell zu hacken.```
src/
├── main.js # Bootstrap: Google 3D tiles, layer registration
├── ui.js # Runtime UI — panels, HUD, styles, control facade
├── hud.js # Intelligence HUD + AI scene summary
├── mapStackController.js # Google 3D / Bing / OSM switching
├── iconOrientation.js # Screen-projected world-space headings + horizon cull
├── voice/ # OpenAI Realtime session + 28 voice tools
├── data/ # One module per layer + management + context store
│ └── local_data/ # Bundled datasets (per-folder provenance)
└── scenes/ # Cinematic scene director
Siehe docs/CURRENT-STATE.md für die maßgebliche Laufzeit-Referenz.
Die Legende, noch einmal: 🟢 keine Anmeldung — funktioniert sofort · 🟡 kostenloser Schlüssel — registrieren, einfügen, fertig · 🔴 abgerechnet — ein Konto mit aktivierter Abrechnung; die Kosten sind gering, aber real.
Der größte Teil der Welt ist 🟢: Flüge (anonym), militärischer Verkehr, Satelliten, Erdbeben, CCTV, Radio, Bikesharing, Weltraummissionen, kartierte Anlagen und alle gebündelten Datensätze laufen mit null Schlüsseln.
Fünf Schlüssel decken die vollständig schlüsselbasierte Erfahrung ab. Drei bieten derzeit kostenlosen Entwicklerzugang; Google Maps und OpenAI werden nach Nutzung abgerechnet. Preise und Freigrenzen der Anbieter ändern sich, also nutze die verlinkten Preisseiten, bevor du dich auf eine Budgetschätzung verlässt:
| Schlüssel | Warum | Erhalten | |
|---|---|---|---|
| 🔴 | Google Maps (erforderlich) | Der fotorealistische 3D-Planet (Map Tiles API) | Google Cloud Console — abgerechnet; aktuelle Preise prüfen und per URL einschränken |
| 🔴 | OpenAI | 🎙️ Das Spracherlebnis + KI-HUD-Zusammenfassung. Du willst einen anderen Anbieter hinter dem Mikrofon? PRs willkommen | platform.openai.com — abgerechnet; aktuelle API-Preise prüfen |
| 🟡 | AISStream | 🚢 Live-Schiffe weltweit | aisstream.io — kostenlos, wirklich, es ist eine Zwei-Minuten-Anmeldung |
| 🟡 | NASA FIRMS | 🔥 Live aktive Brände | firms.modaps.eosdis.nasa.gov — kostenlos |
| 🟡 | TomTom | 🚦 Echter Verkehr statt einer ungefähren Simulation | developer.tomtom.com — prüfe die aktuelle Entwickler-Freigrenze für dein Konto |
Was dir der TomTom-Schlüssel bringt: Schritt 5 von Die ersten fünf Minuten für echt — tatsächliche Stoßzeitdichte auf der Stadt gemalt statt einer ungefähren Simulation.
| Schlüssel | Warum | Erhalten | |
|---|---|---|---|
| 🟡 | Cesium ion | 🗺️ Bing-Bildkarten-Stapel (öffentliches assets:read-Token) | cesium.com/ion — den Plan prüfen, der zu deiner Nutzung passt |
| 🟡 | OpenSky | ✈️ Mehr Flugabfrage-Guthaben (🟢 anonym funktioniert auch ohne) | opensky-network.org |
| 🟡 | Launch Library 2 | 🚀 Höheres Anfragekontingent für Weltraummissionen (🟢 funktioniert auch ohne) | thespacedevs.com |
Alle sind es wert, geholt zu werden. Keiner davon ist erforderlich, um zu starten.```bash
OPENAI_API_KEY="…" AISSTREAM_API_KEY="…" npm run dev -- --host localhost --port 4173
Auf macOS kannst du auch jeden Schlüssel im Schlüsselbund ablegen und `./scripts/dev-fresh.sh` zieht sie dort hinein — die Dienstnamen für `security add-generic-password` sind in `.env.example` dokumentiert.
OpenSky kann vollständig anonym laufen (`OPENSKY_AUTH_MODE=anon`) oder OAuth-Anmeldedaten mit `./scripts/opensky-import-client.sh /path/to/credentials.json` importieren.
### 💸 Was es tatsächlich kostet
Ehrliche Zahlen, grob, Stand Mitte 2026 — prüfe immer die aktuellen Preisseiten der Anbieter:
| | Kostenrealität |
|---|---|
| **🟢 Die meisten Ebenen** | **0 $, keine Anmeldung.** OpenSky anon, USGS, CelesTrak, adsb.lol, Stadt-CCTV, Radio Browser, GBFS, Launch Library 2, gebündelte Datensätze. |
| **🟡 Optionaler Entwicklerzugang** | AISStream, FIRMS, TomTom, Cesium ion und authentifiziertes OpenSky bieten möglicherweise kostenlosen Zugang, aber Limits und zulässige Nutzungen unterscheiden sich. Insbesondere Cesium ion und OpenSky haben Tarif- oder Nutzungsbeschränkungen; prüfe die aktuellen Anbieterbedingungen für deinen Einsatz. |
| **🔴 Google-3D-Kacheln** | Großzügiger als man denkt: Die Abrechnung zählt **Root-Tileset-Anfragen** — eine kauft bis zu **drei Stunden** unbegrenztes Kachel-Rendering — und die ersten **1.000 pro Monat sind kostenlos**, danach etwa **6 $ pro 1.000** (US-Preise; [aktuelle Seite prüfen](https://developers.google.com/maps/billing-and-pricing/pricing), Preise variieren je nach Abrechnungsregion). Ein Einzelnutzer verlässt die kostenlose Stufe selten. Trotzdem: Schlüssel einschränken, Kontingente festlegen und vor dauerhafter Nutzung eine Budgetwarnung konfigurieren. |
| **🔴 OpenAI-Sprache** | Echtzeit-Audio wird nach Nutzung abgerechnet, und die Gesamtsumme hängt vom gewählten Modell, der Gesprächslänge und der Audiomenge ab. Die App zeigt eine Live-Sitzungsschätzung, warnt bei 2 $ und wendet ein **Sitzungslimit von 5 $ in der App** an; nutzungsbezogene Limits des Anbieters bleiben die Abrechnungs-Absicherung. |
### 🧗 Die Einstiegshürde ist bewusst niedrig
Alles oben ist die bewusst günstige Basislinie — genug, um einen echten Eindruck von Geodatenaufklärung, GEOINT und OSINT zu bekommen, ohne je mit einem Vertriebsteam zu sprechen. Du wirst auch die Obergrenze bemerken: Terrestrisches AIS verstummt mitten im Ozean, und Satelliten-AIS kostet echtes Geld; Premium-Bildmaterial, SAR und die tieferen kommerziellen Feeds liegen hinter Unternehmensverträgen. Das ist keine Grenze der Architektur — jede Ebene hier ist ein Muster, das du auf deine eigenen Datenquellen ausrichten kannst. Dieses Repo gibt dir das Fundament; was du hinein integrierst, liegt bei dir.
### 🔒 Eine Instanz teilen
Standardmäßig kann niemand sonst deinen Server erreichen — er bindet an localhost. Um ihn in deinem LAN zu teilen, musst du dich explizit dafür entscheiden (`npm run dev -- --host 0.0.0.0 --port 4173`, oder `HOST=0.0.0.0 ./scripts/dev-fresh.sh` auf macOS/Linux) — aber wisse, dass ⚠️ **ein im LAN sichtbarer Server deine konfigurierten API-Schlüssel an jeden weitergibt, der ihn erreichen kann.** Setze die Pro-IP-Drosselungen (`GEV_RATELIMIT_OPENAI_PER_MIN`, `GEV_RATELIMIT_GOOGLE_PER_MIN` — siehe `.env.example`) und setze vor allem anderen **budgetbezogene Obergrenzen auf Anbieterseite** (Google-Cloud-Budgets, OpenAI-Nutzungslimits): Die Drosselungen sind Schutzmechanismen auf App-Ebene, keine Abrechnungsobergrenzen. Das vollständige Bedrohungsmodell findest du in [SECURITY.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/SECURITY.md).
---
## 📋 Verantwortungsvoll & offen
God's Eye View läuft auf **öffentlichen Daten, klaren Quellen und lokaler Ausführung.** Keine Geheimnisse, keine privaten Datensätze, kein mysteriöses Scraping — alles, was einen privaten Schlüssel betrifft, wird serverseitig vermittelt. Es hat die visuelle Grammatik eines Geheimdienst-Einsatzraums, aufgebaut vollständig aus offenen Signalen und überprüfbarem Code.
**Die Grenze.** Dieses Projekt modelliert **Ereignisse, Vermögenswerte, Infrastruktur und Systeme** — Flugzeuge, Schiffe, Satelliten, Brände, Kameras, Städte. Es baut keine Funktionen für die Suche nach benannten Personen, Gesichtserkennung oder die Verfolgung von Einzelpersonen, und Pull Requests, die diese Grenze überschreiten, werden nicht zusammengeführt. Menschen sind hier kein Abfragetyp.
**Bau mit.** Dies ist der kanonische Live-3D-Client aus dem Projekt, das die jüngste Welle räumlicher Intelligenz-Tools angestoßen hat — und es ist eine Leinwand: Die Ebenen hier sind die Signale, die eine einzelne Person finden und integrieren konnte. Füge ein Stadtpaket, eine Datenquelle, einen Stil, ein Sprachwerkzeug hinzu. Es ist das Fenster, durch das du die Welt siehst; bring dieses Fenster zu anderen.
**Status:** Ein sich entwickelnder Open-Source-Client für Erkundung und Lernen — ein schnelles, hackbares Fundament, kein gehärteter Produktionsdienst. Veröffentlicht unter der **[MIT-Lizenz](https://github.com/bilawalsidhu/gods-eye-view/blob/main/LICENSE)**. Gebündelte und Live-Datensätze unterliegen ihren eigenen Bedingungen — siehe **[DATA_SOURCES.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/DATA_SOURCES.md)**. Sicherheitsmodell: **[SECURITY.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/SECURITY.md)**. Du möchtest beitragen? **[CONTRIBUTING.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/CONTRIBUTING.md)**.
<sub>Hinweis zu Medien: Bilawal Sidhu hat die 17 Capture-GIFs auf dieser Seite erstellt und besitzt sie. Er hat außerdem die beiden README-PNGs im bestehenden öffentlichen Projekt veröffentlicht und deren fortgesetzte Aufnahme hier autorisiert. Jedes Auftreten von Bilawal erfolgt mit seiner Erlaubnis. Diese Dateien sind Projektdokumentation, keine unter MIT lizenzierten eigenständigen Assets. Plattformschnittstellen, Marken, Avatare, Daten und Bilder Dritter, die darin sichtbar sind, unterliegen weiterhin den Bedingungen ihrer jeweiligen Eigentümer. Siehe [Medienherkunft](https://github.com/bilawalsidhu/gods-eye-view/blob/main/docs/media/README.md) und [Quellenbedingungen](https://github.com/bilawalsidhu/gods-eye-view/blob/main/DATA_SOURCES.md).</sub>
> [!IMPORTANT]
> God's Eye View ist eine explorative Visualisierung öffentlicher Daten und Daten Dritter.
> Daten können verzögert, unvollständig, modelliert, abgeleitet oder falsch sein. Verwende es nicht
> für Flug- oder Seeschifffahrt, Notfallmaßnahmen, medizinische oder gesundheitliche
> Entscheidungen, Anlageentscheidungen oder andere sicherheitskritische oder operative
> Zwecke. Überprüfe wichtige Informationen mit maßgeblichen Quellen.
---
## 🧭 Was als Nächstes kommt
Zuerst — danke. An alle, die sich die God-View-Demos angesehen und ihre eigenen gebaut haben, und an alle, die immer wieder nach dem Code gefragt haben: Ich bin dankbar. Und als ich umfragte, ob das hier Open Source werden sollte, wart ihr nicht gerade subtil:
<img src="https://assets.kitploit.com/production/public/readmes/53672/d1eee944eaf04d9063d0251d21e1c8eb3b30471dc576044bab58917e35995924/aab0b9bd11b208c5db0f4e7b6c717c6c688fe22ca0c7996169f17b4a5c526b24-display-v1.webp" alt="Community-Umfrage zur Veröffentlichung von God's Eye View als Open Source" width="460">
Also hier ist es. Tritt ein in das Spionagethriller-Cockpit — nur dass die Daten echt sind — und lass uns das in unsere gemeinsame Sandbox verwandeln, um die Welt zu verstehen, und dabei Spaß haben. Dieses Repo ist die Basislinie, es bleibt offen, und der ganze Sinn ist, dass du Dinge kaputt machst und Ebenen anbringst, an die wir noch nicht gedacht haben.
Ein Hinweis von innen: Baue eine Woche lang in diesem Bereich und du lernst, dass **die Gegenwart der billige Teil ist**. In dem Moment, in dem du in der Zeit zurückgehen willst — *was passiert ist* und *was sich geändert hat* in beliebiger Auflösung zu kacheln, auszuliefern und zu bereinigen — werden die Daten teuer und die Rechenleistung brutal. Dafür bauen wir etwas Cooles. Mehr in der Zukunft — [halfpixel.ai](https://halfpixel.ai).
---
<div align="center">
▶️ [Sieh dir die God's Eye View-Serie an](https://youtube.com/playlist?list=PL6qSg2I-7_koPbDnSMo0QeeHX_RknA2uv&si=nBGYMoHWQw41v93Q) · 📬 [Map the World](https://maptheworld.ai/) — der Newsletter hinter dem Projekt
**🌐 God's Eye View. Kein Ort bleibt zurück.**
</div>