NETRYX

محرك تحديد المواقع الجغرافية على مستوى الشارع مفتوح المصدر

ارفع أي صورة شارع. احصل على إحداثيات GPS دقيقة.
دقة أقل من 50 متر. لا حاجة لمعالم. يعمل بالكامل على أجهزتك.

عروض توضيحية · كيف يعمل · البدء · الاستخدام · الأسئلة الشائعة

هذا الإصدار قديم، استخدم هذا بدلاً من ذلك

المستودع الجديد

ما هو Netryx؟

Netryx هي أداة تحديد مواقع جغرافية تعمل محلياً أولاً وتحدد الإحداثيات الدقيقة لأي صورة شارع. على عكس البحث العكسي عن الصور (الذي يطابق الصور المرفوعة على الويب)، يطابق Netryx صورًا بانورامية للشوارع تم جمعها بشكل منهجي — مما يعني أنه يعمل على أي زاوية شارع عشوائية بدون أي وجود على الإنترنت.

يجمع خط الأنابيب الأساسي بين ثلاثة نماذج رؤية حاسوبية حديثة:

• CosPlace للتعرف البصري على الأماكن عالمياً (الاسترجاع)
• ALIKED/DISK لاستخراج الميزات المحلية (النقاط المفتاحية)
• LightGlue لمطابقة الميزات العميقة (التحقق)

Google Lens يبحث في الإنترنت. Netryx يبحث في العالم المادي.

عروض توضيحية

كيف يعمل

يستخدم Netryx خط أنابيب من ثلاث مراحل يضيق تدريجياً من ملايين المرشحين إلى تطابق دقيق واحد. Netryx هو مجرد أداة، وهي غير مرتبطة بمصدر ويمكنها معالجة الصور من أي مزود مثل mapillary أو kartaview أو أي مزود آخر.

المرحلة 1 — الاسترجاع العالمي (CosPlace)

تمت معالجة كل صورة بانورامية للشارع في الفهرس مسبقاً إلى "بصمة" بُعدها 512 باستخدام CosPlace، وهو نموذج التعرف البصري على الأماكن المدرب على ملايين الصور ذات العلامات الجغرافية.

عند رفع صورة استعلام:

1. يستخرج النظام واصف CosPlace من صورتك
2. يستخرج أيضاً واصفاً من نسخة مقلوبة أفقياً (يلتقط المنظورات المعكوسة)
3. تُقارن كلا الواصفين مع كل إدخال في الفهرس باستخدام تشابه جيب التمام
4. يقوم مرشح نصف القطر (مسافة هافرسين) بتضييق المرشحين إلى منطقة البحث المحددة
5. يتم إرجاع أفضل 500–1000 صورة بانورامية متشابهة بصرياً كمرشحين

تعمل هذه المرحلة في أقل من ثانية واحدة بغض النظر عن حجم الفهرس — إنها عملية ضرب مصفوفة واحدة.

المرحلة 2 — التحقق الهندسي المحلي (ALIKED/DISK + LightGlue)

يجد CosPlace أماكن تبدو متشابهة. تثبت المرحلة 2 أنها نفس المكان باستخدام التحقق الهندسي.

لكل مرشح:

1. يتم تنزيل البانوراما الأصلية من Google Street View (8 بلاطات، مدمجة)
2. يتم استخراج قص مستقيم الزوايا بزاوية الاتجاه المفهرسة
3. يتم إنشاء قص متعدد زوايا الرؤية بثلاثة مجالات رؤية (70°، 90°، 110°) للتعامل مع عدم تطابق التكبير بين صورة الاستعلام والمنظر المفهرس
4. يستخرج ALIKED (على CUDA) أو DISK (على MPS/CPU) النقاط المفتاحية والواصفات المحلية
5. يقوم LightGlue بمطابقة الميزات العميقة بين النقاط المفتاحية للاستعلام والمرشح
6. يقوم RANSAC بتصفية المطابقات للاحتفاظ فقط بالتوافقات المتسقة هندسياً (يرفض المطابقات الخاطئة)
7. المرشح الذي يحتوي على أكبر عدد من النقاط الداخلية التي تم التحقق منها هو أفضل تطابق

تعالج هذه المرحلة 300–500 مرشح في 2–5 دقائق حسب أجهزتك.

