Errors

המחלקה MapsNetworkError

class google.maps.MapsNetworkError extends Error
extended by MapsRequestError, MapsServerError
library "core"

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

const {MapsNetworkError} = await google.maps.importLibrary("core");
code
מזהה את סוג השגיאה שנוצרה על ידי ה-API.
endpoint
מייצג את שירות הרשת שהחזיר את השגיאה.

המחלקה MapsRequestError

class google.maps.MapsRequestError extends MapsNetworkError, Error
library "core"

מייצג שגיאת בקשה משירות אינטרנט (כלומר, המקבילה של קוד 4xx ב-HTTP).

const {MapsRequestError} = await google.maps.importLibrary("core");
בירושה: code, endpoint

המחלקה MapsServerError

class google.maps.MapsServerError extends MapsNetworkError, Error
library "core"

מייצג שגיאה בצד השרת משירות אינטרנט (כלומר, המקבילה של קוד 5xx ב-HTTP).

const {MapsServerError} = await google.maps.importLibrary("core");
בירושה: code, endpoint

קבועים של MapsNetworkErrorEndpoint

constants google.maps.MapsNetworkErrorEndpoint
ספרייה "core"

מזהים של נקודות קצה ל-API שמשמשות מכונות של MapsNetworkError.

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

const {MapsNetworkErrorEndpoint} = await google.maps.importLibrary("core");
DIRECTIONS_ROUTE מזהה את Routes API ב-Directions API.
DISTANCE_MATRIX מזהה את DistanceMatrix API.
ELEVATION_ALONG_PATH מזהה את getElevationsAlongPath API ב-Elevation API.
ELEVATION_LOCATIONS מזהה את ה-API‏ getElevationForLocations ב-Elevation API.
FLEET_ENGINE_GET_DELIVERY_VEHICLE מזהה את Get DeliveryVehicle API ב-Fleet Engine.
FLEET_ENGINE_GET_TRIP מזהה את Get Trip API ב-Fleet Engine.
FLEET_ENGINE_GET_VEHICLE מזהה את Get Vehicle API ב-Fleet Engine.
FLEET_ENGINE_LIST_DELIVERY_VEHICLES מזהה את List DeliveryVehicles API ב-Fleet Engine.
FLEET_ENGINE_LIST_TASKS מזהה את List Tasks API ב-Fleet Engine.
FLEET_ENGINE_LIST_VEHICLES מזהה את List Vehicles API ב-Fleet Engine.
FLEET_ENGINE_SEARCH_TASKS מזהה את Search Tasks API ב-Fleet Engine.
GEOCODER_GEOCODE מזהה את ה-Geocoding API בכלי להמרת כתובות לקואורדינטות (geocoder).
MAPS_MAX_ZOOM מזהה את MaximumZoomImageryService API ב-Maps API.
PLACES_AUTOCOMPLETE מזהה את Autocomplete API ב-Places API.
PLACES_DETAILS מזהה את Details API ב-Places API.
PLACES_FIND_PLACE_FROM_PHONE_NUMBER מזהה את findPlaceFromPhoneNumber API ב-Places API.
PLACES_FIND_PLACE_FROM_QUERY מזהה את findPlaceFromQuery API ב-Places API.
PLACES_GATEWAY מזהה את Gateway API ב-Places API.
PLACES_GET_PLACE מזהה את Get Place API ב-Places API.
PLACES_SEARCH_TEXT מזהה את Search Text API ב-Places API.
STREETVIEW_GET_PANORAMA מזהה את השיטה getPanorama בשירות Street View.

ערכי RPCStatus קבועים

constants google.maps.RPCStatus
ספרייה "core"

הסטטוס שמוחזר על ידי שירות אינטרנט. אפשר לקרוא מידע נוסף בכתובת https://grpc.github.io/grpc/core/md_doc_statuscodes.html.

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

const {RPCStatus} = await google.maps.importLibrary("core");
ABORTED הפעולה בוטלה, בדרך כלל בגלל בעיה בו-זמנית כמו כשל בבדיקת רצף או ביטול עסקה.
ALREADY_EXISTS הישות שהלקוח ניסה ליצור (למשל, קובץ או ספרייה) כבר קיימת.
CANCELLED הפעולה בוטלה, בדרך כלל על ידי מבצע הקריאה.
DATA_LOSS אובדן נתונים או פגיעה בנתונים שלא ניתן לשחזר.
DEADLINE_EXCEEDED המועד האחרון חלף לפני שהפעולה הסתיימה. בפעולות שמשנות את מצב המערכת, יכול להיות שהשגיאה הזו תוחזר גם אם הפעולה הושלמה בהצלחה. לדוגמה, יכול להיות שהתגובה המוצלחת מהשרת התעכבה הרבה זמן.
FAILED_PRECONDITION הפעולה נדחתה כי המערכת לא במצב שנדרש לביצוע הפעולה.
INTERNAL שגיאות פנימיות. המשמעות היא שחלק מהקבועים שהמערכת הבסיסית מצפה להם הופרו. קוד השגיאה הזה שמור לשגיאות חמורות.
INVALID_ARGUMENT הלקוח ציין ארגומנט לא תקין. חשוב לשים לב שהמאפיין הזה שונה מ-FAILED_PRECONDITION. הערך INVALID_ARGUMENT מציין ארגומנטים בעייתיים, בלי קשר למצב המערכת (למשל, שם קובץ בפורמט שגוי).
NOT_FOUND ישות מבוקשת כלשהי (למשל, קובץ או ספרייה) לא נמצאה.
OK לא שגיאה, מוחזרת כשהפעולה מצליחה.
OUT_OF_RANGE הפעולה בוצעה מחוץ לטווח התקין. למשל, חיפוש או קריאה מעבר לסוף הקובץ. בניגוד ל-INVALID_ARGUMENT, השגיאה הזו מצביעה על בעיה שאפשר לפתור אם מצב המערכת משתנה. לדוגמה, מערכת קבצים של 32 ביט תיצור את INVALID_ARGUMENT אם תתבקש לקרוא בהיסט שלא נמצא בטווח [0,2^32-1], אבל היא תיצור את OUT_OF_RANGE אם תתבקש לקרוא מהיסט שעובר את גודל הקובץ הנוכחי.
PERMISSION_DENIED למבצע הקריאה אין הרשאה לבצע את הפעולה שצוינה. קוד השגיאה הזה לא מציין שהבקשה תקינה או שהישות המבוקשת קיימת או עומדת בתנאים מוקדמים אחרים.
RESOURCE_EXHAUSTED משאב כלשהו מוצה, אולי מכסה לכל משתמש, או אולי נגמר המקום במערכת הקבצים כולה.
UNAUTHENTICATED בבקשה אין פרטי כניסה תקפים לאימות הפעולה.
UNAVAILABLE השירות הזה לא זמין כרגע. סביר להניח שמדובר במצב זמני, שאפשר לתקן על ידי ניסיון חוזר עם השהיה. חשוב לזכור שלא תמיד בטוח לנסות שוב פעולות שהן לא אידמפוטנטיות.
UNIMPLEMENTED הפעולה לא מוטמעת או לא נתמכת/מופעלת בשירות הזה.
UNKNOWN שגיאה לא ידועה. לדוגמה, השגיאה הזו עשויה לחזור כשסטטוס שהתקבל ממרחב כתובות אחר שייך למרחב שגיאות שלא מוכר במרחב הכתובות הזה. גם שגיאות שנוצרות על ידי ממשקי API שלא מחזירים מספיק מידע על השגיאה עשויות להפוך לשגיאה הזו.