bilawalsidhu/gods-eye-viewمحاكي قمر تجسس صناعي في متصفحك، لكن البيانات حقيقية. استخبارات مكانية حية مفتوحة المصدر على كرة أرضية ثلاثية الأبعاد فائقة الواقعية.
كرة أرضية ثلاثية الأبعاد فائقة الواقعية. طائرات حية، سفن، أقمار صناعية، زلازل، حركة مرور، وكاميرات عامة، مع مناظر مُصمَّمة ومُوسومة بوضوح حيث لا تتوفر بث مباشر. تحكم صوتي بدون استخدام اليدين مدعوم بوكلاء ذكاء اصطناعي في الوقت الفعلي.
لا مكان يُترك خلفنا.
▶️ من المشروع الذي يقف خلف سلسلة عين الرب الفيروسية (المعروفة سابقًا باسم WorldView) — أكثر من 5 ملايين مشاهدة على يوتيوب
بدء سريع · أول خمس دقائق · تحدث إليه · ما هو حي · تحت الغطاء · المفاتيح · التكاليف
لقد طلبت، لذا يحدث ذلك. عين الرب مفتوح المصدر. تتبّع العالم مباشرة. تحدث إليه. اكسره. وسّعه.
معظم الاستخبارات مفتوحة المصدر هي كومة من علامات تبويب المتصفح. الإشارات وفيرة، لكن الواجهة هي عنق الزجاجة. تحوّل عين الرب تلك الإشارات إلى مكان: العالم يبث بالفعل — أجهزة إرسال الطائرات، منارات السفن، عناصر المدارات، أجهزة قياس الزلازل، الكاميرات العامة — وهذا يجعلها مرئية على كرة أرضية ثلاثية الأبعاد فائقة الواقعية في الوقت الفعلي. لا حاجة لتصريح سري؛ إنها إشارة عامة حتى النهاية، والواجهة تعمل في متصفحك، تحت سيطرتك.
نصف السحر هو أنها تبدو كقمرة قيادة محظورة. النصف الآخر هو أن كل سطر من الكود قابل للفحص.
الطبقات الحية مبنية على خلاصات عامة: الطائرة التي تعبر شاشتك تُبلّغ عن بيانات القياس عن بُعد، الكاميرا مثبتة في موقع منشور، وموقع محطة الفضاء الدولية يُستنتج من عناصر مدارية حالية. يعرض العميل عمدًا الرحلات الجوية بفاصل زمني واحد من دورة الاستطلاع خلف الوقت الفعلي حتى يتمكن من الاستيفاء بسلاسة. بعض التجارب مُصمَّمة وليست حية: حركة المرور بدون مفاتيح مُوسومة كمحاكاة، أوضاع الكاميرا مُقدَّرة حتى تتم معايرتها، وتشغيل صعود الإطلاق مُوسوم بـ RECONSTRUCTED ESTIMATE. تحافظ كل طبقة على مصدرها وحالة حداثتها مرئية، بما في ذلك الحالات الجزئية والمتأخرة والمحاكاة وغير المتاحة.
يتطلب Node.js 24.14.x أو 26.x (مُطبَّق بواسطة package.json).
.env.example ← .env وعيّن GOOGLE_MAPS_API_KEY.3. افتح **`http://localhost:4173`**. يستقر بدء التشغيل البارد في أقل من ثانيتين على حاسوب محمول حديث (وسيط 1.86 ثانية في لقطة M5/Chrome في نقطة زمنية — [docs/PERFORMANCE.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/docs/PERFORMANCE.md)؛ خط أساس للمقارنة، وليس متطلبًا للأجهزة). تقدم بطاقة التشغيل الأول خيارًا لتجهيز مهمة لك — **جهات اتصال حية**، **مهام فضائية**، **بيئية** — أو تتركك لاستكشاف الواجهة يدويًا.
> [!TIP]
> **لست مبرمجًا؟ دع الذكاء الاصطناعي ينفذ هذه الصفحة كلها لك.** مثبّت بنقرة واحدة قيد التطوير — حتى ذلك الحين، ثبّت وكيل برمجة ([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 جلسة مجانية لبلاطات ثلاثية الأبعاد شهريًا** — كل منها صالحة حتى ثلاث ساعات من العرض، وهو ما يصعب جدًا على شخص واحد استنفاده — والصوت يحمل حدًا مدمجًا للجلسة بقيمة $5. الخريطة الكاملة في [المفاتيح والتكاليف](#-api-keys)، والتحليل الصريح الكامل في [ما التكلفة الفعلية](#-what-it-actually-costs).
يرتبط خادم التطوير بـ **localhost** — تبقى مفاتيحك على جهازك. المشاركة على شبكة LAN بأمان مغطاة في [مشاركة نسخة](#-sharing-an-instance) و[SECURITY.md](https://github.com/bilawalsidhu/gods-eye-view/blob/main/SECURITY.md).
**اختصار macOS:** `./scripts/dev-fresh.sh` يمسح ذاكرة Vite المؤقتة ويسحب مفاتيحك مباشرة من Keychain.
---
## 🕐 الدقائق الخمس الأولى
لا حساب، لا تسجيل. ستعرض بطاقة التشغيل الأول تجهيز مهمة لك — أو نفّذ هذا التحدي بنفسك. في مكان ما خلال هذه الدقائق الخمس، يتوقف الأمر عن كونه عرضًا تجريبيًا:
1. **أضئ السماء.** خذ مهمة **جهات الاتصال الحية** (أو فعّل **الرحلات الجوية** بنفسك) — آلاف الطائرات الحية، تنزلق على بيانات تتبع حقيقية، وشبكة الكشف تقرأ المشهد بالفعل. انقر على واحدة: تقفل الكاميرا عليها، ويُرسم مسار خلفها، وتظهر بطاقة بياناتها الحية.
2. **تولَّ القيادة.** اضغط **قمرة القيادة** على طائرتك المتعقَّبة واركبها للأسفل، مبدّلًا أجهزة الاستشعار أثناء الطيران: من الرؤية الليلية إلى FLIR الحراري. تحمل القمرة شريط إحاطة خاصًا بها — إشارات حية قريبة، عناوين إقليمية، وطقس محلي حقيقي، مع وضع **WX** اختياري يعرض سحبًا حجمية من ملاحظات فعلية حول طائرتك — و**جهات الاتصال** تُبقي قائمة الـ 250 كم على بُعد نقرة واحدة (أو جملة واحدة): انتقل من طائرة إلى أخرى واسقط مباشرة في القمرة التالية.
3. **اهبط في مطار مزدحم.** ابحث عن واحد وانزل إلى مسارات التاكسي مع تفعيل الطائرات **ثلاثية الأبعاد** — جهات اتصال على الأرض، مسارات تاكسي، وساحة المطار كاملة تعمل في الوقت الفعلي.
4. **انظر عبر كاميرا عامة.** فعّل **كاميرات المراقبة** فوق أوستن أو لندن أو كاليفورنيا. البث ليس تضمينات كاميرات ويب — بل يُسقط *داخل* المدينة ثلاثية الأبعاد. بدّل التغطية إلى **مجال الرؤية** وسترسم كل كاميرا حجم تغطيتها التقديري — أين تصل، وأين تعمى.
5. **لوّن الشوارع بزحمة الساعة الذروة.** فعّل **حركة المرور** وانزل تحت ~8 كم — يتلوّن تدفق كل مركبة وفق الازدحام الحقيقي (مع مفتاح TomTom؛ وبدون مفتاح فهو محاكاة مُعلَّمة). ثم اضغط **الأقرب** في لوحة كاميرات المراقبة وشاهد الازدحام عبر الكاميرا الموجهة إليه.
6. **تتبع شيئًا في المدار.** فعّل **الأقمار الصناعية** وانقر على محطة الفضاء الدولية — تركب معها على مسافة مدارية، مع حلقة المدار وكل شيء.
7. **بدّل البصريات.** اضغط `1`–`7` — CRT، رؤية ليلية، FLIR — ويعاد عرض الكوكب الحي كله عبر مستشعر مختلف.
8. **تحدث إليه** *(يتطلب مفتاح OpenAI)*: *"خذني إلى LAX واختر أقرب طائرة في الجو."*
9. **عد إلى البداية.** اضغط **إعادة تعيين الكرة الأرضية** — أو قل فقط *"قرّب للخارج إلى عرض الكرة الأرضية."*
**لوحة المفاتيح:** `1`–`7` أنماط بصرية · `H` شاشة العرض · `D` الكشف · `C` قمرة القيادة · `Esc` للخروج.
---
## 🎙️ تحدث إليه
> الصوت يتطلب **مفتاح OpenAI**. بدونه يعمل التطبيق كله — زر الميكروفون يخبرك فقط أن الصوت غير متاح. نفس المفتاح يشغّل **ملخص شاشة العرض بالذكاء الاصطناعي**: قراءة استخباراتية موجزة من خمس كلمات للعرض الحالي تتجدد كلما تحركت.
انقر **GEV MIC**، وامنح الإذن للميكروفون، وتحدث فقط. هذا أكثر من مجرد جهاز تحكم عن بُعد بالصوت:
- **🧠 يعرف ما ينظر إليه.** يسحب الوكيل سياق المشهد الحي قبل الإجابة — بما في ذلك الإحداثيات وأسماء الشوارع والطبقات النشطة ومقياس العرض. اسأل *"ما هذه المدينة؟"* أثناء الطيران وسيعرف.
- **🎯 أسئلة وأجوبة عن الكيانات.** انقر على أي طائرة أو سفينة أو مركز بيانات واسأل *"ما هذا؟"* يجيب باستخدام البيانات الحية للكائن.
- **👁️ تثبيت بصري.** على مستوى الشارع، يقرأ لقطة شاشة لمعيّن العرض لتحديد اللافتات المقروءة وأسماء المباني، وهو مُوجَّه ألا يختلق التسميات أبدًا.
- **🎬 تأطير سينمائي.** *"أرني الطائرات في السماء فوقنا"* يسحب الكاميرا للخلف، ويُمالها، ويؤطر حركة المرور الحية كمخرج.
- **🔒 صادق وآمن.** يؤكد الوكيل فقط الإجراءات التي نجحت. مفتاح `OPENAI_API_KEY` الخاص بك لا يلمس المتصفح أبدًا؛ يحصل العميل فقط على رمز جلسة قصير الأمد.
ثمانية وعشرون أداة، أربع وظائف — الأوامر أدناه تأتي مباشرة من مجموعة اختبار الصوت للمنتج ودليل الأدوات:
**🎥 وجّهه** — أفعال كاميرا مشغّل الطائرات بدون طيار:
> 🗣️ *"خذني إلى طوكيو."* · *"دُر حول هذه المنطقة ببطء."* · *"ارسم مسار المشي من الكابيتول إلى حديقة زيلكر."* → *"حلّق على المسار الذي رسمناه للتو."* · *"قرّب للخارج إلى عرض الكرة الأرضية."*
**🖊️ علّق عليه** — سبورة بيضاء فوق العالم الحقيقي:
> 🗣️ *"حدّد حدود ولاية تكساس."* · *"علّق على مبنى الكابيتول في تكساس وأراضيه"* — يرسم **الحدود الفعلية المحيطة**، وليس دائرة. · *"كم تبعد برج إيفل عن اللوفر؟"* — يظهر سهم موصل وينطق المسافة. كل شيء يبقى حتى تقول *"امسح الخريطة."*
**🔎 استجوبه** — استعلامات محلل ضد الطبقات الحية:
> 🗣️ *"كم عدد الرحلات فوق تكساس الآن؟"* · *"أي السفن متجهة إلى أوكلاند؟"* · *"ما أكبر حريق قرب لوس أنجلوس؟"* · *"هل هناك أي شيء يطير فوق أربعين ألف قدم؟"* · *"متى يمر محطة الفضاء الدولية فوقنا بعد ذلك؟"*
**🎛️ شغّله** — لوحة التحكم كاملة، دون استخدام اليدين:
> 🗣️ *"بدّل إلى الرؤية الليلية وفعّل طبقة الرحلات الجوية."* · *"فعّل مجالات رؤية الكاميرات."* · *"شغّل محطة راديو إخبارية قرب أوستن."* · *"تتبع تلك الطائرة."* → *"ادخل إلى قمرة القيادة."*
**ومستوى الإطلاق السريع** — جملة واحدة لكل أمر:
> 🗣️ *"أرني البنية التحتية العالمية."* (يجهّز الطبقات ويسحب للخارج إلى الكرة الأرضية) · *"شغّل مراقبة المدارية."* (مشهد سينمائي كامل) · *"اضبط كثافة الكشف على خمسين بالمئة."* · *"الاتصال التالي — مروحيات فقط."* (وسط قمرة القيادة) · *"أرني المهام الفضائية."* · *"بدّل إلى التصوير الجوي من Bing."* · *"احسّن الصورة قليلًا."* · *"بدّل إلى التخطيط التكتيكي."* · *"ما المفعل الآن؟"*
*اطلب راديوًا قرب أي مكان وتبدأ الكرة الأرضية بالبث — كل محطة مكان حقيقي يمكنك الطيران إليه.*
---
## 🛰️ ما على الكرة الأرضية
ثلاث عشرة طبقة حية. **عشر منها لا تحتاج شيئًا إطلاقًا** — لا مفتاح، لا حساب، لا تسجيل.
| الطبقة | ما تحصل عليه | المصدر | المصادقة |
|-------|--------------|--------|------|
| 🗺️ **حزمة الخرائط** | Google Photorealistic 3D، تصوير Bing الجوي، OSM | Google / Ion / OSM | 🔴 Google (مطلوب) · 🟡 ion لـ Bing · 🟢 OSM |
| ✈️ **الرحلات الجوية الحية** | آلاف الطائرات الحية + سجل المسارات | OpenSky + adsb.lol | 🟢 (🟡 اختياري لمزيد من أرصدة الاستعلام) |
| 🎖️ **الرحلات العسكرية** | حركة ADS-B العسكرية باللون الكهرماني | adsb.lol | 🟢 |
| 🚢 **السفن الحية** | آلاف السفن حول العالم | AISStream | 🟡 |
| 🛰️ **الأقمار الصناعية** | كتالوج أساسي يضم حوالي 840 جسمًا، مُرمّزًا بالألوان حسب الفئة مع وسيلة إيضاح حية — شريحة **DENSE** تُسقط قشرة Starlink كاملة | CelesTrak | 🟢 |
| 🌍 **الزلازل** | النشاط الزلزالي العالمي، آخر 24 ساعة | USGS | 🟢 |
| 🚗 **حركة المرور** | ازدحام حي يقود تدفق كل مركبة على مستوى الشارع — انزل تحت ~8 كم وتتلوّن النقاط وفق الازدحام الحقيقي. بدون مفتاح فهو محاكاة تقريبية | TomTom + OSM | 🟢 (🟡 TomTom يجعله حقيقيًا — احصل عليه) |
| 📹 **شبكة كاميرات المراقبة** | ~800 كاميرا عامة مسقطة *داخل* الفضاء ثلاثي الأبعاد — أوستن · كاليفورنيا (Caltrans) · لندن (TfL). المواقع منشورة؛ الأوضاع تقديرات مسبقة **تقوم بمعايرتها بسحب أداة على الكاميرا نفسها** | واجهات برمجة المدن | 🟢 |
| 📻 **الراديو** | راديو عالمي محدد الموقع مع **موالف تناظري** — اسحب الإبرة عبر ما يصل إلى 750 محطة وتطير الكرة الأرضية إلى كل مُذيع | Radio Browser / المذيعون | 🟢 |
| 🚲 **مشاركة الدراجات** | توفر المحطات الحي | GBFS | 🟢 |
| 🔥 **الحرائق النشطة** | كشوف NASA FIRMS الحية، لآخر 24 ساعة | NASA FIRMS | 🟡 |
| 🚀 **المهام الفضائية** | إطلاقات متدحرجة لآخر 30 يومًا مع تفاصيل الحمولة والمرحلة والاسترداد | Launch Library 2 | 🟢 (🟡 رمز اختياري يرفع الحصة) |
| 🎖️ **المنشآت المُرسَّمة** | سياق المواقع العسكرية المحدود بمعيّن العرض من التخطيط المجتمعي — ناقص بطبيعته، ومُعلَّم على هذا النحو | OpenStreetMap | 🟢 |
**أيضًا على الكرة الأرضية:** تراكبات الأحياء · تأثير سحب WX اختياري في قمرة القيادة. **بنية تحتية ثابتة مرفقة:** مراكز البيانات (4,351)، السدود (704)، والكابلات البحرية (712).
**تنقصك طبقة تريدها؟** افتح مشكلة — أو أضفها وأرسل طلب السحب.
---
## 🎖️ المهام الميدانية
بمجرد أن تتقن الأساسيات، نفّذ هذه:
| المهمة | الطريقة |
|---|---|
| **🚁 اسأل الكوكب** | *"لماذا تحلق كل هذه المروحيات العسكرية في دوائر؟"* حدد مسارًا عسكريًا — يملأ تلقائيًا ~24 ساعة من سجل التتبع الحقيقي — وشاهد ما كان يفعله، محلولًا كحلقات ثلاثية الأبعاد متراصة. |
| **✈️ الاقتراب النهائي** | انقر وتتبع طائرة ركاب تصطف لمدرج، واقفز إلى **قمرة القيادة**، واركبها للأسفل. |
| **🌃 المراقبة الليلية** | حلّق إلى مدينتك، بدّل إلى **الرؤية الليلية**، ودع شبكة الكشف وشاشة العرض يقرآن المشهد. |
| **🚢 زيارة الميناء** | سفن قادمة فوق ميناء لونغ بيتش. انقر على ناقلة لبطاقتها التكتيكية ومسارها الخلفي — ثم اضغط **الأقرب** في لوحة كاميرات المراقبة وانظر إلى نفس الماء عبر كاميرا عامة. |
| **📻 طوكيو FM** | دُر حول شيبويا مع تفعيل طبقة **الراديو** — ثم اسحب إبرة الموالف التناظري: كل موضع يلتقط محطة حقيقية وتطير الكرة الأرضية إلى من يبث. |
| **🔥 خط النار** | FIRMS فوق كاليفورنيا. انقر على كشف — تغوص الكاميرا إليه — اقرأ الشدة، ثم اضغط **الأقرب** في لوحة كاميرات المراقبة لعرض أرضي. |
| **🚶 اطلب مسار مشي** *🎙️* | أخبر العالم أين تريد الذهاب وشاهد مسارًا حقيقيًا يتبع الشوارع يرسم نفسه عبر المدينة ثلاثية الأبعاد — ثم *"حلّق عليه"*: انعطافات مائلة، نهايات مهدأة، وكاميرا تقود المسار كلقطة طائرة بدون طيار. |
| **📏 قِس LAX إلى DFW** *🎙️* | *"كم تبعد LAX عن DFW؟"* — سهم يمتد عبر البلاد، والمسافة تظهر في التسمية التوضيحية، وتبقى نقطتا النهاية مثبتتين على العالم الحقيقي أثناء دورانك. |
| **🚀 إعادة عرض الإطلاق** | افتح **المهام الفضائية**، اختر إطلاقًا من آخر 30 يومًا، واركب العد التنازلي لـ T-minus عبر الصعود إلى المدار — مرّره بسرعة 0.25×–4×. مُعلَّم `RECONSTRUCTED ESTIMATE`، لأنه كذلك فعلًا. |
| **🪦 تجوّل في مقبرة الطائرات** | حلّق من السياق الإقليمي نزولًا إلى صفوف كثيفة ومحلولة بالكامل من الطائرات المتقاعدة. |
| **🏗️ دُر حول سد الخوانق الثلاثة** | امسح السد وتضاريسه بنظرة واحدة — ثم فعّل طبقة **السدود** واعثر على 703 أخرى. |
| **🌊 تتبع العمود الفقري** | اغص إلى جزر البهاما مع تفعيل **الكابلات البحرية** — مسارات مُعلَّمة تظهر تحت الماء، 712 منها حول العالم. |
*🎙️ = مهام صوتية — تتطلب مفتاح OpenAI.*
*اسأل الكوكب: آخر ~24 ساعة من سجل التتبع الحقيقي لجهة اتصال عسكرية، محلولة كحلقات ثلاثية الأبعاد متراصة.*
*"ارسم مسار المشي… الآن حلّق عليه" — انعطافات مائلة، نهايات مهدأة، والكاميرا تقود المسار كلقطة طائرة بدون طيار.*
*تجوّل في مقبرة الطائرات: صفوف من الهياكل المتقاعدة، محلولة بالكامل في ثلاثي الأبعاد.*
*إعادة عرض الإطلاق: صعود Falcon 9، مُعلَّم `RECONSTRUCTED ESTIMATE`، قابل للتمرير بسرعة 0.25×–4×.*
*تتبع العمود الفقري: مسارات الكابلات البحرية تحت جزر البهاما.*
---
## 🔧 تحت الغطاء
بعض الهندسة التي تجعله يبدو حقيقيًا بدلًا من عرض تقني:
- **أيقونات ثابتة عالميًا.** تشير الطائرات والسفن على طول *اتجاهها الحقيقي في العالم الواقعي* في كل زاوية كاميرا — متعقَّبة أم لا، بالنظر للأسفل مباشرة أو عبر الأفق — عبر إسقاط مسار لكل إطار في مساحة الشاشة. لا دوران، لا قفل على معيّن العرض.
- **حركة سلسة من بيانات متقطعة.** تصل البث الحية كل 15–30 ثانية؛ تعرض الكرة الأرضية فاصلًا واحدًا خلف الوقت الحقيقي وتستكمل بين المواقع المعروفة. الحساب الميت يملأ الفجوات.
- **أقمار صادقة.** انتشار SGP4 مع حلقات مدارية تبقى مقفلة على أقمارها عبر إعادة محاذاة GMST — لا انجراف، لا وميض كل ثانية.
- **يقف على أرض حقيقية.** تمر ارتفاعات الكيانات عبر مرجع رأسي حقيقي — مدرك للجيويد، مأخوذ بالعينة مقابل *شبكة التضاريس المعروضة* — فتركن الطائرات على أسطح المطارات وتقف الكاميرات على زوايا الشوارع بدلًا من الطفو.
- **ينفق حصتك وكأنها ملكه.** تعمل البث المدفوعة خلف وكلاء مخزنين ومحكومين بميزانية — منظم أرصدة OpenSky، ميزانية بلاطات يومية لـ TomTom، وTLEs مخزنة على القرص — فلا يحرق أذنًا بعد الظهيرة من الاستكشاف حصة واجهة برمجة.
- **معالجة مفاتيح محلية أولًا.** المزودون الحاملون للأسرار مثل OpenAI وAISStream وOpenSky OAuth وTomTom وFIRMS يُوسَّطون من جانب الخادم. وجهات الوكلاء ثابتة أو في قائمة مسموحة، والمسارات الأعلى خطرًا تضيف طلبات محدودة ومهلات زمنية وسقوف استجابة وأخطاء معقّمة حسب الاقتضاء. بيانات اعتماد المزود الوحيدة المكشوفة للمتصفح عمدًا هي Google Maps وCesium ion؛ قيّد كليهما عند المزود.
- **لا إطار عمل.** JavaScript خام، **CesiumJS**، و**Vite** — بالإضافة إلى **Google Photorealistic 3D Tiles** للكوكب و**OpenAI Realtime API** للصوت. سريع القراءة، سريع الاختراق.```
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 (مطلوب) | الكوكب ثلاثي الأبعاد الواقعي فوتوغرافيًا (Map Tiles API) | Google Cloud Console — مدفوع حسب الاستخدام؛ تحقق من التسعير الحالي وقيّده بعنوان URL |
| 🔴 | OpenAI | 🎙️ تجربة الصوت + ملخص 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`)، أو استيراد بيانات اعتماد OAuth عبر `./scripts/opensky-import-client.sh /path/to/credentials.json`.
### 💸 ما التكلفة الفعلية
أرقام صادقة، تقريبًا، حتى منتصف 2026 — تحقق دائمًا من صفحات تسعير المزود:
| | واقع التكلفة |
|---|---|
| **🟢 معظم الطبقات** | **0$، بدون تسجيل.** OpenSky المجهول، USGS، CelesTrak، adsb.lol، كاميرات المدينة، Radio Browser، GBFS، Launch Library 2، ومجموعات البيانات المرفقة. |
| **🟡 وصول المطور الاختياري** | قد تقدم AISStream وFIRMS وTomTom وCesium ion وOpenSky الموثق وصولًا مجانيًا، لكن الحدود والاستخدامات المسموحة تختلف. لدى Cesium ion وOpenSky تحديدًا قيود على الخطط أو الاستخدام؛ تحقق من شروط المزود الحالية لنشرك. |
| **🔴 بلاطات Google ثلاثية الأبعاد** | أكثر سخاءً مما تتوقع: الفوترة تحسب **طلبات مجموعة البلاطات الجذرية** — طلب واحد يشتري حتى **ثلاث ساعات** من عرض البلاطات غير المحدود — وأول **1,000 شهريًا مجانية**، ثم حوالي **6$ لكل 1,000** (تسعير أمريكي؛ [تحقق من الصفحة الحالية](https://developers.google.com/maps/billing-and-pricing/pricing)، تختلف الأسعار حسب منطقة الفوترة). المستخدم الفرد نادرًا ما يغادر الطبقة المجانية. ومع ذلك: قيّد المفتاح، واضبط الحصص، وكون تنبيه ميزانية قبل الاستخدام المطول. |
| **🔴 صوت OpenAI** | الصوت في الوقت الفعلي يُحتسب حسب الاستخدام ويعتمد الإجمالي على النموذج المختار وطول المحادثة وحجم الصوت. يعرض التطبيق تقديرًا مباشرًا للجلسة، ويحذر عند 2$، ويطبق **حد جلسة داخل التطبيق بقيمة 5$**؛ تبقى حدود الاستخدام من جانب المزود هي الضمانة النهائية للفوترة. |
### 🧗 الأرضية منخفضة عن قصد
كل ما سبق هو خط الأساس الرخيص المتعمد — كافٍ لتذوق حقيقي للاستخبارات الجغرافية المكانية وGEOINT وOSINT دون التحدث إلى فريق مبيعات. ستلاحظ أيضًا السقف: AIS الأرضي يصمت في منتصف المحيط وAIS عبر الأقمار الصناعية يكلف أموالًا حقيقية؛ الصور المتميزة وSAR والخلاصات التجارية الأعمق خلف عقود مؤسسية. هذا ليس حدًا للبنية — كل طبقة هنا نمط يمكنك توجيهه إلى مصادر بياناتك الخاصة. يمنحك هذا المستودع الأساس؛ وما تدمجه فيه متروك لك.
### 🔒 مشاركة نسخة
افتراضيًا لا يمكن لأي شخص آخر الوصول إلى خادمك — فهو مرتبط بـ localhost. للمشاركة على شبكتك المحلية، فعّل ذلك صراحةً (`npm run dev -- --host 0.0.0.0 --port 4173`، أو `HOST=0.0.0.0 ./scripts/dev-fresh.sh` على macOS/Linux) — لكن اعلم أن ⚠️ **الخادم المرئي على الشبكة المحلية يوزع مفاتيح 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 على **بيانات عامة، ومصادر واضحة، وتنفيذ محلي أولاً.** لا أسرار، ولا مجموعات بيانات خاصة، ولا تجريف غامض — أي شيء يتضمن مفتاحًا خاصًا يُدار من جانب الخادم. لديه القواعد البصرية لغرفة عمليات سرية، مبني بالكامل من إشارات مفتوحة ورمز قابل للفحص.
**الخط.** يصمم هذا المشروع **الأحداث والأصول والبنية التحتية والأنظمة** — الطائرات والسفن والأقمار الصناعية والحرائق والكاميرات والمدن. لا يبني ميزات للبحث عن أشخاص محددين أو التعرف على الوجوه أو تتبع الأفراد، ولن تُدمج طلبات السحب التي تتجاوز هذا الخط. الأشخاص ليسوا نوع استعلام هنا.
**تعالَ وابنِ.** هذا هو العميل ثلاثي الأبعاد الحي المعياري من المشروع الذي أطلق الموجة الأخيرة من أدوات الاستخبارات المكانية — وهو لوحة: الطبقات هنا هي الإشارات التي يمكن لشخص واحد العثور عليها ودمجها. أضف حزمة مدينة، أو مصدر بيانات، أو نمطًا، أو أداة صوتية. إنها النافذة التي ترى من خلالها العالم؛ انقل تلك النافذة للآخرين.
**الحالة:** عميل مفتوح المصدر قيد التطور للاستكشاف والتعلم — أساس سريع وقابل للتعديل، وليس خدمة إنتاجية محصنة. صدر بموجب **[رخصة MIT](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 صور GIF السبعة عشر على هذه الصفحة ويملكها. كما نشر صورتي 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">
إذن ها هو. ادخل إلى قمرة قيادة إثارة التجسس — باستثناء أن البيانات حقيقية — ولنحوّل هذا إلى صندوق رمل مشترك لفهم العالم، ونستمتع بذلك. هذا المستودع هو خط الأساس، ويبقى مفتوحًا، والفكرة كلها أن تكسر الأشياء وتضيف طبقات لم نفكر بها بعد.
تنبيه واحد من الداخل: اعمل في هذا المجال لأسبوع وستتعلم أن **الحاضر هو الجزء الرخيص**. اللحظة التي تحاول فيها العودة بالزمن — تبليط وتقديم وتمشيط *ما حدث* و*ما تغير* بأي دقة حقيقية — تصبح البيانات باهظة ويصبح الحساب قاسيًا. لذلك، نبني شيئًا رائعًا. المزيد في المستقبل — [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>