نظرة عامة على Geolocation API

واجهة برمجة التطبيقات Geolocation API هي خدمة تقبل طلب HTTPS مع برج الهاتف الخلوي ونقاط وصول WiFi التي يمكن لعميل الجوّال اكتشافها. فهو يعرض إحداثيات خط العرض/خط الطول ونصف القطر الذي يشير إلى دقة النتيجة لكل إدخال صالح.

أسباب استخدام واجهة برمجة التطبيقات Geolocation API

يمكنك استخدام واجهة برمجة التطبيقات Geolocation API لتحديد موقع الأجهزة الجوّالة التي لا توفّر ميزات رصد الموقع الجغرافي الأصلية.

ما يمكنك فعله باستخدام واجهة برمجة التطبيقات Geolocation

باستخدام واجهة برمجة التطبيقات 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

1 الإعداد ابدأ بمقالة إعداد مشروعك على Google Cloud وأكمِل تعليمات الإعداد التالية.
2 تجربة طلب رصد الموقع الجغرافي بعد حصولك على مفتاح واجهة برمجة التطبيقات، يمكنك البدء في اختبار واجهة برمجة التطبيقات للمواقع الجغرافية باستخدام cURL أو Postman. يمكنك الاطّلاع على نماذج الطلبات في دليل طلبات رصد الموقع الجغرافي والاستجابة له للحصول على التفاصيل.
3 الحصول على رقم تعريف الهاتف الخلوي من أبراج لاسلكية مختلفة يمكنك مراجعة احتساب معرف الهاتف الخلوي و احتساب معرف RadioCellID الجديد للوصول إلى الأبراج القديمة والأحدث، على التوالي.
4 فهم أساسيات الردود استكشِف استجابات بيانات الموقع الجغرافي للاستعداد لاستخدام بيانات الارتفاع لتطبيقك. ويمكنك الاطّلاع على ردود رصد الموقع الجغرافي لمعرفة التفاصيل.

مكتبات العملاء المتاحة

يمكنك استدعاء واجهة برمجة التطبيقات هذه باللغة التي تختارها من خلال إحدى مكتبات العملاء التالية:

إنّ Java Client وPython Client وGo Client وNode.js Client for Google Maps هي مكتبات عملاء مدعومة من المنتدى، ومفتوحة المصدر بموجب ترخيص Apache 2.0. يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونموذج التعليمات البرمجية.

الخطوات التالية