Elevation

סיווג של ElevationService

google.maps.ElevationService סיווג

להגדרת סיווג שירות שפונה ישירות לשרתי Google לצורך בקשת נתוני גובה.

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

יצרן
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"). ראה ספריות ב-Maps JavaScript API.

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