
Geolocation API هي خدمة تقبل طلب HTTPS يتضمّن أبراج الهاتف الخلوي ونقاط الوصول إلى Wi-Fi التي يمكن لجهاز جوّال رصدها. تعرض هذه الطريقة إحداثيات خطوط الطول والعرض ونطاقًا جغرافيًا يشير إلى دقة النتيجة لكل إدخال صالح.
أسباب استخدام Geolocation API
استخدِم Geolocation API لتحديد موقع الأجهزة الجوّالة التي لا توفّر ميزات مدمجة لتحديد الموقع الجغرافي.
الإجراءات التي تتيح واجهة برمجة التطبيقات Geolocation API تنفيذها
باستخدام Geolocation API، يمكنك استخدام البيانات الجغرافية المكانية من أبراج الاتصالات وعُقد Wi-Fi للحصول على الموقع الجغرافي لجهاز لا يتضمّن ميزة تحديد الموقع الجغرافي أو نظام تحديد المواقع العالمي (GPS).
طريقة عمل Geolocation API
تستخدم واجهة برمجة التطبيقات Geolocation API حقول بيانات الأجهزة الخلوية وبيانات أبراج الاتصالات وبيانات مصفوفة نقاط وصول Wi-Fi لعرض إحداثيات خطوط الطول والعرض ونطاق الدقة. يقبل هذا الإجراء طلب HTTPS POST إلى نقطة النهاية مع نص طلب JSON منظَّم. يوضّح المثال التالي عنوان URL للطلب ومثالاً على نص الطلب:
curl -X POST "https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d \ '{ "homeMobileCountryCode":310, "homeMobileNetworkCode":410, "radioType":"gsm", "carrier":"Vodafone", "considerIp":true }'
الموارد
يلخّص الجدول التالي الحقول في نص طلب استدعاء نقطة نهاية تحديد الموقع الجغرافي، بالإضافة إلى نوع البيانات المقدَّمة من هذه الاستعلامات.
موارد البيانات | البيانات التي تم عرضها | تنسيق القيمة التي يتم إرجاعها |
---|---|---|
حقول بيانات الأجهزة الجوّالة مثل معلومات مشغّل شبكة الجوّال والجهاز والشبكة | إحداثيات خطوط العرض/الطول ونصف قطر الدقة | JSON |
بيانات أبراج الاتصالات، مثل رمز منطقة الموقع الجغرافي ورموز البلدان الخاصة بشبكة الجوّال | ||
بيانات نقاط وصول شبكة Wi-Fi، مثل عنوان MAC وقوة الإشارة |
كيفية استخدام Geolocation API
1 | إعداد حسابك | ابدأ بإعداد مشروعك على Google Cloud واتّبِع تعليمات الإعداد التي تلي ذلك. |
2 | تجربة طلب تحديد الموقع الجغرافي | بعد الحصول على مفتاح واجهة برمجة التطبيقات، يمكنك البدء في اختبار Geolocation API باستخدام cURL أو Postman. يمكنك الاطّلاع على نماذج الطلبات في دليل طلبات تحديد الموقع الجغرافي والردود للحصول على التفاصيل. |
3 | الحصول على cellID من أبراج راديو مختلفة | راجِع حساب cellID و حساب newRadioCellID للوصول إلى الأبراج القديمة والجديدة على التوالي. |
4 | التعرّف على أساسيات الردود | استكشِف الردود على بيانات الموقع الجغرافي للاستعداد لاستخدام بيانات الارتفاع في تطبيقك. راجِع ردود الموقع الجغرافي لمعرفة التفاصيل. |
مكتبات البرامج المتاحة
يمكنك طلب بيانات من واجهة برمجة التطبيقات هذه باللغة التي تختارها من خلال إحدى مكتبات البرامج التالية:
- Java Client for Google Maps Services
- برنامج Python العميل لخدمات "خرائط Google"
- Go Client for Google Maps Services
- Node.js Client for Google Maps Services
إنّ Java Client وPython Client وGo Client وNode.js Client لخدمات "خرائط Google" هي مكتبات عملاء متاحة للجميع ومفتوحة المصدر بموجب ترخيص Apache 2.0. يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونماذج الرموز البرمجية.
الخطوات التالية
- بدء استخدام أمثلة على الطلبات والردود: انتقِل إلى طلب تحديد الموقع الجغرافي والرد
- اتّباع أفضل الممارسات: انتقِل إلى أفضل الممارسات المتعلّقة بخدمات الويب.
- التعرّف على الفوترة: انتقِل إلى الاستخدام والفوترة.