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

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

מפתחים באזור הכלכלי האירופי (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

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

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

3D Tiles

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

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

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

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

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

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

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

403: Permission denied