מתחילים

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

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

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

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

ניתן לגשת ל-liftion API דרך ממשק HTTP, עם בקשות שנוצרו כמחרוזת של כתובת אתר, המשתמשות בקואורדינטות של קו אורך/רוחב לזהות את המיקומים או את קודקודי הנתיב. הבקשות חייבות לכלול את מפתח ה-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 בקלות רבה יותר, באמצעות הטמעות נייטיב של משימות נפוצות, כמו אימות, בקשות ויסות נתונים (throttle) וניסיונות חוזרים באופן אוטומטי. ה-liftion API זמין ב לקוח Java, לקוח Python, Go Client ו-Node.js של שירותי מפות Google.

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

אימות

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

מכסות ותמחור

בדיקת השימוש והחיוב לקבלת פרטים על המכסות והתמחור שהוגדרו ל-Height API.

מדיניות

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

מידע נוסף

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

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