Elevation

‫ElevationService class

google.maps.ElevationService class

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

אפשר להתקשר אל const {ElevationService} = await google.maps.importLibrary("elevation") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

יצרן
ElevationService	ElevationService() פרמטרים:  אין יוצרת מופע חדש של ElevationService ששולח שאילתות לגבי גובה לשרתים של Google.

Methods
getElevationAlongPath	getElevationAlongPath(request[, callback]) פרמטרים:  request:  PathElevationRequest callback:  function(Array<ElevationResult> optional, ElevationStatus): void optional ערך מוחזר:  Promise<PathElevationResponse> שולחת בקשה לגובה לאורך נתיב, שבה נתוני הגובה מוחזרים כדגימות מבוססות-מרחק לאורך הנתיב.
getElevationForLocations	getElevationForLocations(request[, callback]) פרמטרים:  request:  LocationElevationRequest callback:  function(Array<ElevationResult> optional, ElevationStatus): void optional ערך מוחזר:  Promise<LocationElevationResponse> שליחת בקשה לגובה של רשימת מיקומים נפרדים.

‫LocationElevationRequest interface

google.maps.LocationElevationRequest ממשק

בקשת העלאה שנשלחה על ידי ElevationService ומכילה את רשימת הקואורדינטות הנפרדות (LatLng) שעבורן צריך להחזיר נתוני גובה.

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

‫LocationElevationResponse interface

google.maps.LocationElevationResponse ממשק

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

מאפיינים
results	סוג:  Array<ElevationResult> רשימת 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	סוג:  Array<ElevationResult> רשימת 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.

Constants
INVALID_REQUEST	הבקשה לא תקינה.
OK	לא היו שגיאות בבקשה.
OVER_QUERY_LIMIT	הדף חרג ממגבלת הבקשות בפרק זמן קצר מדי.
REQUEST_DENIED	לדף האינטרנט אין הרשאה להשתמש בשירות הגובה.
UNKNOWN_ERROR	לא ניתן היה לעבד את בקשת הגובה, אבל הסיבה המדויקת לכישלון לא ידועה.