הודעות שגיאה

רוצה לקבל עזרה מנציג שירות?
נכנסים לדף התמיכה של Google Maps Platform.
הדף הזה של הודעות השגיאה הוא לעיון בלבד. המאמר הזה נועד לעזור לכם לפתור בעיות שקשורות ל-Maps JavaScript API בעצמכם. אם תנסו לבקש עזרה מאדם אמיתי על ידי שליחת משוב דרך הדף הזה, לא תגיעו לאף אחד שיוכל לעזור. עם זאת, אם נתקלת בבעיה בתוכן שמופיע בדף הזה, אפשר להודיע לנו על כך באמצעות הקישור לשליחת משוב. תודה!

בדף הזה מתוארות הודעות השגיאה שיכולות להיות מוחזרות על ידי Maps JavaScript API. ‫Maps JavaScript API כותב הודעות שגיאה ואזהרה ללוח JavaScript. יכולות להיות גם שגיאות מסוימות שיגרמו להצגת מפה מושחרת עם סימן מים.

אם אתם לא הבעלים של האתר, אין שום דבר שאתם יכולים לעשות כדי לתקן את השגיאות האלה. עם זאת, מומלץ להודיע לבעלי האתר, אם אפשר.

מפתח API ושגיאות בחיוב

פתרון בעיות

בנסיבות מסוימות, יכול להיות שתוצג מפה מושחרת או תמונת Street View 'שלילית' עם סימן מים של הטקסט 'למטרות פיתוח בלבד'. בדרך כלל, התנהגות כזו מצביעה על בעיות במפתח API או בחיוב. כדי להשתמש במוצרים של Google Maps Platform, החיוב צריך להיות מופעל בחשבון, וכל הבקשות צריכות לכלול מפתח API תקין. לקבלת עזרה באיתור הודעות שגיאה, אפשר לעיין בקטע בנושא בדיקת שגיאות בדפדפן.

התהליך הבא יעזור לכם לפתור את הבעיה.

האם אתם משתמשים במפתח API?

לא זכור לי. איך אפשר לבדוק אם משתמשים במפתח API?

מפתח API מועבר כפרמטר key בכתובת ה-URL שמשמשת לטעינת Maps JavaScript API. ריכזנו כאן כמה אפשרויות לבדיקה אם אתם משתמשים במפתח API:

• משתמשים בתוסף Google Maps Platform API Checker ל-Chrome. כך תוכלו לוודא שהאתר שלכם מטמיע בצורה נכונה את ממשקי Google Maps API ברישיון.
• אם אתם משתמשים בספרייה או בפלאגין כדי לטעון את Maps JavaScript API, בדקו את ההגדרות של הספרייה וחפשו אפשרות למפתח API.
• בודקים אם יש שגיאות בדפדפן. אם אתם רואים את ההודעות הבאות, סימן שלא השתמשתם במפתח ה-API בצורה נכונה:
• אזהרה מ-Google Maps JavaScript API: NoApiKeys
• שגיאה ב-Google Maps JavaScript API: MissingKeyMapError

למפתחי אתרים:

• אם יש לכם גישה לקוד המקור של האפליקציה, חפשו את התג <script> שמשמש לטעינת Maps JavaScript API. כשמטעינים את Maps JavaScript API, מחליפים את YOUR_API_KEY בקוד שלמטה במפתח ה-API.

    <script async defer
      src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
    </script>

• בודקים את תנועת הרשת שנוצרת על ידי האתר בדפדפן. ב-Chrome, אפשר לראות את זה בכרטיסייה Network בDevTools. כאן יופיעו בקשות הרשת שהאתר שלכם שולח. בקשות שמתבצעות באמצעות Maps JavaScript API יהיו בנתיב maps/api/js. כאן אפשר לבדוק אם הבקשות משתמשות בפרמטר key. יכול להיות שיהיה לכם שימושי לסנן את תנועת הנתונים ברשת לפי maps/api/js כשאתם צופים בכרטיסייה Network.

