מתחילים

‫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'

כדי לבדוק את זה, מזינים את כתובת ה-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>
</pre>

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

ספריות לקוח מקלות על פיתוח באמצעות ממשקי ה-API של שירות האינטרנט של מפות Google, כי הן מספקות הטמעות מובנות של משימות נפוצות, כמו אימות, הגבלת קצב הבקשות וניסיון חוזר אוטומטי. ‫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 וחומר עזר בנושא הפרמטרים הזמינים.