المرحلة 3 — التحسين

التطابق الأولي جيد ولكنه ليس الأمثل دائماً. يعمل التحسين على تحسينه:

• تحسين زاوية الاتجاه: بالنسبة لأفضل 15 مرشحاً، يختبر النظام إزاحات ±45° بخطوات 15° عبر 3 مجالات رؤية. هذا يلتقط الحالات التي لا تتطابق فيها زاوية الاتجاه المفهرسة تماماً مع اتجاه رؤية الاستعلام.
• التوافق المكاني: يتم تجميع المطابقات في خلايا 50 متر. إذا تجمع عدة مرشحين في منطقة واحدة، تُفضل هذه المجموعة على مرشح فردي ذي نقاط داخلية عالية — مما يقلل النتائج الإيجابية الخاطئة.
• تسجيل الثقة: يقوم النظام بتقييم التجميع الجغرافي لأفضل المطابقات ونسبة التفرد (مدى تفوق أفضل تطابق على الوصيف في موقع مختلف).

الوضع الفائق (اختياري)

للصور الصعبة (ليل، ضباب، نسيج منخفض)، يضيف الوضع الفائق:

• LoFTR: مطابق كثيف بدون كاشف يجد التوافقات دون الاعتماد على كشف النقاط المفتاحية. يتعامل مع الضباب والمشاهد منخفضة التباين حيث يكافح ALIKED/DISK.
• القفز بالواصف: إذا كان التطابق الأولي ضعيفاً (<50 نقطة داخلية)، يستخرج النظام واصف CosPlace من البانوراما المتطابقة (وهي نظيفة وعالية الجودة) ويعيد البحث في الفهرس. غالباً ما يجد هذا البانوراما الصحيحة الدقيقة التي فاتها الاستعلام المتدهور.
• التوسع الجيراني: يبحث في جميع البانورامات ضمن 100 متر من أفضل تطابق. غالباً ما يكون الموقع الصحيح على بعد عقدة شارع واحدة من أفضل تطابق في CosPlace.

الهيكل

صورة الاستعلام
    │
    ├── استخراج واصف CosPlace (بصمة 512-بعد)
    ├── استخراج واصف الصورة المقلوبة
    │
    ▼
البحث في الفهرس (تشابه جيب التمام، مرشح نصف القطر)
    │
    ├── أفضل 500 مرشح مرتبة حسب التشابه البصري
    │
    ▼
تنزيل البانورامات → قص بزوايا رؤية 3 → استخراج نقاط ALIKED/DISK المفتاحية
    │
    ├── مطابقة LightGlue مقابل نقاط الاستعلام المفتاحية
    ├── التحقق الهندسي RANSAC
    │
    ▼
تحسين زاوية الاتجاه (±45°، 3 مجالات رؤية، أفضل 15 مرشحاً)
    │
    ├── تجميع التوافق المكاني
    ├── تسجيل الثقة
    │
    ▼
📍 إحداثيات GPS + درجة الثقة

البدء

المتطلبات

دعم GPU:

• Mac: MPS (Metal Performance Shaders) — M1/M2/M3/M4
• NVIDIA: CUDA — أي GPU بذاكرة 4GB+
• CPU: يعمل لكنه أبطأ بكثير

التثبيت

# استنساخ المستودع
git clone https://github.com/sparkyniner/Netryx-OpenSource-Next-Gen-Street-Level-Geolocation.git

cd .\Netryx-OpenSource-Next-Gen-Street-Level-Geolocation\

# إنشاء بيئة افتراضية
python3 -m venv venv
source venv/bin/activate  # على ويندوز: venv\Scripts\activate

# تثبيت التبعيات
pip install -r requirements.txt

# تثبيت LightGlue صراحة (مطلوب للمطابقة)
pip install git+https://github.com/cvg/LightGlue.git

# اختياري: تثبيت kornia للوضع الفائق (LoFTR)
pip install kornia

ملاحظة: يتم استيراد lightglue من قبل التطبيق كوحدة Python، ولكن يتم تثبيته من مستودع GitHub أعلاه.

مفتاح Gemini API (اختياري — للوضع الخشن بالذكاء الاصطناعي) [غير موصى به للاستخدام، اليدوي يقوم بالمهمة]

إذا كنت ترغب في استخدام ميزة التحديد الجغرافي الأعمى بمساعدة الذكاء الاصطناعي:

