Elevation

שיעור ElevationService

מחלקה google.maps.ElevationService

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

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

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

שיטות
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> רשימת ElevationResult של הדגימות של 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"). יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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