Elevation

המחלקה ElevationService

google.maps.ElevationService ספריית
הכיתה "elevation"

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

const {ElevationService} = await google.maps.importLibrary("elevation");

יצרן
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 אופציונלי	סוג: 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 אופציונלי	סוג: 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 אופציונלי	סוג: LatLng optional המיקום של תוצאת הגובה הזו.

ערכי ElevationStatus קבועים

google.maps.ElevationStatus קבועים
ספרייה "elevation"

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

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג ElevationStatusString.

const {ElevationStatus} = await google.maps.importLibrary("elevation");

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