לא נעשה שימוש במפתח API.

כדי לקבל מפתח API, לוחצים על הלחצן שלמטה. אם לא מוצגת הגדרה מודרכת, פועלים לפי ההוראות המלאות במאמר תחילת העבודה עם הפלטפורמה של מפות Google.
קדימה, מתחילים

כן, נעשה שימוש במפתח API.

מצוין! נעבור לבדוק אם יש חשבון לחיוב שמקושר לפרויקט.

האם יש חשבון לחיוב שמצורף לפרויקט?

לא זכור לי. איך אפשר לבדוק אם החשבון לחיוב משויך לפרויקט?

עוברים אל הדף Billing במסוף Google Cloud ובוחרים את הפרויקט שבו נוצר מפתח ה-API. כדי לוודא שהמפתח משויך לפרויקט:

1. עוברים לקטע Credentials (פרטי כניסה), שאפשר לגשת אליו מסרגל הצד הימני בקטע Google Maps Platform > Credentials (הפלטפורמה של מפות Google > פרטי כניסה).
2. בודקים שמפתח ה-API שבו אתם משתמשים כרגע באתר מופיע ברשימה. אם זה לא המצב, עוברים לפרויקט אחר ובודקים את פרטי הכניסה שם.
3. אם לא הצלחתם לאתר את הפרויקט של מפתח ה-API, יכול להיות שאיבדתם את הגישה לפרויקט הזה. בקשו עזרה מאנשים אחרים בארגון. אם לא ניתן לאתר את הפרויקט המקורי, צריך:
   1. יוצרים פרויקט חדש. כדי לעשות זאת, בוחרים באפשרות פרויקט חדש מתוך רשימת הפרויקטים, או באפשרות יצירת פרויקט דרך הדף של מנהל המשאבים.
   2. יוצרים מפתח API חדש. אפשר לעשות זאת בדף Credentials. לוחצים על Create credentials ואז על API key.

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

לא, אין חשבון לחיוב שמקושר לפרויקט שלי.

נכנסים לדף Enable Billing ב-מסוף Cloud ומוסיפים חשבון לחיוב לפרויקט. מידע נוסף זמין במאמר תחילת העבודה עם Google Maps Platform.

כן, יש לי חשבון לחיוב שמקושר לפרויקט.

מצוין! חשוב לוודא שאמצעי החיוב שצוין תקין.

אמצעי החיוב שצוין לא תקף יותר (לדוגמה, כרטיס אשראי שפג תוקפו)?

אפשר להוסיף, להסיר או לעדכן אמצעי תשלום במסוף Cloud.

האם חרגתם ממגבלה יומית שהגדרתם בעצמכם ב-API?

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

כדי לבדוק את המגבלות היומיות, עוברים אל מרכז הבקרה של השירותים וממשקי ה-API במסוף Cloud. אחרי שמגיעים לשם:

1. אם מתבקשים, בוחרים פרויקט.
2. בוחרים API מהרשימה ולוחצים על הכרטיסייה Quotas.

האם מפתח ה-API שלך מוגבל לכתובות IP מסוימות?

אפשר להשתמש במפתחות API עם הגבלת כתובות IP רק בשירותי אינטרנט שמיועדים לשימוש בצד השרת (כמו Geocoding API וWeb Service APIs אחרים). לרוב שירותי האינטרנט האלה יש שירותים מקבילים ב-Maps JavaScript API (לדוגמה, שירות המרת כתובות לקואורדינטות (geocoding)). כדי להשתמש בשירותים בצד הלקוח של Maps JavaScript API, צריך ליצור מפתח API נפרד שאפשר לאבטח באמצעות הגבלה של גורמים מפנים מסוג HTTP (ראו קבלת מפתח API, הוספה והגבלה שלו).

קודי שגיאה של Maps JavaScript API למפתחים ולבעלי אתרים

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

שגיאות בטעינת המפה

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

