Elevation

‫ElevationService class

google.maps.ElevationService class

הגדרת מחלקת שירות שמתקשרת ישירות עם שרתי Google כדי לבקש נתוני גובה.

אפשר להתקשר אל const {ElevationService} = await google.maps.importLibrary("elevation") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
ElevationService
ElevationService()
פרמטרים:  אין
יוצרת מופע חדש של ElevationService ששולח שאילתות לגבי גובה לשרתים של Google.
getElevationAlongPath
getElevationAlongPath(request[, callback])
פרמטרים: 
ערך מוחזר:  Promise<PathElevationResponse>
שולחת בקשה לגובה לאורך נתיב, שבה נתוני הגובה מוחזרים כדגימות מבוססות-מרחק לאורך הנתיב.
getElevationForLocations
getElevationForLocations(request[, callback])
פרמטרים: 
ערך מוחזר:  Promise<LocationElevationResponse>
שליחת בקשה לגובה של רשימת מיקומים נפרדים.

‫LocationElevationRequest interface

google.maps.LocationElevationRequest ממשק

בקשת העלאה שנשלחה על ידי ElevationService ומכילה את רשימת הקואורדינטות הנפרדות (LatLng) שעבורן צריך להחזיר נתוני גובה.
locations optional
סוג:  Array<LatLng|LatLngLiteral> optional
המיקומים הנפרדים שעבורם רוצים לאחזר נתוני גובה.

‫LocationElevationResponse interface

google.maps.LocationElevationResponse ממשק

תגובה של נתוני גובה שמוחזרת על ידי ElevationService ומכילה את רשימת ElevationResult שתואמים למיקומים של LocationElevationRequest.
results
רשימת ElevationResults שתואמים למיקומים של LocationElevationRequest.

ממשק PathElevationRequest

google.maps.PathElevationRequest ממשק

שאילתת גובה שנשלחת על ידי ElevationService ומכילה את הנתיב שבו יוחזרו נתונים לדוגמה. הבקשה הזו מגדירה נתיב רציף לאורך כדור הארץ, שבו צריך לקחת דגימות של גובה במרחקים שווים. כל הנתיבים מקודקוד לקודקוד משתמשים בקטעים של המעגל הגדול בין שתי הנקודות האלה.
samples
סוג:  number
חובה. מספר הנקודות במרחקים שווים לאורך הנתיב הנתון, שנתוני הגובה שלהן יאוחזרו, כולל נקודות הקצה. מספר הדגימות חייב להיות ערך בין 2 ל-512 כולל.
path optional
סוג:  Array<LatLng|LatLngLiteral> optional
הנתיב לאורך הדרך לאיסוף ערכי הגובה.

‫PathElevationResponse interface

google.maps.PathElevationResponse ממשק

תגובה של נתוני גובה שמוחזרת על ידי ElevationService ומכילה את רשימת ElevationResults במרווחים שווים לאורך הנתיב של PathElevationRequest.
results
רשימת ElevationResults שתואמים לדוגמאות של PathElevationRequest.

‫ElevationResult ממשק

google.maps.ElevationResult ממשק

התוצאה של בקשת ElevationService, שכוללת את קבוצת הקואורדינטות של הגובה ואת ערכי הגובה שלהן. הערה: בקשה אחת יכולה להפיק כמה תגי ElevationResult.
elevation
סוג:  number
הגובה של הנקודה הזו בכדור הארץ, במטרים מעל פני הים.
resolution
סוג:  number
המרחק במטרים בין נקודות הדגימה שמהן חושב הגובה. אם הרזולוציה לא ידועה, המאפיין הזה לא יופיע. שימו לב: נתוני הגובה הופכים גסים יותר (ערכי resolution גדולים יותר) כשמעבירים כמה נקודות. כדי לקבל את ערך הגובה הכי מדויק של נקודה מסוימת, צריך לשלוח שאילתה לגביה בנפרד.
location optional
סוג:  LatLng optional
המיקום של תוצאת הגובה הזו.

ElevationStatus קבועים

google.maps.ElevationStatus constants

הסטטוס שמוחזר על ידי ElevationService לאחר השלמת בקשת הרשאה. אפשר לציין אותם לפי ערך או באמצעות שם הקבוע. לדוגמה, 'OK' או google.maps.ElevationStatus.OK.

אפשר להתקשר אל const {ElevationStatus} = await google.maps.importLibrary("elevation") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
INVALID_REQUEST הבקשה לא תקינה.
OK לא היו שגיאות בבקשה.
OVER_QUERY_LIMIT הדף חרג ממגבלת הבקשות בפרק זמן קצר מדי.
REQUEST_DENIED לדף האינטרנט אין הרשאה להשתמש בשירות הגובה.
UNKNOWN_ERROR לא ניתן היה לעבד את בקשת הגובה, אבל הסיבה המדויקת לכישלון לא ידועה.