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