קוד השגיאה	שליחת הודעה	תיאור
NotLoadingAPIFromGoogleMapsError	חובה להוריד את Maps JavaScript API ישירות מהשרתים של Google.	רכיב הסקריפט שטוען את Maps JavaScript API לא נכלל בדף בצורה נכונה. כדי שה-API יפעל בצורה תקינה, צריך לטעון אותו ישירות מכתובת https://maps.googleapis.com. מידע נוסף מופיע בקטע טעינת Maps JavaScript API.
TOSViolationMapError	נראה שהאתר הזה מפר את התנאים וההגבלות של Google Maps API. השימוש ב-Google Maps API הושבת באתר הזה.	הבקשה שלך נחסמה בגלל אי-עמידה בתנאים ובהגבלות של Google Maps Platform, אחרי שנשלחו כמה התראות באימייל. כדי לערער על החסימה ולבקש בדיקה של ההטמעה, צריך למלא את הטופס הזה. נשלח לך תשובה באימייל תוך כמה ימי עסקים. אם יש לכם רישיון לתוכנית פרימיום של Google Maps Platform, עליכם להשתמש בפרטי הכניסה שלכם לתוכנית הפרימיום של Google Maps Platform כדי לפתור את השגיאה הזו. אפשר לעיין במדריך בנושא אימות של תוכנית פרימיום.
UnauthorizedURLForClientIdMapError	כתובת ה-URL הזו לא מורשית להשתמש במזהה הלקוח של מפות Google שצוין.	מזהה הלקוח של תוכנית הפרימיום או של Maps APIs for Work שנכלל בטעינת הסקריפט לא תקין, פג או שהכתובת הנוכחית שטוענת את Maps JavaScript API לא נוספה לרשימת כתובות ה-URL המורשות. רישום כתובות URL מורשות

קודי שגיאה של Maps JavaScript API

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

‫Maps JavaScript API מחזיר שגיאות ואזהרות. שגיאה מציינת בעיה חמורה שקרתה במהלך הטעינה של Maps JavaScript API. הדף לא יכול לטעון את ה-API בצורה תקינה, וה-API לא יפעל בדף הזה. אזהרה היא הודעה משלימה לגבי הטעינה של Maps JavaScript API. האזהרה מתארת את הסיבות האפשריות לשגיאה, או מציעה בעיות אפשריות בקוד שבו נטען Maps JavaScript API. אם קיבלתם רק אזהרות בלי שגיאות, ה-API יפעל כראוי בדף הזה. עם זאת, מומלץ לתקן גם את הבעיות הפוטנציאליות האלה.

