ממשק ה-API של גובה הגבהים מספק נתוני גובה לכל המיקומים פני כדור הארץ, כולל מיקומי עומק בקרקעית האוקיינוס מחזירה ערכים שליליים).
השירות הזה זמין גם כחלק מהצד הלקוח Maps JavaScript API, או לשימוש בצד השרת עם לקוח Java, לקוח Python, לקוח Go ולקוח Node.js לשירותי מפות Google.
בקשה ותגובה לדוגמה
ניתן לגשת ל-liftion API דרך ממשק HTTP, עם בקשות שנוצרו כמחרוזת של כתובת אתר, המשתמשות בקואורדינטות של קו אורך/רוחב לזהות את המיקומים או את קודקודי הנתיב. הבקשות חייבות לכלול את מפתח ה-API שלכם.
הדוגמה הבאה מבקשת את הגובה של דנבר, קולורדו, "Mile High City", בפורמט JSON:
כתובת URL
https://maps.googleapis.com/maps/api/elevation/json ?locations=39.7391536%2C-104.9847034 &key=YOUR_API_KEY
cURL
curl -L -X GET 'https://maps.googleapis.com/maps/api/elevation/json?locations=39.7391536%2C-104.9847034&key=YOUR_API_KEY'
כדי לבדוק זאת, צריך להזין את כתובת ה-URL בדפדפן האינטרנט (חשוב להחליף את הכתובת
YOUR_API_KEY
במפתח ה-API שלכם בפועל).
התגובה כוללת את הגובה בנקודה זו, במטרים, יחד עם
את ערך הרזולוציה (המרחק המקסימלי בין נקודות נתונים שממנה
בוצע אינטרפולציה לגובה במטרים.
כדאי לעיין במדריך למפתחים אפשר למצוא מידע נוסף על כתובות URL של בקשות לבנייה ופרמטרים זמינים ו- הבנת התשובה.
בהמשך מוצגת תגובה לדוגמה:
JSON
{ "results": [ { "elevation": 1608.637939453125, "location": { "lat": 39.7391536, "lng": -104.9847034 }, "resolution": 4.771975994110107, }, ], "status": "OK", }
XML
<ElevationResponse> <status>OK</status> <result> <location> <lat>39.7391536</lat> <lng>-104.9847034</lng> </location> <elevation>1608.6379395</elevation> <resolution>4.7719760</resolution> </result> </ElevationResponse>
מתחילים לתכנת באמצעות ספריות הלקוח שלנו
ספריות לקוח הופכות להתפתח עם ממשקי ה-API של שירות האינטרנט של מפות Google בקלות רבה יותר, באמצעות הטמעות נייטיב של משימות נפוצות, כמו אימות, בקשות ויסות נתונים (throttle) וניסיונות חוזרים באופן אוטומטי. ה-liftion API זמין ב לקוח Java, לקוח Python, Go Client ו-Node.js של שירותי מפות Google.
אימות, מכסות, תמחור ומדיניות
אימות
כדי להשתמש ב-liftion API, קודם עליך להפעיל את ה-API ולקבל את פרטי כניסה לאימות. מידע נוסף זמין במאמר הבא: תחילת העבודה עם הפלטפורמה של מפות Google.
מכסות ותמחור
בדיקת השימוש והחיוב לקבלת פרטים על המכסות והתמחור שהוגדרו ל-Height API.
מדיניות
השימוש ב-liftion API חייב להיות בהתאם המדיניות בנושא API.
מידע נוסף
יש עוד דברים שאפשר לעשות בעזרת liftion API, כמו בקשת נתוני גובה מכמה מיקומים. המדריך למפתחים של liftion API למידע נוסף ודוגמאות ופרטים נוספים.
המדריך למפתחים של liftion API מפתחים לנייד שמעוניינים להשתמש בנתוני גובה במפות Google, ממשקי API של הפלטפורמה של מפות Google. הוא מספק מבוא לשימוש ב-API והפניות מהותי לפרמטרים הזמינים.