واجهة برمجة التطبيقات للموقع الجغرافي هي خدمة تقبل طلب HTTPS مع برج الهاتف الخلوي ونقاط دخول WiFi التي يمكن لبرنامج الجوّال اكتشافها. فهو يعرض إحداثيات خطوط الطول/دوائر العرض ونطاق جغرافي يوضح دقة النتيجة لكل إدخال صالح.
أسباب استخدام واجهة برمجة التطبيقات للمواقع الجغرافية
يمكنك استخدام واجهة برمجة تطبيقات الموقع الجغرافي لتحديد موقع أجهزة الجوّال التي لا توفر ميزات تحديد الموقع الجغرافي.
ما يمكنك فعله باستخدام واجهة برمجة التطبيقات للمواقع الجغرافية
باستخدام واجهة برمجة التطبيقات للمواقع الجغرافية، يمكنك استخدام البيانات الجغرافية المكانية من الأبراج الخلوية وعُقد WiFi للحصول على موقع جهاز لا يتضمن تحديد الموقع الجغرافي الأصلي أو نظام تحديد المواقع العالمي (GPS).
كيفية عمل واجهة برمجة التطبيقات للمواقع الجغرافية
تستخدم واجهة برمجة التطبيقات للمواقع الجغرافية حقول بيانات الأجهزة الخلوية وبيانات الأبراج الخلوية وبيانات مصفوفة نقاط الدخول إلى شبكة WiFi لعرض إحداثيات خطوط الطول/العرض ونطاق جغرافي للدقة. تقبل هذه الوسيطة طلب HTTPS POST إلى نقطة النهاية إلى جانب نص الطلب المنظَّم JSON. يعرض المثال التالي عنوان URL للطلب ونص نموذج الطلب:
https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY
{
"homeMobileCountryCode": 310,
"homeMobileNetworkCode": 410,
"radioType": "gsm",
"carrier": "Vodafone",
"considerIp": true,
"cellTowers": [
// See the Cell Tower Objects section below.
],
"wifiAccessPoints": [
// See the WiFi Access Point Objects section below.
]
}
يمكن لواجهة برمجة التطبيقات عرض بيانات لعدد من حقول بيانات شبكة الجوّال الشائعة كما هو موضّح أدناه.
الموارد
يلخّص الجدول التالي الحقول في نص الطلب لاستدعاء نقطة نهاية الموقع الجغرافي، بالإضافة إلى نوع البيانات المقدّمة من طلبات البحث هذه.
| موارد البيانات | البيانات المعروضة | تنسيق الإرجاع |
|---|---|---|
| حقول بيانات الجهاز الخلوي مثل معلومات مشغّل شبكة الجوّال والجهاز والشبكة. | إحداثيات خط العرض/خط الطول ونصف قطر الدقة | JSON |
| بيانات برج الهاتف الخلوي، مثل رمز منطقة الموقع الجغرافي ورموز بلد الجوّال. | ||
| بيانات نقاط وصول Wi-Fi، مثل عنوان MAC ومدى قوة الإشارة. |
كيفية استخدام واجهة برمجة التطبيقات للمواقع الجغرافية
| 1 | الإعداد | ابدأ من خلال إعداد مشروع Google Cloud وأكمِل تعليمات الإعداد التالية. |
| 2 | تجربة طلب رصد الموقع الجغرافي | بعد الحصول على مفتاح واجهة برمجة تطبيقات، يمكنك البدء في اختبار واجهة برمجة التطبيقات للمواقع الجغرافية باستخدام cURL أو Postman. راجِع نموذج الطلبات في دليل طلبات البحث عن الموقع الجغرافي والرد عليه لمعرفة التفاصيل. |
| 3 | الحصول على رقم تعريف الخلية من أبراج الراديو المختلفة | راجِع جارٍ حساب رقم تعريف الخلية و حساب جديد RadioCellID للوصول إلى الأبراج القديمة والجديدة على التوالي. |
| 4 | فهم أساسيات الاستجابة | استكشِف استجابات بيانات رصد الموقع الجغرافي للاستعداد لاستخدام بيانات الارتفاع لتطبيقك. راجِع الردود على رصد الموقع الجغرافي لمعرفة التفاصيل. |
مكتبات العملاء المتاحة
يمكنك استدعاء واجهة برمجة التطبيقات هذه باللغة التي تختارها من خلال إحدى مكتبات العملاء التالية:
- برنامج JavaScript لخدمات "خرائط Google"
- برنامج Python لخدمات "خرائط Google"
- Go Client لخدمات "خرائط Google"
- عميل Node.js لخدمات "خرائط Google"
عميلي جافا وعميل Python وGo Client وNode.js Client لخدمات خرائط Google هي مكتبات برامج يدعمها المنتدى ومفتوحة المصدر بموجب ترخيص Apache 2.0. يمكنك تنزيلها من GitHub، حيث يمكنك أيضًا العثور على تعليمات التثبيت ونموذج للرمز.
الخطوات التالية
- البدء باستخدام نماذج الطلبات والردود: انتقِل إلى طلب الموقع الجغرافي والرد عليه.
- اتّباع أفضل الممارسات: انتقِل إلى أفضل ممارسات خدمة الويب.
- فهم الفوترة: انتقِل إلى الاستخدام والفوترة.