קוד שגיאה של מפתח	סוג	תיאור
ApiNotActivatedMapError	שגיאה	‫Maps JavaScript API לא מופעל בפרויקט ה-API. יכול להיות שתצטרכו להפעיל את Maps JavaScript API בקטע APIs במסוף Google Cloud. כדי להפעיל את Maps JavaScript API בפרויקט, לוחצים על הלחצן שלמטה. איך עושים את זה
ApiTargetBlockedMapError	שגיאה	מפתח ה-API הזה לא מורשה להשתמש בשירות או ב-API הזה. כדאי לבדוק את ההגדרות של הגבלות ה-API של מפתח ה-API במסוף Google Cloud כדי לוודא שכל ממשקי ה-API והשירותים שאתם צריכים מופיעים בצורה נכונה ברשימת ממשקי ה-API המופעלים. מידע נוסף זמין במאמר מפתחות API במסוף Cloud. מידע נוסף זמין במאמר שיטות מומלצות לאבטחת API.
DeletedApiProjectMapError	שגיאה	יכול להיות שהפרויקט של ה-API נמחק מ-מסוף Cloud. צריך לבדוק את הפרויקט שבו יצרתם את מפתח ה-API שכלול בטוען JavaScript API. אפשר ליצור פרויקט API חדש ולקבל מפתח חדש במסוף Cloud. כדי ליצור פרויקט חדש ולקבל מפתח API לפרויקט, לוחצים על הלחצן שלמטה. איך עושים את זה
ClientBillingNotEnabledMapError	שגיאה	לא הפעלתם חיוב בפרויקט. צריך להפעיל את החיוב בפרויקט ב-Google Cloud שמשויך למזהה הלקוח הזה, כאן.
BillingNotEnabledMapError	שגיאה	לא הפעלתם חיוב בפרויקט, ולכן השגיאה הזו מתרחשת. צריך להפעיל את החיוב בפרויקט ב-Google Cloud כאן. מידע נוסף
ExpiredKeyMapError	שגיאה	מפתח ה-API שכלול ברכיב הסקריפט שבו נטען ה-API פג תוקף או שלא מזוהה על ידי המערכת. יכול להיות שתקבלו את השגיאה הזו אחרי שתיצרו מפתח API חדש, אם תנסו להשתמש במפתח לפני שהמערכת תזהה אותו. צריך לחכות כמה דקות ולנסות שוב, או ליצור מפתח API חדש במסוף Cloud. כדי לקבל מפתח API, לוחצים על הלחצן שלמטה. קדימה, מתחילים
InvalidAppCheckTokenMapError	שגיאה	הטוקן של App Check שסופק לא תקין או שתוקפו פג. השגיאה הזו יכולה להתרחש רק אם נעשה שימוש באימות של App Check. אפשר לעיין במדריך בנושא אימות ב-App Check.
InvalidClientIdMapError	שגיאה	כדי לשפר את האבטחה והמהימנות של האימות, הוצאנו משימוש את מזהי הלקוחות של Maps Platform ב-26 במאי 2025, ולא תהיה יותר אפשרות להשתמש בהם אחרי 31 במאי 2026. במקום להשתמש במזהה לקוח, צריך להשתמש בפרטי כניסה של מפתח API כדי לאמת את התעבורה של שירות Google Maps API. מידע נוסף זמין במדריך להעברת מזהה לקוח. פועלים לפי השלבים במדריך כדי לשחזר את מזהה הלקוח באופן זמני.
InvalidKeyMapError	שגיאה	מפתח ה-API שכלול ברכיב הסקריפט שבו נטען ה-API לא נמצא. חשוב לוודא שאתם משתמשים במפתח API נכון. אפשר ליצור מפתח API חדש במסוף Cloud. כדי לקבל מפתח API, לוחצים על הלחצן שלמטה. קדימה, מתחילים
MalformedCredentialsMapError	שגיאה	האפליקציה שלך משתמשת בסכימת URI שלא נתמכת. מוודאים שהאפליקציה משתמשת בפורמט URI תקין כפי שמוגדר ב-RFC 3986.
MissingKeyMapError	שגיאה	באמצעות רכיב ה-script שבו נטען ה-API, חסר פרמטר האימות הנדרש. אם אתם משתמשים בממשק API רגיל של JavaScript במפות Google, אתם צריכים להשתמש בפרמטר key עם מפתח API תקין. מידע נוסף זמין במאמר תחילת העבודה עם Google Maps Platform. אם יש לכם מינוי פרימיום, אתם צריכים להשתמש בפרמטר client עם מזהה הלקוח או בפרמטר key עם מפתח API תקין. מידע נוסף זמין במדריך בנושא מפתחות API ומזהי לקוח. אם אתם לא הבעלים של האתר, אין פעולות שאתם יכולים לבצע כדי לתקן את השגיאה הזו. עם זאת, מומלץ להודיע לבעלי האתר אם אפשר.
ProjectDeniedMapError	שגיאה	הבקשה שלך לא הושלמה. יכול להיות שתוכלו למצוא פרטים נוספים על השגיאה במסוף Cloud. ראו מסוף Cloud.
RefererDeniedMapError	שגיאה	הבקשה שלך נחסמה בגלל אי-עמידה בתנאים ובהגבלות של Google Maps Platform, אחרי שנשלחו כמה התראות באימייל. כדי לערער על החסימה ולבקש בדיקה של ההטמעה, צריך למלא את הטופס הזה. נשלח לך תשובה באימייל תוך כמה ימי עסקים.
RefererNotAllowedMapError	שגיאה	כתובת ה-URL הנוכחית שבה נטען Maps JavaScript API לא נוספה לרשימת כתובות ה-URL המפנות המותרות. צריך לבדוק את הגדרות הרפרר של מפתח ה-API במסוף Cloud. מידע נוסף זמין במאמר בנושא Maps JavaScript API ובמאמר בנושא קבלת מפתח API.
OverQuotaMapError	שגיאה	מספר הבקשות חרג ממגבלות השימוש ב-Maps JavaScript API. הבקשות של האפליקציה יפעלו שוב באיפוס הבא של המכסה היומית. אם אתם לא הבעלים של האתר, אין פעולות שתוכלו לבצע כדי לתקן את השגיאה הזו. עם זאת, מומלץ להודיע לבעלי האתר, אם אפשר. פרטים נוספים זמינים במדריך בנושא מכסות שימוש. בדף הזה מוסבר גם איך אפשר להגדיל את מכסות השימוש.
ApiProjectMapError	שגיאה	לא ניתן היה לפענח את מפתח ה-API שצוין או את פרויקט ה-API שאליו הוא משויך. יכול להיות שהשגיאה היא זמנית. אם הודעת השגיאה הזו ממשיכה להופיע, יכול להיות שתצטרכו לקבל מפתח API חדש או ליצור פרויקט API חדש. מידע נוסף זמין במאמר תחילת העבודה עם Google Maps Platform.
ClientIdLooksLikeCryptoKey	אזהרה	יכול להיות שסיפקת מפתח קריפטוגרפי בפרמטר client. אם יש לכם תוכנית פרימיום או רישיון ל-Maps APIs for Work, צריך לציין את מזהה הלקוח כפרמטר client. לא צריך להשתמש במפתח הקריפטוגרפי עבור Maps JavaScript API. לקוחות של מינוי פרימיום ושל ממשקי API של מפות Google לעסקים יכולים לעיין במדריך בנושא מזהי לקוח.
ClientIdLooksLikeKey	אזהרה	יכול להיות שסיפקתם מפתח API בפרמטר client. אם יש לכם תוכנית פרימיום או רישיון ל-Maps APIs for Work, צריך לציין את מזהה הלקוח כפרמטר client. אם יש לכם תוכנית פרימיום של Google Maps Platform, אתם יכולים להשתמש בפרמטר client או בפרמטר key. אם אין לכם רישיונות, אתם צריכים להשתמש בפרמטר key במקום בפרמטר client . במדריך אימות במינוי פרימיום מוסבר איך עושים זאת.
InvalidChannel	אזהרה	יכול להיות שציינת פרמטר channel לא תקין. הערך של הפרמטר channel חייב להיות מחרוזת אלפאנומרית ב-ASCII, שיכולה לכלול נקודה (.), קו תחתון (_) ומקף (-). חשוב לוודא שציינתם פרמטר channel תקין. מידע נוסף זמין במאמר דיווח | מינוי פרימיום של Google Maps Platform.
InvalidClientId	אזהרה	נראה שהפרמטר client לא מכיל מזהה לקוח תקין. מזהה לקוח צריך להתחיל ב-'gme-‎'. במדריך אימות במינוי פרימיום מוסבר איך עושים זאת.
InvalidKey	אזהרה	מפתח ה-API שכלול ברכיב הסקריפט שבו נטען ה-API לא נראה תקין. חשוב לוודא שאתם משתמשים במפתח API נכון. אפשר ליצור מפתח API חדש במסוף Cloud. כדי לקבל מפתח API, לוחצים על הלחצן שלמטה. קדימה, מתחילים
InvalidVersion	אזהרה	יכול להיות שסיפקת מספר גרסה שגוי ברכיב הסקריפט. עליך לוודא שאתה משתמש במספר גרסה נכון. מידע נוסף מופיע במאמר ניהול גרסאות | Maps JavaScript API.
KeyLooksLikeClientId	אזהרה	יכול להיות שציינתם מזהה לקוח כפרמטר key. אם יש לכם מינוי פרימיום או רישיון ל-Maps APIs for Work, עליכם לציין את מזהה הלקוח כפרמטר client במקום כפרמטר key. אם יש לכם Google Maps Platform Premium Plan, אתם יכולים להשתמש בפרמטר client או בפרמטר key. אם אין לכם רישיונות, אתם חייבים להשתמש בפרמטר key במקום בפרמטר client . במדריך אימות במינוי פרימיום מוסבר איך עושים זאת.
KeyLooksLikeCryptoKey	אזהרה	יכול להיות שסיפקתם מפתח קריפטוגרפי או סוד חתימה כפרמטר key. אם יש לכם תוכנית פרימיום או רישיון ל-Maps APIs for Work, עליכם לציין את מזהה הלקוח כפרמטר client ולהסיר את הפרמטר key מרכיב הסקריפט. המפתח הקריפטוגרפי לא נדרש ל-Maps JavaScript API. אם יש לכם תוכנית פרימיום של Google Maps Platform, אתם יכולים להשתמש בפרמטר client או בפרמטר key. אם אין לכם רישיונות, תוכלו לקבל מפתח API במסוף Cloud. מידע נוסף מופיע במדריך בנושא ציון מזהה לקוח בזמן טעינת ה-API.
KeyLooksLikeProjectNumber	אזהרה	יכול להיות שסיפקתם מספר פרויקט כפרמטר key. חשוב לוודא שאתם משתמשים במפתח API נכון. אפשר ליצור מפתח API חדש במסוף Cloud. איך מקבלים מפתח API
NoApiKeys	אזהרה	רכיב הסקריפט שבו נטען ה-API לא כולל מפתח API. צריך לוודא שכוללים מפתח API תקין כפרמטר key. אפשר ליצור מפתח API חדש במסוף Cloud. כדי לקבל מפתח API, לוחצים על הלחצן שלמטה כדי להתחיל. קדימה, מתחילים אם אתם טוענים את Maps JavaScript API מנתיב v2 שהוצא משימוש, תוצג האזהרה NoApiKeys, גם אם ציינתם את הפרמטר key. כדאי לעיין במדריך לשדרוג מגרסה 2 לגרסה 3 ולהעביר את האפליקציה ל-Maps JavaScript API גרסה 3.
RetiredVersion	אזהרה	יכול להיות שציינתם בתסריט גרסה שיצאה משימוש. צריך לעדכן את האפליקציה כדי להשתמש באחת מהגרסאות הזמינות. מידע נוסף מופיע במאמר ניהול גרסאות | Maps JavaScript API.
SensorNotRequired	אזהרה	הפרמטר sensor כבר לא נדרש ל-Maps JavaScript API. ההסרה לא תשפיע על הפעולה התקינה של Maps JavaScript API, אבל מומלץ להסיר את הפרמטר sensor מרכיב הסקריפט.
SignatureNotRequired	אזהרה	הפרמטר signature לא נדרש ל-Maps JavaScript API. היא לא תמנע מממשק Maps JavaScript API לפעול בצורה תקינה, אבל היא עלולה ליצור סיכוני אבטחה. צריך להסיר אותו מרכיב ה-script.
SignedInNotSupported	אזהרה	הפרמטר signed_in הוצא משימוש ולא נתמך בגרסה של Maps JavaScript API שבה אתם משתמשים. הפעולה הזו לא תמנע את הפעולה של Maps JavaScript API, אבל יכול להיות שההתנהגות של האפליקציה תשתנה אם אתם מסתמכים על תכונות שדורשות כניסה לחשבון.
UrlAuthenticationCommonError	שגיאה	אירעה שגיאה שלא מתאימה לאף אחת מהקטגוריות האחרות שבדף הזה. יכול להיות שזו בעיה זמנית. אפשר לנסות לשלוח את הבקשה שוב אחרי השהיה קצרה. אם הבעיה לא נפתרת, כדאי לעיין במדריך למפתחים כדי לוודא שהבקשה היא בפורמט הנכון.

