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

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

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

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

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

קטעי מפה תלת-ממדיים

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

שגיאות ברינדור האריחים

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

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

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

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

400: ארגומנט לא תקין

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

403: Permission denied

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

429: Too many requests

המכסה שלכם נוצלה. כדי להגדיל את המכסה, פונים אל התמיכה של Google.