בדף הזה מתוארות הודעות השגיאה שה-API של מפות Google יכול להחזיר. כשמתרחשת שגיאה, ה-API של מפות Google מוטמע מציג טקסט של הודעת שגיאה במקום המפה. ייתכן שיוצגו גם תנאי שגיאה מסוימים, וכתוצאה מכך תופיע מפה עם סימן מים כהה.
בקשות לא חוקיות
במקרה של בקשה לא חוקית, Maps Embed API יחזיר קוד סטטוס HTTP 4xx והודעה שמתארת את הבעיה. בהמשך מפורטות דוגמאות לתנאי שגיאה כאלה. הערה: זוהי רשימה חלקית של השגיאות האפשריות. לפרטים על בעיות ספציפיות, יש לבדוק את קוד השגיאה
ואת ההודעה שהוחזרה על ידי ה-API.
| דוגמה למצב שגיאה | קוד סטטוס |
|---|---|
הבקשה כוללת פרמטר לא חוקי, או שחסר פרמטר נדרש. לדוגמה, הפרמטר zoom לא נמצא בטווח הצפוי של הערכים המספריים, או שחסר פרמטר נדרש
בבקשה. |
400 BAD REQUEST |
| מפתח ה-API שנכלל בבקשה לא תקין. | 403 FORBIDDEN |
שגיאות במפתח API וב-QPS
שגיאות של מפתח API ו-QPS יטופלו כבקשות לא חוקיות. הסיבות האפשריות לכך הן:
- מפתח API חסר או לא חוקי. כדי לפתור את השגיאה הזו, צריך לוודא שהבקשה כוללת מפתח API תקין. קבלת מפתח API.
- ממשק ה-API של מפות Google לא מופעל עבור הפרויקט. מידע נוסף על הפעלה והשבתה של ממשקי API
- מפתח ה-API כולל הפרת הגבלה. מידע נוסף על השיטות המומלצות לשימוש במפתח API
שגיאות בהפניות של חיוב ו-HTTP
מפה חשוכה, או תמונת Street View "שלילית", עם סימן מים של ה-Wi-Fi"למטרות פיתוח בלבד", מוחזרת כאשר מתקיים אחד מהתנאים הבאים:
- החיוב לא הופעל בחשבון שלך. מפעילים את החיוב.
- אמצעי החיוב שסיפקת לא חוקי (לדוגמה, כרטיס אשראי שפג תוקפו). כדי לפתור את הבעיה, צריך להיכנס למסוף Google Cloud ולוודא שסיפקת אמצעי תשלום תקף.
- חרגת מהמגבלה היומית שהגדרת בעצמך. איך להציג או לשנות את המגבלות היומיות לחיוב.
- בבקשה חסר גורם מפנה של HTTP, ואתם משתמשים במפתח API שמוגבל לגורם מפנה. מידע נוסף על הוספת גורמים מפנים
בדיקת שגיאות בדפדפן
במקרה של שגיאות בהפניות חיוב ובהפניות HTTP, API של מפות Google כותב הודעות שגיאה ב-window.console. בבקשות לא חוקיות (כולל שגיאות של מפתח API ושגיאות QPS), רק קוד הסטטוס 4xx של HTTP מדווח במסוף. בקטע הזה נסביר איך בודקים את פלט המסוף ב-Google Chrome. אם אתם משתמשים בדפדפנים אחרים, עיינו במסמכי התיעוד למפתחים של הדפדפן. לעיונך, זו רשימה של כלים לבדיקת הפלט של המסוף בדפדפנים מסוימים.
- Console של Internet Explorer.
- מסוף האינטרנט עבור Firefox.
- ניפוי באגים מרחוק ב-Android.
- Web Inspector (סוקר האינטרנט) ל-iOS.
ב-Chrome, תוכלו להשתמש ב-JavaScript Console כדי לבדוק את הפלט של המסוף באופן הבא.
- כדי לפתוח את הכלים למפתחים, לוחצים על סמל התפריט > כלים נוספים > כלים למפתחים.
- כדי לפתוח את JavaScript Console, לוחצים על הכרטיסייה Console בחלק העליון של החלון 'כלים למפתחים'. אפשר גם להשתמש במקש Esc כדי להפעיל או להשבית את לוח JavaScript.