1. احصل على مفتاح API مجاني من Google AI Studio
2. قم بتعيينه كمتغير بيئة:

export GEMINI_API_KEY="your_key_here"

الاستخدام

تشغيل الواجهة الرسومية

python test_super.py

مستخدمو macOS: إذا ظهرت الواجهة فارغة، قم بترقية tkinter: brew install [email protected] (أو إصدار Python الخاص بك). يعاني tkinter المضمن في Python للنظام من مشكلات عرض معروفة في إصدارات macOS الحديثة.

الخطوة 1: إنشاء فهرس

قبل البحث، تحتاج إلى فهرسة منطقة. هذا يزحف على البانورامات الخاصة بـ Street View ويستخلص بصمات CosPlace.

1. اختر وضع Create
2. أدخل إحداثيات المركز (خط العرض، خط الطول) للمنطقة التي تريد فهرستها
3. قم بتعيين نصف قطر البحث (ابدأ بـ 0.5–1 كم للاختبار، 5–10 كم للإنتاج)
4. قم بتعيين دقة الشبكة (300 هي افتراضية جيدة — الأعلى يعني تغطية أكثر كثافة، من فضلك لا تعبث بهذا)
5. انقر Create Index

تقديرات وقت الفهرسة:

يتم حفظ الفهرس بشكل تدريجي — إذا توقفت العملية، فإنها تستأنف من حيث توقفت في المرة التالية.

الخطوة 2: البحث

1. اختر وضع Search
2. ارفع صورة شارع
3. اختر طريقة البحث:
   • Manual: أدخل الإحداثيات + نصف القطر إذا كنت تعرف تقريباً من أين التقطت الصورة
   • AI Coarse: دع Gemini يحلل الدلائل البصرية (لافتات، عمارة، نباتات) لتخمين المنطقة — لا حاجة لمعرفة مسبقة
4. انقر Run Search، ثم Start Full Search
5. شاهد تصور المسح في الوقت الفعلي أثناء تقييم المرشحين
6. تظهر النتيجة على الخريطة مع درجة الثقة

الوضع الفائق

فعّل مربع Ultra Mode للصور الصعبة. يضيف هذا المطابقة الكثيفة LoFTR، والقفز بالواصف، والتوسع الجيراني. أبطأ بكثير لكنه يلتقط مطابقات يفوتها خط الأنابيب القياسي.

كيف يعمل الفهرس

يتم تخزين جميع التضمينات في فهرس واحد موحد. عند البحث، يقوم مرشح نصف القطر تلقائياً بتقييد النتائج للمنطقة التي تحددها. هذا يعني:

• يمكنك فهرسة باريس، ثم تل أبيب، ثم لندن — كلها في نفس الفهرس
• البحث بمركز = باريس، نصف القطر = 5 كم يعيد فقط نتائج باريس
• البحث بمركز = لندن، نصف القطر = 10 كم يعيد فقط نتائج لندن
• لا حاجة لاختيار مدينة — الإحداثيات + نصف القطر يتعاملان مع كل شيء

تدفق البيانات:

وضع الإنشاء:
  نقاط الشبكة → Google Street View API → بانورامات → قصاصات → CosPlace → cosplace_parts/*.npz

البناء التلقائي:
  cosplace_parts/*.npz → cosplace_descriptors.npy + metadata.npz (فهرس قابل للبحث)

وضع البحث:
  صورة الاستعلام → CosPlace → البحث في الفهرس (مرشح نصف القطر) → تنزيل المرشحين → ALIKED/DISK + LightGlue → النتيجة

هيكل المشروع

netryx/
├── test_super.py          # التطبيق الرئيسي (واجهة رسومية + فهرسة + بحث)
├── cosplace_utils.py      # تحميل نموذج CosPlace واستخراج الواصف
├── build_index.py         # باني فهرس عالي الأداء مستقل (لمجموعات البيانات الكبيرة)
├── requirements.txt       # تبعيات بايثون
├── cosplace_parts/        # قطع التضمين الخام (التي تم إنشاؤها أثناء الفهرسة)
├── index/                 # الفهرس المترجم القابل للبحث
│   ├── cosplace_descriptors.npy   # جميع الواصفات 512-بعد
│   └── metadata.npz               # الإحداثيات، الزوايا، معرفات البانوراما
└── README.md

تفاصيل تقنية

النماذج المستخدمة

السلوك الخاص بالمنصة

الأسئلة الشائعة

هل تنخفض الدقة مع زيادة نصف قطر البحث؟

لا. يقوم CosPlace بالترتيب حسب التشابه البصري عبر الفهرس بأكمله. سواء كان فهرسك يغطي 1 كم أو 50 كم، فإن أفضل المرشحين هم دائماً الأكثر تشابهاً بصرياً. يقوم مرشح نصف القطر ببساطة باستبعاد الإدخالات غير ذات الصلة جغرافياً قبل الترتيب.

كم من الوقت يستغرق البحث؟

عادة 2–5 دقائق على Apple Silicon، 1–3 دقائق على NVIDIA GPU. عنق الزجاجة هو تنزيل بلاطات البانوراما من Google (تقييد الشبكة)، وليس المطابقة نفسها.

هل يمكنني فهرسة بلد بأكمله؟

غير عملي. نصف قطر 10 كم ينتج حوالي 100 ألف بانوراما وفهرس بحجم 7 جيجابايت. بلد بأكمله سيتطلب بيتابايتات. فهرس مدناً أو مناطق اهتمام محددة (5–20 كم).

بحثي لم يعثر على أي مرشحين.

إحداثيات بحثك لا تتداخل مع أي منطقة مفهرسة. إما أن تفهرس المنطقة أولاً، أو اضبط مركز/نصف قطر البحث ليتداخل مع البيانات المفهرسة الموجودة. استخدم "Show Coverage Map" لتصور ما تمت فهرسته.

التطابق خاطئ قليلاً (مختلف بكتلة واحدة).

فعّل الوضع الفائق. التوسع الجيراني يبحث في جميع البانورامات ضمن 100 متر من التطابق الأولي، وغالباً ما يجد عقدة الشارع الصحيحة الدقيقة.

هل يعمل هذا مع الصور الداخلية؟

لا. يطابق Netryx فقط البانورامات الخارجية للشوارع. الصور الداخلية، الصور الجوية/القمر الصناعي، وصور الأشياء عن قرب لن تنتج نتائج ذات معنى.

هل هذا مكلف؟

Netryx مجاني ومفتوح المصدر. ميزة AI Coarse الاختيارية تتطلب مفتاح Gemini API (الطبقة المجانية متاحة من Google). تكاليف الحوسبة هي أجهزتك الخاصة — لا حاجة لخدمات سحابية.

هل هناك نسخة مستضافة؟

نعم. netryx.live يدير خط الأنابيب الكامل في السحاب حتى لا تحتاج إلى إعداد أي شيء محلياً. مفيد إذا كنت تريد نتائج سريعة دون بناء الفهرس الخاص بك. لكنها أقل دقة بنحو 30% من النسخة مفتوحة المصدر بسبب قيود الحوسبة.

لا تريد إعداد خط الأنابيب بالكامل؟

netryx.live يدير نفس المحرك في السحاب — ارفع صورة، احصل على الإحداثيات. لا تثبيت، لا فهرسة، لا حاجة لـ GPU. لكنها أقل دقة بنحو 30% من النسخة مفتوحة المصدر بسبب قيود الحوسبة.

بناه

Sairaj Balaji — باحث ذكاء اصطناعي ومنشئ PrismX. منح من Microsoft for Startups و ElevenLabs. ظهر في Fast Company و Deutsche Welle.

• LinkedIn

الترخيص

رخصة MIT. انظر LICENSE للتفاصيل.

إخلاء مسؤولية قانوني

صُمم Netryx لأبحاث OSINT المشروعة، الصحافة الاستقصائية، مراقبة حقوق الإنسان، الاستجابة للكوارث، والبحث الأكاديمي.

مسؤولية المستخدم: أنت وحدك المسؤول عن ضمان الامتثال للقوانين السارية، بما في ذلك شروط خدمة Google Maps/Street View ولوائح الخصوصية المحلية.

لا تستخدم في: المطاردة، التحرش، المراقبة غير المصرح بها، أو أي نشاط ينتهك خصوصية أو سلامة الأفراد.

يتنصل مطورو Netryx من كل المسؤولية عن سوء الاستخدام.