שנתחיל?

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

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

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

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

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