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