סקירה כללית על Geolocation API

‫Geolocation API הוא שירות שמקבל בקשת HTTPS עם נתוני האנטנות הסלולריות ונקודות הגישה ל-Wi-Fi שאפשר לזהות בלקוח נייד. הפונקציה מחזירה קואורדינטות של קו רוחב/אורך ורדיוס שמציין את רמת הדיוק של התוצאה לכל קלט תקין.

למה כדאי להשתמש ב-Geolocation API

אפשר להשתמש ב-Geolocation API כדי לאתר מכשירים ניידים שלא מספקים תכונות של זיהוי מיקום גיאוגרפי באופן מובנה.

מה אפשר לעשות באמצעות Geolocation API

‫Geolocation API מאפשר לכם להשתמש בנתונים גיאוספציאליים ממגדלי תקשורת ומצמתים של Wi-Fi כדי לקבל את המיקום של מכשיר שאין לו מיקום גיאוגרפי או GPS מובנים.

איך Geolocation API פועל

ה-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
}'
 ממשק ה-API יכול להחזיר נתונים למספר שדות נפוצים של נתונים סלולריים, כמו שמצוין בהמשך.

משאבים

בטבלה הבאה מפורטים השדות בגוף הבקשה של קריאת נקודת הקצה של המיקום הגיאוגרפי, וסוג הנתונים שמתקבל משאילתות כאלה.

מקורות נתונים נתונים שהוחזרו פורמט ההחזרה
שדות נתונים של מכשיר סלולרי כמו פרטי הספק, המכשיר והרשת. קואורדינטות של קו רוחב/אורך ורדיוס דיוק JSON
נתונים של מגדלי תקשורת, כמו קוד אזור וקודים של מדינות לניידים.
נתונים של נקודות גישה ל-Wi-Fi, כמו כתובת MAC ועוצמת האות.

איך משתמשים ב-Geolocation API

1 הגדרה מתחילים עם הגדרת הפרויקט ב-Google Cloud ומשלימים את הוראות ההגדרה שבהמשך.
2 ניסיון לשלוח בקשה למיקום גיאוגרפי אחרי שיש לכם מפתח API, אתם יכולים להתחיל לבדוק את Geolocation API באמצעות cURL או Postman. פרטים נוספים זמינים במדריך בקשות ותגובות של מיקום גיאוגרפי, בקטע בקשות לדוגמה.
3 קבלת מזהה התא ממגדלי רדיו שונים במאמרים חישוב cellID ו חישוב newRadioCellID מוסבר איך לגשת לנתונים של אנטנות ישנות וחדשות, בהתאמה.
4 הסבר על תשובות בסיסיות כדאי לעיין בתשובות של נתוני המיקום הגיאוגרפי כדי להתכונן לשימוש בנתוני הגובה באפליקציה. פרטים נוספים זמינים במאמר בנושא תשובות של נתוני מיקום גיאוגרפי.

ספריות לקוח זמינות

אפשר לקרוא ל-API הזה בשפה הרצויה באמצעות אחת מספריות הלקוח הבאות:

הלקוחות של Java, ‏ Python, ‏ Go ו-Node.js עבור Google Maps Services הן ספריות לקוח עם תמיכה מהקהילה, שזמינות בקוד פתוח במסגרת רישיון Apache 2.0. אפשר להוריד אותם מ-GitHub, שם אפשר למצוא גם הוראות התקנה וקוד לדוגמה.

המאמרים הבאים