הצטרפו אלינו לאירוע הבא של Google Maps Platform Developer Community Day בסן פרנסיסקו בדצמבר. להגשת בקשה להשתתפות.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

מפתחים באזור הכלכלי האירופי (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). החלופות הנתמכות כוללות את Maps JavaScript API, את SDK של מפות ל-Android או את SDK של מפות ל-iOS. מידע נוסף זמין במאמר התאמות ב-Map Tiles API ללקוחות באזור הכלכלי האירופי (EEA).

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