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

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

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

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

מה ניתן לעשות באמצעות Elevation API

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

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

איך פועל Elevation API

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

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