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

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

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

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

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

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

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

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