WaveDigger

वायरलेस सिग्नलों की खोज करके उनके भौतिक स्थानों का पता लगाएं। WaveDigger आपको BSSID (MAC पता) द्वारा Wi-Fi एक्सेस पॉइंट्स और नेटवर्क पैरामीटर द्वारा सेल टावरों (LTE और 5G NR) को खोजने में मदद करता है। इंटरैक्टिव मैप विज़ुअलाइज़ेशन के लिए Next.js, TypeScript, और deck.gl के साथ बनाया गया।

एक होस्ट किया गया संस्करण https://wavedigger.networksurvey.app पर पाया जा सकता है।

विशेषताएँ

• BSSID खोज: किसी BSSID का अनुमानित स्थान खोजने के लिए उसे दर्ज करें
• इनपुट सत्यापन: BSSID इनपुट का स्वचालित फ़ॉर्मेटिंग और सत्यापन
  • समर्थित फ़ॉर्मेट: AA:BB:CC:DD:EE:FF, AA-BB-CC-DD-EE-FF, AABBCCDDEEFF
• सेल टावर खोज: LTE टावरों (MCC, MNC, TAC, Cell ID) या 5G NR टावरों (MCC, MNC, TAC, NCI) को खोजें। NR खोजें लक्ष्य सेल के साथ-साथ उसी क्लस्टर में आसपास के NR सेल भी लौटाती हैं।
• इंटरैक्टिव मैप: परिणामों को deck.gl-संचालित मैप पर विज़ुअलाइज़ करें
• खोज इतिहास: त्वरित पहुँच के लिए हाल की खोजों को ट्रैक करें
• रेस्पॉन्सिव डिज़ाइन: डेस्कटॉप और मोबाइल उपकरणों पर काम करता है

आभार

🙏 यह प्रोजेक्ट apple-corelocation-experiments टीम द्वारा किए गए अविश्वसनीय काम के बिना संभव नहीं होता।

WaveDigger उनके शोध और Apple की लोकेशन सर्विसेज़ API की रिवर्स इंजीनियरिंग पर आधारित है। विशेष रूप से, हम उपयोग करते हैं:

• Apple की WLOC API के लिए उनकी protobuf परिभाषाएँ
• API एंडपॉइंट्स और रिक्वेस्ट/रिस्पॉन्स फ़ॉर्मेट का दस्तावेज़ीकरण
• कोऑर्डिनेट एन्कोडिंग और API व्यवहार की समझ
• वैध रिक्वेस्ट के लिए आवश्यक प्रारंभिक bytes प्रीफ़िक्स

Apple की अप्रलेखित लोकेशन सर्विसेज़ को समझने और प्रलेखित करने में उनके काम ने WaveDigger जैसे प्रोजेक्ट्स के अस्तित्व को संभव बनाया है। कृपया मूल शोध और Apple की लोकेशन सर्विसेज़ के साथ काम करने के लिए अतिरिक्त टूल्स के लिए उनका रिपॉज़िटरी देखें।

शुरुआत करना

पूर्वापेक्षाएँ

• Node.js 24+ और npm

इंस्टॉलेशन

1. डिपेंडेंसीज़ इंस्टॉल करें:

npm install

1. (वैकल्पिक) बेहतर मैप टाइल्स के लिए एक Mapbox टोकन जोड़ें:
   • Mapbox से एक टोकन प्राप्त करें
   • इसे .env.local में जोड़ें:

   NEXT_PUBLIC_MAPBOX_TOKEN=your_token_here
   

डेवलपमेंट सर्वर चलाना

npm run dev

एप्लिकेशन देखने के लिए http://localhost:3000 खोलें।

तकनीकी विवरण

आर्किटेक्चर

• फ्रंटएंड: TypeScript के साथ Next.js 15
• मैप विज़ुअलाइज़ेशन: react-map-gl के साथ deck.gl
• स्टाइलिंग: Tailwind CSS
• API: Next.js API रूट्स

वास्तविक Apple WLOC API

एप्लिकेशन BSSID स्थानों को क्वेरी करने के लिए Apple की वास्तविक WLOC API का उपयोग करता है। यह कार्यान्वयन apple-corelocation-experiments प्रोजेक्ट के शोध और protobuf परिभाषाओं पर आधारित है।

API कार्यान्वयन:

• Apple के सर्वर के साथ संचार के लिए protobuf का उपयोग करता है
• https://gs-loc.apple.com/clls/wloc पर रिक्वेस्ट भेजता है
• कोऑर्डिनेट रूपांतरण को संभालता है (Apple 8 दशमलव स्थानों के साथ int64 का उपयोग करता है)
• डिफ़ॉल्ट और चीन क्षेत्र दोनों एंडपॉइंट्स का समर्थन करता है

वास्तविक BSSID के साथ परीक्षण

ऐप का परीक्षण करने के लिए:

1. अपने राउटर या एक्सेस पॉइंट से एक वास्तविक Wi-Fi BSSID (MAC पता) खोजें
2. इसे किसी भी समर्थित फ़ॉर्मेट में दर्ज करें
3. ऐप Apple के डेटाबेस को क्वेरी करेगा और यदि मिल जाए तो स्थान दिखाएगा

नोट: सभी BSSID Apple के डेटाबेस में नहीं हैं। नए तैनात या निजी एक्सेस पॉइंट्स में लोकेशन डेटा नहीं हो सकता है।

विशेषताओं का रोडमैप

• परिणाम निर्यात करें: खोज परिणामों को JSON/CSV के रूप में डाउनलोड करें
• TAC-क्लस्टर व्यू: किसी विशिष्ट Cell ID या NCI की आवश्यकता के बिना TAC में हर टावर ब्राउज़ करें

लाइसेंस

WaveDigger GNU Affero General Public License v3.0 के अंतर्गत लाइसेंस प्राप्त है। यदि आप इस सॉफ़्टवेयर का संशोधित संस्करण नेटवर्क सेवा के रूप में चलाते हैं, तो AGPL के लिए आवश्यक है कि आप अपने संशोधित सोर्स कोड को उस सेवा के उपयोगकर्ताओं के लिए उपलब्ध कराएँ।