טיפול בשגיאות

מפתחים באזור הכלכלי האירופי (EEA)

אחרי ששולחים בקשה, יכול להיות שתקבלו תשובה עם פרטים על שגיאה.

משבצות דו-ממדיות ותמונות Street View

ברשימה הבאה מפורטות השגיאות שבהן יכול להיות שתיתקלו כשמשתמשים ב-2D Tiles ובתמונות Street View.

רשימת שגיאות

ברשימה הבאה מפורטות השגיאות שיכולות להופיע כשמשתמשים ב-Map Tiles API.

required

בבקשה שלך חסר פרמטר של כתובת URL. שימו לב שהודעת השגיאה מציינת

notFound, invalid

הערכים של x,‏ y או z הם מחוץ לטווח.

במשבצות מפה רגילות, רמת הזום המקסימלית תלויה במשבצת המפה הספציפית ובאפשרויות המפה שביקשתם.
במשבצות מפה רגילות, קואורדינטת ה-x צריכה להיות בטווח [0, (2^zoom)-1].
בקטעי מפה רגילים, קואורדינטת ה-y צריכה להיות בטווח [0, (2^(zoom-1))-1].
במקרה של Street View Tiles, רמת הזום צריכה להיות בין אפס לחמש, כולל.
באריחי Street View, טווחי הקואורדינטות x ו-y זהים לאלה של אריחי מפה רגילים, עד לזום ברמה חמש. בשלב הזה, הערכים המקסימליים הם imageHeight או imagewidth חלקי tileHeight או tileWidth.

forbidden:

סיבות אפשריות:

בבקשה חסר מפתח API תקין.
הודעה: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

משבצות לוויין דו-ממדיות לא זמינות בפרויקטים שמקושרים לחשבון לחיוב עם כתובת באזור הכלכלי האירופי (EEA). מידע נוסף זמין במאמר בנושא התאמות ב-Map Tiles API ללקוחות באזור הכלכלי האירופי.

expired

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

badRequest

הבקשה שלך הייתה בעלת מבנה פגום. בין הסיבות הנפוצות לכך:

ציינת סוג מפה terrain בלי לכלול שכבת roadmap.
הוספתם מערך styles לסוג מפה שאינו מפת דרכים.
שלחת ערך של קו רוחב/קו אורך, וגם מזהה פנורמה בבקשה של מטא-נתונים של Street View.

quotaExceeded, rateLimitExceeded

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

דוגמה לשגיאה

{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "errors": [
      {
        "message": "The request is missing a valid API key.",
        "domain": "global",
        "reason": "forbidden"
      }
    ],
    "status": "PERMISSION_DENIED"
  }
}

ניסיון חוזר של בקשות

אם הבקשות נכשלות עם קודי השגיאה quotaExceeded ו-rateLimitExceeded, צריך לנסות לשלוח שוב את הבקשה באופן שלא יגרום להצפת השרתים של Google בבקשות פגומות או בכשלים נרחבים – כי לקוחות רבים מנסים לשלוח שוב בקשות ברצף מהיר. כלומר, צריך להשתמש בהשהיה מעריכית לפני ניסיון חוזר כשמנסים לשלוח שוב את הבקשות. השהיה מעריכית לפני ניסיון חוזר (exponential backoff) מאלצת אתכם לפזר את הבקשות לאורך זמן, כדי לתת לשרת זמן להתאושש.

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

3D Tiles

יכול להיות שלא תבחינו בשגיאות מהשרת של Google כי אתם ניגשים למשבצות פוטו-ריאליסטיות דרך רכיב עיבוד, שאחראי לטיפול בשגיאות שרת.

שגיאות ברינדור של משבצות

לדוגמה, בדרך כלל, רכיב ה-renderer של CesiumJS נכשל בשקט כשמתרחשות שגיאות בשרת, מה שעלול לגרום לקריסות, למסכים ריקים או לטעינה של משבצות ספציפיות.

הטכניקה שבה משתמשים כדי לנפות באגים בשגיאות שרת תלויה במעבד התצוגה הספציפי שבו משתמשים. במעבדי רינדור מבוססי-דפדפן כמו CesiumJS, אפשר לבדוק את תעבורת הרשת באמצעות כלים מובנים ברוב הדפדפנים. לדוגמה, אפשר להשתמש בכלי הפיתוח ל-Chrome.

שגיאות נפוצות

הרשימה הבאה כוללת פרטים על השגיאות הנפוצות ביותר שבהן אתם עשויים להיתקל.

‫400: ארגומנט לא תקין: מפתחות API, פרמטרים של שאילתות, מזהים של משבצות או של ערכות משבצות לא תקינים, או טוקן של סשן שפג תוקפו.
‫400: ערך לא חוקי: חשוב לוודא ש-mapType שבו נעשה שימוש בבקשת createSessionToken תואם ל-mapType שבו נעשה שימוש בנקודת הקצה של המשבצת הבאה. לדוגמה, אי אפשר להשתמש באסימון סשן של streetview כדי לבקש משבצת של roadmap.

‎403: Permission denied