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

Geolocation API הוא שירות שמקבל בקשת HTTPS עם מגדל תקשורת ונקודות גישה (AP) של 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
}'
ממשק ה-API יכול להחזיר נתונים בכמה שדות נפוצים של נתונים סלולריים, כפי שמתואר בהמשך.

משאבים

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

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

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

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

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

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

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

מה השלב הבא?