בדיקת שגיאות בדפדפן

‫Maps JavaScript API כותב הודעות שגיאה אל window.console. בקטע הזה מוסבר איך לבדוק את הפלט window.console ב-Google Chrome. אם אתם משתמשים בדפדפנים אחרים, כדאי לעיין במסמכי התיעוד למפתחים של הדפדפן שלכם. לעיון, הנה רשימה של כלים לבדיקת הפלט window.console בדפדפנים אחרים.

• ‫Web Console ל-Firefox.
• ניפוי באגים מרחוק ב-Android.
• ‫Web Inspector ל-iOS.

בדפדפן Chrome, אפשר להשתמש ב-JavaScript Console כדי לבדוק את הפלט של window.console באופן הבא.

1. כדי לפתוח את הכלים למפתחים, לוחצים על סמל התפריט > כלים נוספים > כלים למפתחים.
2. כדי לפתוח את לוח JavaScript, לוחצים על מקש ESC במקלדת. מקש ESC יפעיל או ישבית את קונסולת JavaScript. אם סוגרים את המסוף, לוחצים שוב על מקש Esc כדי לפתוח אותו.

אם אירעו שגיאות או אזהרות במהלך הטעינה של Maps JavaScript API, הן יופיעו כשורה אחת או יותר במסוף. הפורמט של הודעת שגיאה או אזהרה הוא:

Google Maps API error: [ERROR CODE] [Link to API document]
או
Google Maps API warning: [ERROR CODE] [Link to API document]

אפשר לבדוק את טבלת קודי השגיאה שלמעלה כדי למצוא את קוד השגיאה בהודעת השגיאה. אפשר גם למצוא את הפרטים על הודעת השגיאה במסמך ה-API שמקושר מההודעה.

הערה: אפשר להאזין לשגיאות אימות באופן פרוגרמטי.

טיפול בדפדפנים שלא נתמכים

מוודאים שהגרסה של הדפדפן שבה אתם משתמשים נתמכת כרגע על ידי Maps JavaScript API.

אם אתם מפתחים אפליקציית Windows מקורית שפועלת ב-WebView, אתם צריכים לוודא שאתם משתמשים ב-WebView2 שמבוסס על Edge. אין יותר תמיכה בגרסאות קודמות של WebView שמבוססות על Internet Explorer.

אם הקוד עדיין לא עובד

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

• מחפשים שגיאות כתיב. חשוב לזכור ש-JavaScript היא שפה תלוית אותיות רישיות (case-sensitive).
• בודקים את הדברים הבסיסיים – חלק מהבעיות הנפוצות ביותר מתרחשות במהלך היצירה הראשונית של המפה. למשל:
  • מוודאים שציינתם את המאפיינים zoom ו-center באפשרויות המיפוי.
  • מוודאים שהצהרתם על רכיב div שבו המפה תופיע במסך.
  • מוודאים שגובה הרכיב div של המפה מוגדר. כברירת מחדל, נוצרים רכיבי div עם גובה 0, ולכן הם לא גלויים.
  אפשר לעיין בדוגמאות שלנו להטמעה לדוגמה.
• כדי לזהות בעיות, כמו הבעיה שזמינה בכלים למפתחים ב-Chrome, אפשר להשתמש בכלי לניפוי באגים ב-JavaScript. כדאי להתחיל בבדיקת השגיאות בלוח Javascript.
• פרסום שאלות ב-Stack Overflow. הנחיות לפרסום שאלות טובות זמינות בדף התמיכה.