bilawalsidhu/gods-eye-viewआपके ब्राउज़र में एक जासूसी उपग्रह सिम्युलेटर, सिवाय इसके कि डेटा वास्तविक है। एक फोटोरियलिस्टिक 3D ग्लोब पर लाइव ओपन सोर्स स्पेशियल इंटेलिजेंस।
फोटोरियलिस्टिक 3D ग्लोब। लाइव विमान, जहाज़, उपग्रह, भूकंप, यातायात, और सार्वजनिक कैमरे, जहाँ लाइव फ़ीड उपलब्ध नहीं है वहाँ स्पष्ट रूप से लेबल किए गए मॉडल किए गए दृश्य। एक रीयलटाइम AI एजेंट द्वारा संचालित हैंड्स-फ्री वॉयस कंट्रोल।
कोई जगह पीछे नहीं छूटती।
▶️ वायरल God's Eye View सीरीज़ के पीछे के प्रोजेक्ट से (पूर्व में WorldView) — YouTube पर 5M+
आपने पूछा, इसलिए यह हो रहा है। God's Eye View ओपन सोर्स है। दुनिया को लाइव ट्रैक करें। इससे बात करें। इसे तोड़ें। इसे विस्तारित करें।
अधिकांश ओपन-सोर्स इंटेलिजेंस ब्राउज़र टैब का ढेर है। सिग्नल प्रचुर हैं, लेकिन इंटरफ़ेस ही बाधा है। God's Eye View उन सिग्नलों को एक स्थान में बदल देता है: दुनिया पहले से ही प्रसारण कर रही है — फ्लाइट ट्रांसपोंडर, जहाज़ बीकन, ऑर्बिटल एलिमेंट्स, सीस्मोग्राफ़, सार्वजनिक कैमरे — और यह इसे फोटोरियलिस्टिक 3D पृथ्वी पर रीयल टाइम में दृश्यमान बनाता है। कोई वर्गीकृत मंज़ूरी आवश्यक नहीं; यह पूरी तरह सार्वजनिक सिग्नल है, और इंटरफ़ेस आपके ब्राउज़र में, आपके नियंत्रण में चलता है।
आधा जादू यह है कि यह एक निषिद्ध कॉकपिट जैसा दिखता है। दूसरा आधा यह है कि कोड की हर पंक्ति निरीक्षण योग्य है।
लाइव लेयर्स सार्वजनिक फ़ीड पर आधारित हैं: आपकी स्क्रीन पार करने वाला एयरलाइनर टेलीमेट्री रिपोर्ट कर रहा है, कैमरा एक प्रकाशित स्थान पर स्थापित है, और ISS की स्थिति वर्तमान ऑर्बिटल एलिमेंट्स से प्रचारित होती है। क्लाइंट जानबूझकर फ्लाइट्स को रीयल टाइम से एक पोलिंग अंतराल पीछे रेंडर करता है ताकि वह सुचारू रूप से इंटरपोलेट कर सके। कुछ अनुभव लाइव के बजाय मॉडल किए गए हैं: बिना कुंजी वाला यातायात सिमुलेशन के रूप में लेबल किया गया है, कैमरा पोज़ का अनुमान तब तक लगाया जाता है जब तक कैलिब्रेट न हो, और लॉन्च आरोहण प्लेबैक RECONSTRUCTED ESTIMATE के रूप में चिह्नित है। प्रत्येक लेयर अपने स्रोत और ताज़गी की स्थिति को दृश्यमान रखता है, जिसमें आंशिक, विलंबित, सिम्युलेटेड, और अनुपलब्ध स्थितियाँ शामिल हैं।
Node.js 24.14.x या 26.x आवश्यक है (package.json द्वारा लागू)।
.env.example → .env कॉपी करें और GOOGLE_MAPS_API_KEY सेट करें।3. **`http://localhost:4173`** खोलें। हाल के लैपटॉप पर कोल्ड स्टार्ट दो सेकंड से कम में तैयार हो जाता है (एक पॉइंट-इन-टाइम M5/Chrome कैप्चर में माध्य 1.86 सेकंड — [docs/PERFORMANCE.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/docs/PERFORMANCE.md); यह एक तुलना आधार रेखा है, हार्डवेयर आवश्यकता नहीं)। पहली बार चलाने पर एक कार्ड आपके लिए एक मिशन तैयार करने की पेशकश करता है — **Live Contacts**, **Space Missions**, **Environmental** — या आपको मैन्युअल रूप से खोजने के लिए छोड़ देता है।
> [!TIP]
> **कोडर नहीं हैं? किसी AI से यह पूरा पेज आपके लिए करवाएं।** एक-क्लिक इंस्टॉलर काम में है — तब तक, एक कोडिंग एजेंट इंस्टॉल करें ([Claude Code](https://claude.com/claude-code), [Codex](https://openai.com/codex/), [Cursor](https://cursor.com), या [Antigravity](https://antigravity.google)) और यह पेस्ट करें:
>
> ```text
> Clone https://github.com/bilawalsidhu/gods-eye-view and set it up on my machine.
> Install everything it needs, walk me through getting the required Google Maps API
> key step by step (plus any optional free keys I want), put the keys in .env, and
> help me set a billing alert and a usage quota on the Google key so I can't
> overspend. Then start the dev server and open it in my browser. I'm not a
> developer — explain what you're doing as you go, and ask me before any step
> that could cost money.
> ```
**वह एक कुंजी ही पूरी प्रवेश फीस है।** इस README में सब कुछ रंग-कोडित है — 🟢 को कुछ नहीं चाहिए · 🟡 मुफ्त कुंजी · 🔴 मीटर्ड — और Google Maps ही एकमात्र 🔴 है जिसकी आपको ज़रूरत है: यह फोटोरियलिस्टिक ग्रह खरीदता है, और वहाँ से अधिकांश ग्लोब 🟢 रोशन हो जाता है। सामान्य अकेले खोज के लिए, **अधिकांश लेयर्स पर $0** और मीटर्ड दो पर बहुत कम खर्च की उम्मीद करें: Google वर्तमान में **प्रति माह 1,000 मुफ्त 3D-टाइल सत्र** देता है — प्रत्येक तीन घंटे तक के रेंडरिंग के लिए पर्याप्त है, जिसे एक व्यक्ति के लिए खत्म करना बहुत मुश्किल है — और वॉइस में अंतर्निहित $5 सत्र सीमा है। पूरा नक्शा [Keys & Costs](#-api-keys) में, पूरा ईमानदार विवरण [What it actually costs](#-what-it-actually-costs) में।
डेव सर्वर **localhost** से बंधा है — आपकी कुंजियाँ आपकी मशीन पर रहती हैं। LAN पर सुरक्षित रूप से साझा करना [Sharing an instance](#-sharing-an-instance) और [SECURITY.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/SECURITY.md) में शामिल है।
**macOS शॉर्टकट:** `./scripts/dev-fresh.sh` Vite कैश साफ़ करता है और आपकी कुंजियाँ सीधे Keychain से खींचता है।
---
## 🕐 पहले पाँच मिनट
कोई खाता नहीं, कोई साइनअप नहीं। पहली बार चलाने वाला कार्ड आपके लिए एक मिशन तैयार करने की पेशकश करेगा — या यह चुनौती खुद पूरी करें। इन पाँच मिनटों में कहीं न कहीं यह डेमो जैसा महसूस होना बंद कर देता है:
1. **आसमान को रोशन करें।** **Live Contacts** मिशन लें (या खुद **Flights** चालू करें) — हज़ारों लाइव विमान, वास्तविक टेलीमेट्री पर ग्लाइड करते हुए, डिटेक्शन मेश पहले से ही दृश्य पढ़ रहा है। एक पर क्लिक करें: कैमरा लॉक हो जाता है, उसके पीछे एक ट्रेल बनती है, और उसका लाइव टेलीमेट्री कार्ड सामने आता है।
2. **नियंत्रण लें।** अपने ट्रैक किए गए विमान पर **COCKPIT** दबाएं और उसके साथ नीचे उड़ें, उड़ान के दौरान सेंसर बदलते हुए: NVG से Ironbow FLIR तक। कॉकपिट अपनी खुद की ब्रीफिंग पट्टी रखता है — पास के लाइव सिग्नल, क्षेत्रीय हेडलाइन, और वास्तविक स्थानीय मौसम, एक ऑप्ट-इन **WX** मोड के साथ जो आपके विमान के आसपास के वास्तविक अवलोकनों से वॉल्यूमेट्रिक बादल रेंडर करता है — और **Contacts** 250 किमी की सूची को एक क्लिक (या एक वाक्य) दूर रखता है: विमान से विमान पर कूदें और सीधे अगले कॉकपिट में गिरें।
3. **व्यस्त हवाई अड्डे पर उतरें।** एक खोजें और **3D** विमान चालू करके टैक्सीवे तक उतरें — ज़मीन पर संपर्क, टैक्सी ट्रेल्स, पूरा एप्रन वास्तविक समय में काम कर रहा है।
4. **सार्वजनिक कैमरे से देखें।** Austin, London, या California पर **CCTV** चालू करें। फ़ीड वेबकैम एम्बेड नहीं हैं — वे 3D शहर में *प्रोजेक्ट* होते हैं। कवरेज को **VIEWSHED** पर साइकिल करें और हर कैमरा अपनी अनुमानित कवरेज मात्रा खींचता है — यह कहाँ पहुँचता है, और कहाँ अंधा हो जाता है।
5. **भीड़ के समय से सड़कों को रंगें।** **Traffic** चालू करें और ~8 किमी से नीचे गोता लगाएं — प्रति-वाहन प्रवाह वास्तविक जाम में रंग बदलता है (TomTom कुंजी के साथ; बिना कुंजी यह एक लेबल वाला सिमुलेशन है)। फिर CCTV पैनल में **NEAREST** दबाएं और उस कैमरे के माध्यम से जाम देखें जो उस पर इंगित है।
6. **कक्षा में कुछ ट्रैक करें।** **Satellites** चालू करें और ISS पर क्लिक करें — आप कक्षीय दूरी पर, ऑर्बिट रिंग और सब कुछ के साथ सवारी करते हैं।
7. **ऑप्टिक्स बदलें।** `1`–`7` दबाएं — CRT, NVG, FLIR — और पूरा लाइव ग्रह एक अलग सेंसर के माध्यम से फिर से रेंडर होता है।
8. **इससे बात करें** *(OpenAI कुंजी चाहिए)*: *"मुझे LAX ले चलो और निकटतम हवाई विमान चुनो।"*
9. **घर वापस आएं।** **Reset Globe** दबाएं — या बस कहें *"ग्लोब व्यू पर ज़ूम आउट करो।"*
**कीबोर्ड:** `1`–`7` विज़ुअल स्टाइल · `H` HUD · `D` डिटेक्शन · `C` कॉकपिट · `Esc` बाहर।
---
## 🎙️ इससे बात करें
> वॉइस के लिए **OpenAI कुंजी** चाहिए। इसके बिना पूरा ऐप अभी भी चलता है — माइक बटन बस रिपोर्ट करता है कि वॉइस अनुपलब्ध है। वही कुंजी **AI HUD सारांश** भी चलाती है: वर्तमान दृश्य का एक संक्षिप्त, पाँच-शब्दों वाला खुफिया-शैली रीडआउट जो आपके हिलने पर फिर से उत्पन्न होता है।
**GEV MIC** पर क्लिक करें, माइक्रोफ़ोन अनुमति दें, और बस बात करें। यह एक वॉइस-नियंत्रित रिमोट से कहीं अधिक है:
- **🧠 यह जानता है कि यह क्या देख रहा है।** एजेंट उत्तर देने से पहले लाइव दृश्य संदर्भ खींचता है — जिसमें निर्देशांक, सड़क के नाम, सक्रिय लेयर्स, और दृश्य पैमाना शामिल हैं। उड़ान के दौरान *"यह कौन सा शहर है?"* पूछें और यह जानता है।
- **🎯 एंटिटी Q&A।** किसी भी विमान, जहाज, या डेटासेंटर पर क्लिक करें और *"यह क्या है?"* पूछें। यह वस्तु के लाइव टेलीमेट्री का उपयोग करके उत्तर देता है।
- **👁️ विज़ुअल ग्राउंडिंग।** सड़क स्तर पर, यह पठनीय साइनेज और इमारत के नाम पहचानने के लिए एक व्यूपोर्ट स्क्रीनशॉट पढ़ता है, और उसे कभी भी लेबल की कल्पना न करने का निर्देश दिया जाता है।
- **🎬 सिनेमैटिक फ्रेमिंग।** *"मुझे ऊपर के विमान दिखाओ"* कैमरा पीछे खींचता है, उसे कोण देता है, और लाइव ट्रैफ़िक को एक निर्देशक की तरह फ्रेम करता है।
- **🔒 ईमानदार और सुरक्षित।** एजेंट केवल उन कार्यों की पुष्टि करता है जो सफल हुए। आपकी `OPENAI_API_KEY` कभी ब्राउज़र को नहीं छूती; क्लाइंट को केवल एक अल्पकालिक सत्र टोकन मिलता है।
अट्ठाईस उपकरण, चार कार्य — नीचे दिए गए कमांड सीधे उत्पाद के वॉइस टेस्ट सूट और टूल प्लेबुक से आते हैं:
**🎥 इसे निर्देशित करें** — ड्रोन-ऑपरेटर कैमरा क्रियाएँ:
> 🗣️ *"मुझे टोक्यो ले चलो।"* · *"इस क्षेत्र के चारों ओर धीरे-धीरे ऑर्बिट करो।"* · *"कैपिटल से Zilker Park तक चलने का रास्ता बनाओ।"* → *"अभी बनाए गए रास्ते पर उड़ो।"* · *"ग्लोब व्यू पर ज़ूम आउट करो।"*
**🖊️ इसे एनोटेट करें** — वास्तविक दुनिया पर एक व्हाइटबोर्ड:
> 🗣️ *"टेक्सास राज्य की रूपरेखा बनाओ।"* · *"Texas State Capitol और उसके मैदान को एनोटेट करो"* — यह **वास्तविक घेरने वाली सीमा** खींचता है, एक वृत्त नहीं। · *"एफिल टॉवर से लौवर कितनी दूर है?"* — एक कनेक्टर तीर दिखाई देता है और यह दूरी बोलता है। सब कुछ तब तक बना रहता है जब तक आप *"नक्शा साफ़ करो"* नहीं कहते।
**🔎 इसे पूछताछ करें** — लाइव लेयर्स के खिलाफ विश्लेषक प्रश्न:
> 🗣️ *"अभी टेक्सास के ऊपर कितनी उड़ानें हैं?"* · *"कौन से जहाज Oakland की ओर जा रहे हैं?"* · *"लॉस एंजिल्स के पास सबसे बड़ी आग कौन सी है?"* · *"क्या चालीस हज़ार फीट से ऊपर कुछ उड़ रहा है?"* · *"ISS अगली बार कब ऊपर से गुजरेगा?"*
**🎛️ इसे संचालित करें** — पूरा कंसोल, हाथों से मुक्त:
> 🗣️ *"नाइट विज़न पर स्विच करो और फ्लाइट्स लेयर चालू करो।"* · *"कैमरा व्यूशेड चालू करो।"* · *"Austin के पास एक न्यूज़ रेडियो स्टेशन चलाओ।"* · *"उस विमान को ट्रैक करो।"* → *"कॉकपिट में प्रवेश करो।"*
**और रैपिड-फायर स्तर** — प्रत्येक एक वाक्य:
> 🗣️ *"मुझे वैश्विक बुनियादी ढांचा दिखाओ।"* (लेयर्स तैयार करता है और ग्लोब पर पीछे खींचता है) · *"Orbital Watch चलाओ।"* (एक पूर्ण सिनेमैटिक दृश्य) · *"डिटेक्शन घनत्व पचास प्रतिशत सेट करो।"* · *"अगला संपर्क — केवल हेलीकॉप्टर।"* (कॉकपिट के बीच में) · *"मुझे स्पेस मिशन दिखाओ।"* · *"Bing एरियल पर स्विच करो।"* · *"छवि को थोड़ा तेज़ करो।"* · *"सामरिक लेआउट पर स्विच करो।"* · *"अभी क्या चालू है?"*
*कहीं भी रेडियो माँगें और ग्लोब प्रसारण शुरू कर देता है — हर स्टेशन एक वास्तविक स्थान है जहाँ आप उड़ सकते हैं।*
---
## 🛰️ ग्लोब पर क्या है
तेरह लाइव लेयर्स। **उनमें से दस को कुछ भी नहीं चाहिए** — कोई कुंजी नहीं, कोई खाता नहीं, कोई साइनअप नहीं।
| लेयर | आपको क्या मिलता है | स्रोत | प्रमाणीकरण |
|-------|--------------|--------|------|
| 🗺️ **Map Stack** | Google Photorealistic 3D, Bing एरियल, OSM | Google / Ion / OSM | 🔴 Google (आवश्यक) · 🟡 Bing के लिए ion · 🟢 OSM |
| ✈️ **Live Flights** | हज़ारों लाइव विमान + मार्ग इतिहास | OpenSky + adsb.lol | 🟢 (अधिक पोलिंग क्रेडिट के लिए 🟡 वैकल्पिक) |
| 🎖️ **Military Flights** | एम्बर में ADS-B सैन्य ट्रैफ़िक | adsb.lol | 🟢 |
| 🚢 **Live Vessels** | दुनिया भर में हज़ारों जहाज | AISStream | 🟡 |
| 🛰️ **Satellites** | लगभग 840-वस्तु कोर कैटलॉग, एक लाइव लीजेंड के साथ वर्ग द्वारा रंग-कोडित — **DENSE** चिप पूरा Starlink शेल डाल देता है | CelesTrak | 🟢 |
| 🌍 **Earthquakes** | वैश्विक भूकंपीय गतिविधि, पिछले 24 घंटे | USGS | 🟢 |
| 🚗 **Traffic** | सड़क स्तर पर प्रति-वाहन प्रवाह चलाने वाली लाइव भीड़ — ~8 किमी से नीचे गोता लगाएं और बिंदु वास्तविक जाम में रंग बदलते हैं। बिना कुंजी यह एक अनुमानित सिमुलेशन है | TomTom + OSM | 🟢 (🟡 TomTom इसे वास्तविक बनाता है — एक लें) |
| 📹 **CCTV Mesh** | ~800 सार्वजनिक कैमरे 3D स्थान में *प्रोजेक्ट* — Austin · California (Caltrans) · London (TfL)। स्थितियाँ प्रकाशित हैं; पोज़ अनुमानित पूर्व हैं **जिन्हें आप कैमरे पर ही एक गिज़्मो खींचकर कैलिब्रेट करते हैं** | City APIs | 🟢 |
| 📻 **Radio** | एक **एनालॉग ट्यूनर** के साथ जियोलोकेटेड विश्व रेडियो — सुई को 750 स्टेशनों तक खींचें और ग्लोब प्रत्येक प्रसारक के पास उड़ता है | Radio Browser / broadcasters | 🟢 |
| 🚲 **Bikeshare** | लाइव स्टेशन उपलब्धता | GBFS | 🟢 |
| 🔥 **Active Fires** | लाइव NASA FIRMS डिटेक्शन, पिछले 24 घंटे | NASA FIRMS | 🟡 |
| 🚀 **Space Missions** | पेलोड, स्टेज, और रिकवरी विवरण के साथ रोलिंग 30-दिन लॉन्च | Launch Library 2 | 🟢 (🟡 वैकल्पिक टोकन भत्ता बढ़ाता है) |
| 🎖️ **Mapped Installations** | सामुदायिक मैपिंग से व्यूपोर्ट-बद्ध सैन्य-साइट संदर्भ — स्वभाव से अधूरा, और उसी तरह लेबल किया गया | OpenStreetMap | 🟢 |
**ग्लोब पर यह भी:** पड़ोस ओवरले · एक वैकल्पिक कॉकपिट WX क्लाउड प्रभाव। **बंडल स्थिर बुनियादी ढांचा:** डेटासेंटर (4,351), बांध (704), और समुद्री केबल (712)।
**कोई लेयर चाहिए जो गायब है?** एक issue खोलें — या इसे जोड़ें और PR भेजें।
---
## 🎖️ फील्ड मिशन
एक बार बुनियादी बातें समझ में आ जाएँ, तो ये चलाएँ:
| मिशन | कैसे |
|---|---|
| **🚁 ग्रह से पूछें** | *"ये सभी सैन्य हेलीकॉप्टर हलकों में क्यों उड़ रहे हैं?"* एक सैन्य ट्रैक चुनें — यह चुपचाप ~24 घंटे का वास्तविक ट्रेस इतिहास बैकफिल करता है — और देखें कि यह क्या कर रहा था, स्टैक्ड 3D लूप के रूप में हल किया गया। |
| **✈️ अंतिम दृष्टिकोण** | रनवे के लिए लाइन लगा रहे एक एयरलाइनर पर क्लिक-ट्रैक करें, **कॉकपिट** में कूदें, और उसके साथ नीचे उड़ें। |
| **🌃 रात्रि निगरानी** | अपने शहर में उड़ें, **NVG** पर स्विच करें, और डिटेक्शन मेश और HUD को दृश्य पढ़ने दें। |
| **🚢 बंदरगाह कॉल** | Port of Long Beach के ऊपर जहाज। एक टैंकर पर उसके सामरिक कार्ड और वेक ट्रेल के लिए क्लिक करें — फिर CCTV पैनल में **NEAREST** दबाएं और उसी पानी को एक सार्वजनिक कैमरे से देखें। |
| **📻 टोक्यो FM** | **Radio** लेयर चालू करके Shibuya की ऑर्बिट करें — फिर एनालॉग ट्यूनर सुई खींचें: हर स्थिति एक वास्तविक स्टेशन पर स्नैप होती है और ग्लोब जो भी प्रसारण कर रहा है उसके पास उड़ता है। |
| **🔥 आग की रेखा** | California पर FIRMS। एक डिटेक्शन पर क्लिक करें — कैमरा उस पर गोता लगाता है — तीव्रता पढ़ें, फिर ज़मीनी दृश्य के लिए CCTV पैनल में **NEAREST** दबाएं। |
| **🚶 चलने का रास्ता माँगें** *🎙️* | दुनिया को बताएं कि आप कहाँ जाना चाहते हैं और एक वास्तविक सड़क-अनुसरण मार्ग को 3D शहर में खुद को ट्रेस करते देखें — फिर *"इसे उड़ाएं"*: बैंक्ड मोड़, सहज अंत, एक कैमरा जो ड्रोन शॉट की तरह पथ का नेतृत्व करता है। |
| **📏 LAX से DFW मापें** *🎙️* | *"LAX से DFW कितनी दूर है?"* — एक तीर देश भर में फैलता है, दूरी कैप्शन में आती है, और एंडपॉइंट वास्तविक दुनिया से जुड़े रहते हैं जैसे ही आप ऑर्बिट करते हैं। |
| **🚀 लॉन्च रीप्ले** | **Space Missions** खोलें, पिछले 30 दिनों से एक लॉन्च चुनें, और T-माइनस काउंटडाउन से कक्षा तक चढ़ाई की सवारी करें — इसे 0.25×–4× पर स्क्रब करें। `RECONSTRUCTED ESTIMATE` लेबल किया गया, क्योंकि यह एक है। |
| **🪦 बोनयार्ड चलें** | क्षेत्रीय संदर्भ से नीचे सेवानिवृत्त विमानों की घनी, पूरी तरह से हल की गई पंक्तियों में उड़ें। |
| **🏗️ थ्री गोरजेस की ऑर्बिट करें** | बांध और उसके इलाके को एक नज़र में स्कैन करें — फिर **Dams** लेयर चालू करें और 703 और खोजें। |
| **🌊 रीढ़ की हड्डी का पता लगाएं** | **Submarine Cables** चालू करके Bahamas में गोता लगाएं — लेबल किए गए मार्ग पानी के नीचे प्रकट होते हैं, दुनिया भर में 712। |
*🎙️ = वॉइस मिशन — इन्हें OpenAI कुंजी चाहिए।*
*ग्रह से पूछें: एक सैन्य संपर्क के पिछले ~24 घंटों का वास्तविक ट्रेस इतिहास, स्टैक्ड 3D लूप के रूप में हल किया गया।*
*"चलने का रास्ता बनाओ… अब इसे उड़ाओ" — बैंक्ड मोड़, सहज अंत, कैमरा ड्रोन शॉट की तरह पथ का नेतृत्व करता है।*
*बोनयार्ड चलें: सेवानिवृत्त एयरफ्रेम की पंक्तियाँ, 3D में पूरी तरह से हल की गईं।*
*लॉन्च रीप्ले: एक Falcon 9 चढ़ाई, `RECONSTRUCTED ESTIMATE` लेबल किया गया, 0.25×–4× पर स्क्रब करने योग्य।*
*रीढ़ की हड्डी का पता लगाएं: Bahamas के नीचे समुद्री केबल मार्ग।*
---
## 🔧 हुड के नीचे
कुछ इंजीनियरिंग जो इसे एक टेक डेमो के बजाय वास्तविक महसूस कराती है:
- **विश्व-स्थिर आइकन।** विमान और जहाज हर कैमरा कोण पर अपने *वास्तविक वास्तविक-दुनिया शीर्षक* के साथ इंगित करते हैं — ट्रैक किया गया हो या नहीं, सीधे नीचे या क्षितिज के पार देखते हुए — प्रति-फ्रेम स्क्रीन-स्पेस कोर्स प्रोजेक्शन के माध्यम से। कोई स्पिनिंग नहीं, कोई व्यूपोर्ट-लॉकिंग नहीं।
- **छिटपुट डेटा से सहज गति।** लाइव फ़ीड हर 15–30 सेकंड में आते हैं; ग्लोब वास्तविक समय से एक अंतराल पीछे रेंडर करता है और ज्ञात फिक्स के बीच इंटरपोलेट करता है। डेड रेकनिंग अंतराल भरती है।
- **ईमानदार उपग्रह।** GMST पुनर्संरेखण के माध्यम से अपने उपग्रहों से लॉक रहने वाली ऑर्बिट रिंग के साथ SGP4 प्रसार — कोई बहाव नहीं, कोई प्रति-सेकंड झिलमिलाहट नहीं।
- **वास्तविक ज़मीन पर बैठता है।** एंटिटी ऊँचाइयाँ एक वास्तविक ऊर्ध्वाधर डेटम से गुजरती हैं — जियोइड-जागरूक, *रेंडर किए गए* इलाके मेश के खिलाफ नमूना — ताकि विमान एप्रन पर पार्क करें और कैमरे सड़क के कोनों पर खड़े हों, तैरने के बजाय।
- **अपना कोटा अपने जैसे खर्च करता है।** भुगतान किए गए फ़ीड कैश्ड, बजट-शासित प्रॉक्सी के पीछे चलते हैं — एक OpenSky क्रेडिट गवर्नर, एक TomTom दैनिक टाइल बजट, डिस्क-कैश्ड TLE — ताकि खोज की एक दोपहर API भत्ता न जलाए।
- **स्थानीय-प्रथम कुंजी हैंडलिंग।** OpenAI, AISStream, OpenSky OAuth, TomTom, और FIRMS जैसे गुप्त-वाहक प्रदाता सर्वर-साइड ब्रोकर किए जाते हैं। प्रॉक्सी गंतव्य निश्चित या अनुमतिसूचीबद्ध हैं, और उच्च-जोखिम वाले पथ उपयुक्त रूप से बाधित अनुरोध, टाइमआउट, प्रतिक्रिया कैप, और सैनिटाइज़्ड त्रुटियाँ जोड़```
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
देखें docs/CURRENT-STATE.md अधिकृत रनटाइम संदर्भ के लिए।
किंवदंती, एक बार फिर: 🟢 कोई साइनअप नहीं — बॉक्स से बाहर काम करता है · 🟡 मुफ्त कुंजी — पंजीकरण करें, पेस्ट करें, हो गया · 🔴 मीटर्ड — बिलिंग-सक्षम खाता; लागत छोटी लेकिन वास्तविक है।
दुनिया का अधिकांश हिस्सा 🟢 है: उड़ानें (अनाम), सैन्य यातायात, उपग्रह, भूकंप, सीसीटीवी, रेडियो, बाइकशेयर, अंतरिक्ष मिशन, मैप किए गए प्रतिष्ठान, और हर बंडल किया गया डेटासेट शून्य कुंजियों के साथ चलता है।
पाँच कुंजियाँ पूरी तरह से कुंजी-युक्त अनुभव को कवर करती हैं। तीन वर्तमान में निःशुल्क डेवलपर पहुँच प्रदान करती हैं; Google Maps और OpenAI उपयोग-मीटर्ड हैं। प्रदाता की कीमतें और भत्ते बदलते रहते हैं, इसलिए बजट अनुमान पर भरोसा करने से पहले लिंक किए गए मूल्य निर्धारण पृष्ठों का उपयोग करें:
| कुंजी | क्यों | इसे प्राप्त करें | |
|---|---|---|---|
| 🔴 | Google Maps (आवश्यक) | फोटोरियलिस्टिक 3D ग्रह (Map Tiles API) | Google Cloud Console — मीटर्ड; वर्तमान मूल्य निर्धारण देखें और इसे URL-प्रतिबंधित करें |
| 🔴 | OpenAI | 🎙️ वॉयस अनुभव + AI HUD सारांश। माइक के पीछे कोई अन्य प्रदाता चाहते हैं? PRs स्वागत योग्य हैं | platform.openai.com — मीटर्ड; वर्तमान API मूल्य निर्धारण देखें |
| 🟡 | AISStream | 🚢 लाइव वैश्विक जहाज | aisstream.io — मुफ्त, सच में, यह दो मिनट का साइनअप है |
| 🟡 | NASA FIRMS | 🔥 लाइव सक्रिय आग | firms.modaps.eosdis.nasa.gov — मुफ्त |
| 🟡 | TomTom | 🚦 अनुमानित सिमुलेशन के बजाय वास्तविक यातायात | developer.tomtom.com — अपने खाते के लिए वर्तमान डेवलपर भत्ता जाँचें |
TomTom कुंजी आपको क्या खरीदती है: द फर्स्ट फाइव मिनट्स का चरण 5 वास्तविक रूप में — अनुमानित सिमुलेशन के बजाय शहर पर चित्रित वास्तविक पीक-आवर घनत्व।
| कुंजी | क्यों | इसे प्राप्त करें | |
|---|---|---|---|
| 🟡 | Cesium ion | 🗺️ Bing इमेजरी मैप स्टैक (सार्वजनिक assets:read टोकन) | cesium.com/ion — अपने उपयोग के अनुरूप योजना देखें |
| 🟡 | OpenSky | ✈️ अधिक उड़ान-पोलिंग क्रेडिट (🟢 अनाम इसके बिना काम करता है) | opensky-network.org |
| 🟡 | Launch Library 2 | 🚀 उच्च अंतरिक्ष-मिशन अनुरोध भत्ता (🟢 इसके बिना काम करता है) | thespacedevs.com |
ये सभी प्राप्त करने लायक हैं। शुरू करने के लिए इनमें से कोई भी आवश्यक नहीं है।```bash
OPENAI_API_KEY="…" AISSTREAM_API_KEY="…" npm run dev -- --host localhost --port 4173
macOS पर आप किसी भी कुंजी को Keychain में भी रख सकते हैं और `./scripts/dev-fresh.sh` उन्हें खींच लेता है — `security add-generic-password` सेवा नाम `.env.example` में प्रलेखित हैं।
OpenSky पूरी तरह से अनाम चल सकता है (`OPENSKY_AUTH_MODE=anon`), या `./scripts/opensky-import-client.sh /path/to/credentials.json` के साथ OAuth क्रेडेंशियल आयात कर सकता है।
### 💸 वास्तव में इसकी लागत क्या है
ईमानदार आंकड़े, मोटे तौर पर, मध्य-2026 तक — हमेशा प्रदाता मूल्य निर्धारण पृष्ठों की जाँच करें:
| | लागत वास्तविकता |
|---|---|
| **🟢 अधिकांश परतें** | **$0, कोई साइनअप नहीं।** OpenSky anon, USGS, CelesTrak, adsb.lol, शहर CCTV, Radio Browser, GBFS, Launch Library 2, बंडल किए गए डेटासेट। |
| **🟡 वैकल्पिक डेवलपर पहुँच** | AISStream, FIRMS, TomTom, Cesium ion, और प्रमाणित OpenSky निःशुल्क पहुँच प्रदान कर सकते हैं, लेकिन सीमाएँ और अनुमत उपयोग भिन्न होते हैं। Cesium ion और OpenSky विशेष रूप से योजना या उपयोग प्रतिबंध रखते हैं; अपनी तैनाती के लिए वर्तमान प्रदाता शर्तों को सत्यापित करें। |
| **🔴 Google 3D tiles** | आपके अनुमान से अधिक उदार: बिलिंग **रूट tileset अनुरोधों** की गणना करती है — एक खरीद **तीन घंटे तक** के असीमित tile रेंडरिंग के लिए मिलती है — और पहले **1,000 प्रति माह निःशुल्क हैं**, फिर लगभग **$6 प्रति 1,000** (US मूल्य निर्धारण; [वर्तमान पृष्ठ देखें](https://developers.google.com/maps/billing-and-pricing/pricing), दरें बिलिंग क्षेत्र के अनुसार भिन्न होती हैं)। एक अकेला उपयोगकर्ता शायद ही निःशुल्क स्तर से बाहर जाता है। फिर भी: कुंजी प्रतिबंधित करें, कोटा निर्धारित करें, और निरंतर उपयोग से पहले बजट अलर्ट कॉन्फ़िगर करें। |
| **🔴 OpenAI voice** | Realtime ऑडियो उपयोग-मीटर किया जाता है और कुल चयनित मॉडल, वार्तालाप लंबाई, और ऑडियो मात्रा पर निर्भर करता है। ऐप एक लाइव सत्र अनुमान दिखाता है, $2 पर चेतावनी देता है, और **$5 का इन-ऐप सत्र कैप** लागू करता है; प्रदाता-पक्ष उपयोग सीमाएँ बिलिंग बैकस्टॉप बनी रहती हैं। |
### 🧗 मंज़िल जानबूझकर कम है
ऊपर सब कुछ जानबूझकर सस्ता आधार है — बिना किसी सेल्स टीम से बात किए जियोस्पेशियल इंटेलिजेंस, GEOINT, और OSINT का वास्तविक स्वाद पाने के लिए पर्याप्त। आप छत भी देखेंगे: स्थलीय AIS समुद्र के बीच में शांत हो जाता है और उपग्रह AIS की वास्तविक लागत होती है; प्रीमियम इमेजरी, SAR, और गहरे वाणिज्यिक फ़ीड एंटरप्राइज़ अनुबंधों के पीछे रहते हैं। यह आर्किटेक्चर की सीमा नहीं है — यहाँ हर परत एक पैटर्न है जिसे आप अपने स्वयं के डेटा स्रोतों की ओर इंगित कर सकते हैं। यह रिपॉजिटरी आपको नींव देती है; आप इसमें जो मिलाते हैं वह आप पर निर्भर है।
### 🔒 एक इंस्टेंस साझा करना
डिफ़ॉल्ट रूप से कोई और आपके सर्वर तक नहीं पहुँच सकता — यह localhost से बंधा होता है। अपने LAN पर साझा करने के लिए, स्पष्ट रूप से ऑप्ट-इन करें (`npm run dev -- --host 0.0.0.0 --port 4173`, या macOS/Linux पर `HOST=0.0.0.0 ./scripts/dev-fresh.sh`) — लेकिन जान लें कि ⚠️ **एक LAN-दृश्यमान सर्वर आपके कॉन्फ़िगर किए गए API कुंजियों को किसी भी व्यक्ति के लिए ब्रोकर करता है जो उस तक पहुँच सकता है।** प्रति-IP थ्रॉटल सेट करें (`GEV_RATELIMIT_OPENAI_PER_MIN`, `GEV_RATELIMIT_GOOGLE_PER_MIN` — `.env.example` देखें) और, किसी भी चीज़ से पहले, **प्रदाता-पक्ष बजट कैप सेट करें** (Google Cloud बजट, OpenAI उपयोग सीमाएँ): थ्रॉटल ऐप-स्तरीय गार्ड हैं, बिलिंग कैप नहीं। पूर्ण खतरा मॉडल [SECURITY.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/SECURITY.md) में।
---
## 📋 ज़िम्मेदार और खुला
God's Eye View **सार्वजनिक डेटा, स्पष्ट स्रोतों, और स्थानीय-प्रथम निष्पादन** पर चलता है। कोई रहस्य नहीं, कोई निजी डेटासेट नहीं, कोई रहस्यमय स्क्रैपिंग नहीं — निजी कुंजी से जुड़ी कोई भी चीज़ सर्वर-साइड ब्रोकर की जाती है। इसमें वर्गीकृत ऑप्स रूम की दृश्य व्याकरण है, जो पूरी तरह से खुले संकेतों और निरीक्षण योग्य कोड से निर्मित है।
**रेखा।** यह परियोजना **घटनाओं, संपत्तियों, बुनियादी ढाँचे, और प्रणालियों** का मॉडल बनाती है — विमान, जहाज़, उपग्रह, आग, कैमरे, शहर। यह नामित-व्यक्ति खोज, चेहरे की पहचान, या व्यक्तियों को ट्रैक करने के लिए सुविधाएँ नहीं बनाता है, और जो पुल अनुरोध उस रेखा को पार करते हैं वे विलय नहीं होंगे। लोग यहाँ एक क्वेरी प्रकार नहीं हैं।
**इसे बनाने आएँ।** यह उस परियोजना से विहित लाइव 3D क्लाइंट है जिसने स्थानिक-बुद्धिमत्ता उपकरणों की हालिया लहर की शुरुआत की — और यह एक कैनवास है: यहाँ की परतें वे संकेत हैं जिन्हें एक व्यक्ति खोज और मिला सकता है। एक सिटी पैक, एक डेटा स्रोत, एक शैली, एक आवाज़ उपकरण जोड़ें। यह वह खिड़की है जिसके माध्यम से आप दुनिया देखते हैं; उस खिड़की को दूसरों तक लाएँ।
**स्थिति:** अन्वेषण और सीखने के लिए एक विकसित होता ओपन-सोर्स क्लाइंट — एक तेज़, हैक करने योग्य नींव, कठोर उत्पादन सेवा नहीं। **[MIT License](https://github.com/bilawalsidhu/gods-eye-view/blob/main/LICENSE)** के तहत जारी। बंडल और लाइव डेटासेट अपनी स्वयं की शर्तें रखते हैं — **[DATA_SOURCES.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/DATA_SOURCES.md)** देखें। सुरक्षा मॉडल: **[SECURITY.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/SECURITY.md)**। योगदान करना चाहते हैं? **[CONTRIBUTING.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/CONTRIBUTING.md)**।
<sub>मीडिया नोट: Bilawal Sidhu ने इस पृष्ठ पर 17 कैप्चर GIF बनाए और उनके स्वामी हैं। उन्होंने मौजूदा सार्वजनिक परियोजना में दो README PNG भी प्रकाशित किए और यहाँ उनके निरंतर समावेश को अधिकृत किया। Bilawal की कोई भी उपस्थिति उनकी अनुमति से शामिल है। ये फ़ाइलें परियोजना प्रलेखन हैं, MIT-लाइसेंस प्राप्त स्वतंत्र संपत्तियाँ नहीं। उनके भीतर दिखाई देने वाले प्लेटफ़ॉर्म इंटरफ़ेस, ट्रेडमार्क, अवतार, डेटा, और तृतीय-पक्ष इमेजरी अपने संबंधित स्वामियों की शर्तों के अधीन रहते हैं। [मीडिया उत्पत्ति](https://github.com/bilawalsidhu/gods-eye-view/blob/main/docs/media/README.md) और [स्रोत शर्तें](https://github.com/bilawalsidhu/gods-eye-view/blob/main/DATA_SOURCES.md) देखें।</sub>
> [!IMPORTANT]
> God's Eye View सार्वजनिक और तृतीय-पक्ष डेटा का एक अन्वेषणात्मक विज़ुअलाइज़ेशन है।
> डेटा विलंबित, अपूर्ण, मॉडलित, अनुमानित, या गलत हो सकता है। इसका उपयोग
> उड़ान या समुद्री नेविगेशन, आपातकालीन प्रतिक्रिया, चिकित्सा या स्वास्थ्य
> निर्णय, निवेश निर्णय, या अन्य सुरक्षा-महत्वपूर्ण या परिचालन
> उद्देश्यों के लिए न करें। आधिकारिक स्रोतों के साथ महत्वपूर्ण जानकारी सत्यापित करें।
---
## 🧭 आगे क्या
पहले — धन्यवाद। उन सभी को जिन्होंने God-view डेमो देखे और अपना खुद का बनाने चले गए, और उन सभी को जो कोड के लिए पूछते रहे: मैं आभारी हूँ। और जब मैंने पूछा कि क्या इसे ओपन सोर्स जाना चाहिए, आप उसके बारे में सूक्ष्म नहीं थे:
<img src="https://assets.kitploit.com/production/public/readmes/53672/d1eee944eaf04d9063d0251d21e1c8eb3b30471dc576044bab58917e35995924/aab0b9bd11b208c5db0f4e7b6c717c6c688fe22ca0c7996169f17b4a5c526b24-display-v1.webp" alt="God's Eye View को ओपन-सोर्स करने पर सामुदायिक सर्वेक्षण" width="460">
तो यह रहा। जासूसी-थ्रिलर कॉकपिट में कदम रखें — सिवाय इसके कि डेटा वास्तविक है — और आइए इसे दुनिया को समझने के लिए हमारा साझा सैंडबॉक्स बनाएँ, और मज़े करें। यह रिपॉजिटरी आधार है, यह खुला रहता है, और पूरा बिंदु यह है कि आप चीज़ों को तोड़ें और ऐसी परतें जोड़ें जिनके बारे में हमने अभी तक नहीं सोचा है।
अंदर से एक हेड्स-अप: इस स्थान में एक सप्ताह के लिए निर्माण करें और आप सीखते हैं कि **वर्तमान सस्ता हिस्सा है**। जिस क्षण आप समय में पीछे जाने की कोशिश करते हैं — *क्या हुआ* और *क्या बदला* को किसी वास्तविक रिज़ॉल्यूशन पर tiling, serving, और scrubbing करना — डेटा महंगा हो जाता है और कंप्यूट बर्बर हो जाता है। उसके लिए, हम कुछ बढ़िया बना रहे हैं। भविष्य में और अधिक — [halfpixel.ai](https://halfpixel.ai)।
---
<div align="center">
▶️ [God's Eye View श्रृंखला देखें](https://youtube.com/playlist?list=PL6qSg2I-7_koPbDnSMo0QeeHX_RknA2uv&si=nBGYMoHWQw41v93Q) · 📬 [Map the World](https://maptheworld.ai/) — परियोजना के पीछे का न्यूज़लेटर
**🌐 God's Eye View. कोई स्थान पीछे नहीं छूटा।**
</div>