Elevation

הכיתה ElevationService

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

ממשק google.maps.LocationElevationRequest

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

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

הממשק LocationElevationResponse

ממשק google.maps.LocationElevationResponse

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

מאפיינים
results	סוג:  Array<ElevationResult> רשימת ה-ElevationResult שתואמים למיקומים של ה-LocationElevationRequest.

ממשק PathElevationRequest

ממשק google.maps.PathElevationRequest

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

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

הממשק PathElevationResponse

ממשק google.maps.PathElevationResponse

תגובה לגובה שמוחזרת על ידי ה-ElevationService ומכילה את רשימת ה-ElevationResult שמרווחים באופן שווה לאורך הנתיב של ה-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 קבועים

הסטטוס שהוחזר על ידי 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	לא ניתן היה לעבד את בקשת ההעלאה לרמה גבוהה יותר, אבל הסיבה המדויקת לכישלון לא ידועה.