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

Elevation API הוא שירות שמחזיר נתוני גובה של מיקום מסוים בכדור הארץ, או נתוני גובה שנדגמו לאורך נתיבים.

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

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

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

באמצעות Elevation API אפשר לכלול נתוני גובה באפליקציות או במפה. לדוגמה:

  • לקבל את הגובה של מקום ספציפי.
  • חישוב ההבדלים בגובה לאורך מסלול או בין שתי נקודות.

איך פועל Elevation API

ה-Elevation API מקבל בקשה ככתובת URL מקודדת עם קואורדינטות של קווי אורך ורוחב שצוינו כמיקומים נפרדים או כסדרת מיקומים לאורך נתיב. הבקשה הזו, למשל, שאילתה לגבי גובה של מרכז דנוור שבקולורדו, מציינת החזרה בפורמט JSON.
  https://maps.googleapis.com/maps/api/elevation/json
  ?locations=39.7391536%2C-104.9847034
  &key=YOUR_API_KEY

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

מקורות מידע

בטבלה הבאה מוצג סיכום של המשאבים שזמינים דרך Elevation API יחד עם הנתונים שהוא מחזיר.

משאבי נתונים הנתונים הוחזרו פורמט החזרה
קואורדינטות של קווי אורך ורוחב

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

ה-Elevation API מספק גובה במטרים ביחס לגובה פני הים הממוצע המקומי (LMSL). ניתן להחזיר נתוני גובה כערכים חיוביים או שליליים, כפי שמצוין בהמשך:

  • ערכים חיוביים מציינים מיקומים מעל ל-LMSL, כולל מיקומי פני השטח או החלק התחתון של אגמים בגובה גבוה.
  • ערכים שליליים מציינים מיקומים שנמצאים מתחת למערכת לניהול למידה (LMSL), כולל מיקומים על פני השטח או על קרקעית האוקיינוס.
  • רזולוציה מציינת את המרחק בין נקודת הנתונים לבין הגובה, במטרים.
  • JSON
  • XML

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

1 מגדירים. מתחילים בהגדרת הפרויקט ב-Google Cloud ומבצעים את הוראות ההגדרה הבאות.
2 שימוש בבקשת העלאה אחרי יצירת מפתח API אפשר להתחיל לבדוק את Elevation API ישירות מהדפדפן. לפרטים נוספים, ראו בקשות לדוגמה במדריך תחילת העבודה.
3 כתיבת בקשה מורכבת יותר אחרי שמגדירים פרויקט, כדאי לנסות בקשה שמספקת נתוני מיקום לאורך נתיב. לפרטים נוספים, אפשר לעיין בציון נתיבים .
4 הסבר בסיסי על תשובות מעיינים בתגובות לנתוני הגובה כדי להתכונן לשימוש בנתוני הגובה עבור האפליקציה. לפרטים נוספים, ניתן לעיין בקטע תגובות לגבי עלייה.
5 שילוב נתוני גובה באפליקציה שלכם! אפשר להשתמש בנתוני גובה כדי לשפר אפליקציות שמבוססות על מיקום, כמו אפליקציות לפעילויות ספורט או לנתוני סקרים.

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

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

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

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