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

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

למה כדאי להשתמש ב-API של מיקום גיאוגרפי

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

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

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

איך פועל ה-API של המיקום הגיאוגרפי

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

משאבים

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

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

איך משתמשים ב-API של מיקום גיאוגרפי

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

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

יש לקרוא לממשק ה-API הזה בשפה שנבחרה דרך אחת מספריות הלקוח הבאות:

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

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