מתחילים

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

השירות הזה זמין גם כחלק מ-Maps JavaScript API בצד הלקוח, או לשימוש בצד השרת עם Java Client,‏ Python Client, ‏ Go Client ו-Node.js Client for Google Maps Services.

דוגמה לבקשה ולתשובה

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

בדוגמה הבאה מוצגת בקשה לקבלת הגובה של דנוור, קולורדו, 'העיר בגובה מייל', בפורמט 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'

כדי לבדוק את זה, מזינים את כתובת האתר בדפדפן האינטרנט (חשוב להחליף את 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>
</pre>

מתחילים לתכנת באמצעות ספריות הלקוח שלנו

ספריות לקוח מקלות על פיתוח באמצעות ממשקי Google Maps web service API, כי הן מספקות הטמעות מובנות של משימות נפוצות, כמו אימות, הגבלת קצב הבקשות וניסיון חוזר אוטומטי. ‫Elevation API זמין בJava Client,‏ Python Client, ‏ Go Client ו-Node.js Client for Google Maps Services.

אימות, מכסות, תמחור ומדיניות

אימות

כדי להשתמש ב-Elevation API, קודם צריך להפעיל את ה-API ולקבל את פרטי האימות המתאימים. מידע נוסף מופיע במאמר תחילת העבודה עם Google Maps Platform.

מכסות ותמחור

פרטים על המכסות והתמחור של Elevation API מופיעים בדף שימוש וחיוב.

מדיניות

השימוש ב-Elevation API חייב להיות בהתאם למדיניות ה-API.

מידע נוסף

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

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