מתחילים

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

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

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

כדי לגשת ל-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, לקוח Python, לקוח Go ולקוח Node.js לשירותי הפלטפורמה של מפות Google.

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

אימות

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

מכסות ותמחור

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

מדיניות

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

מידע נוסף

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

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