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

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

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

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

ברשימה הבאה מפורטות השגיאות שאתם עשויים להיתקל בהן כשאתם משתמשים באריחים דו-ממדיים ובתמונות 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, רמת הזום צריכה להיות בין אפס לחמש, כולל.

  • במשבצות ב-Street View, טווחי הקואורדינטות x ו-y זהים לאלה של משבצות מפה רגילות, עד לרמת זום 5. בשלב הזה, הערכים המקסימליים הם 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

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

שגיאה לדוגמה

{
  "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) כשמנסים לשלוח שוב את הבקשות. השהיה מעריכית לפני ניסיון חוזר (exponential backoff) מאלצת אתכם לפרוס את הבקשות לאורך זמן, כדי לתת לשרת זמן להתאושש.

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

משבצות תלת-ממדיות

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

שגיאות בעיבוד משבצות

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

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

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

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

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

‫403: Permission denied

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

  • חסר מפתח API, חסר חיבור SSL או שמפתח ה-API לא נוסף לרשימת ההיתרים של 3D Tiles. כדי להוסיף את מזהה הפרויקט לרשימת ההיתרים של פונקציונליות האריחים התלת-ממדיים ב-Map Tiles API, פנו לתמיכה של Google.

  • הודעה: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

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

‫429: יותר מדי בקשות
מיציתם את המכסה. כדי להגדיל את המכסה, פנו לתמיכה של Google.