Geolocation API هي خدمة تقبل طلب HTTPS مع برج الاتصالات ونقاط دخول WiFi التي يمكن أن يكتشفها عميل الهاتف الجوال. يقوم بإرجاع إحداثيات خط العرض/خط الطول ونصف قطر يشير إلى دقة لكل إدخال صالح.
أسباب استخدام واجهة برمجة التطبيقات Geolocation API
استخدام واجهة برمجة التطبيقات Geolocation API لتحديد موقع الأجهزة الجوّالة التي لا توفّر ميزة رصد الموقع الجغرافي الأصلية الجديدة.
الإجراءات التي يمكنك تنفيذها باستخدام واجهة برمجة التطبيقات Geolocation API
يمكنك من خلال واجهة برمجة التطبيقات Geolocation API استخدام البيانات الجغرافية المكانية من أبراج الاتصالات وعُقد WiFi للحصول على موقع جهاز لا يتضمن نظامًا لتحديد الموقع الجغرافي أو نظام تحديد المواقع العالمي (GPS).
آلية عمل واجهة برمجة التطبيقات Geolocation API
تستخدم واجهة برمجة التطبيقات Geolocation API حقول بيانات الأجهزة الجوّالة وبرج الاتصالات وبيانات مصفوفة نقطة وصول WiFi لعرض إحداثيات خط العرض/خط الطول والحصول على دقة النطاق الجغرافي. قبول طلب 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). و احتساب newRadioCellID للدخول إلى الأبراج الأقدم والأحدث، على التوالي. |
| 4 | فهم أساسيات الردود | يمكنك استكشاف استجابات بيانات رصد الموقع الجغرافي للاستعداد لاستخدام بيانات الارتفاع في تطبيقك. عرض استجابات رصد الموقع الجغرافي لمزيد من التفاصيل. |
مكتبات العملاء المتاحة
استدعِ واجهة برمجة التطبيقات هذه بلغة حسب اختيارك من خلال إحدى مكتبات العملاء التالية:
- Java برنامج لخدمات "خرائط Google"
- لغة Python برنامج لخدمات "خرائط Google"
- عميل Go لخدمات "خرائط Google"
- Node.js برنامج لخدمات "خرائط Google"
عميل Java، وعميل Python، وعميل Go، وعميل Node.js لخرائط Google والخدمات هي مكتبات عملاء مدعومة من خلال المنتدى، وتكون مفتوحة المصدر ضمن ترخيص Apache 2.0: قم بتنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونموذج التعليمات البرمجية.
الخطوات التالية
- البدء في استخدام نماذج للطلبات والردود: انتقِل إلى طلب رصد الموقع الجغرافي والردّ
- اتّباع أفضل الممارسات: الانتقال إلى أفضل الممارسات لخدمات الويب:
- فهم الفوترة: انتقِل إلى الاستخدام والفوترة.