התחל בעבודה

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

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>

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

ספריות הלקוח מאפשרות לפתח בקלות באמצעות ממשקי ה-API של שירותי האינטרנט של מפות Google, על ידי מתן הטמעות פשוטות ונפוצות של משימות נפוצות, כמו אימות, הגבלת בקשות וניסיון חוזר אוטומטי. Elevation API זמין בלקוח Java, בלקוח Python, בלקוח Go ובלקוח Node.js לשירותי מפות Google.

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

אימות

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

מכסות ותמחור

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

מדיניות

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

מידע נוסף

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

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