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

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

.

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

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

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

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

איך פועל Geolocation API

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

מקורות מידע

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

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

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

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

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

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

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

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