סקירה כללית על 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, שם אפשר למצוא גם הוראות התקנה וקוד לדוגמה.

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