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

‫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 وPython Client وGo Client وNode.js Client لخدمات "خرائط Google" هي مكتبات عملاء متاحة للجميع ومفتوحة المصدر بموجب ترخيص Apache 2.0. يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونماذج الرموز البرمجية.

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