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

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

למה להשתמש ב-liftion API

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

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

באמצעות ממשק ה-API של גובה הגבהים, ניתן לכלול נתוני גובה או במפה. לדוגמה:

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

איך פועל Layerion API

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

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

משאבים

הטבלה הבאה מסכמת את המשאבים הזמינים באמצעות ממשק API של liftion עם הנתונים שהוא מחזיר.

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

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

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

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

איך להשתמש ב-liftion API

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

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

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

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

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