הודעות שגיאה

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

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

פתרון בעיות

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

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

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

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

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

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

קוד השגיאה הודעה תיאור
NotLoadingAPIFromGoogleMapsError צריך להוריד את ממשק ה-API של JavaScript במפות Google ישירות מהשרתים של Google.

רכיב הסקריפט שמטעין את Maps JavaScript API לא נכלל בצורה נכונה בדף. כדי שה-API יפעל בצורה תקינה, צריך לטעון אותו ישירות מהכתובת https://maps.googleapis.com.

טעינה של Maps JavaScript API

TOSViolationMapError נראה שהאתר הזה מפר את התנאים וההגבלות של Google Maps API. ממשק Google Maps API הושבת באתר הזה.

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

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

UnauthorizedURLForClientIdMapError כתובת ה-URL הזו לא מורשית להשתמש במזהה הלקוח של מפות Google שסופק.

מזהה הלקוח של מינוי Premium או של מפות Google לעסקים שכלול בעומס הסקריפט לא תקין, פג התוקף שלו או שהכתובת הנוכחית שממנה נטען Maps JavaScript API לא נוספה לרשימה של כתובות ה-URL המורשות.

רישום כתובות URL מורשות

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

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

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

קוד שגיאה למפתחים סוג תיאור
ApiNotActivatedMapError שגיאה

ממשק ה-API של JavaScript במפות Google לא מופעל בפרויקט ה-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 loader. אפשר ליצור פרויקט API חדש ולקבל מפתח חדש במסוף Cloud.

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

ClientBillingNotEnabledMapError שגיאה

לא הפעלתם את החיוב בפרויקט. צריך להפעיל את החיוב בפרויקט ב-Google Cloud שמשויך למזהה הלקוח הזה, כאן.

BillingNotEnabledMapError שגיאה

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

מידע נוסף
ExpiredKeyMapError שגיאה

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

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

InvalidAppCheckTokenMapError שגיאה

הטוקן שסופק לבדיקה של האפליקציה לא תקין או שתוקפו פג. השגיאה הזו יכולה להתרחש רק אם אתם משתמשים באימות של App Check.

אפשר לעיין במדריך בנושא אימות באמצעות App Check.

InvalidClientIdMapError שגיאה

מזהה הלקוח שכלול ברכיב הסקריפט שמטעין את ה-API לא תקין או פג תוקף. חשוב לוודא שאתם משתמשים במזהה הלקוח בצורה נכונה. מזהה הלקוח צריך להתחיל בקידומת 'gme-‎'. אם השגיאה הזו מופיעה גם כשמשתמשים במזהה הלקוח בצורה נכונה, יכול להיות שתוקף מזהה הלקוח פג. עליך לפנות לנציג של חשבון Google.

אם אין לכם תוכנית Premium או רישיון ל-Maps APIs for Work, עליכם להשתמש בפרמטר key עם מפתח ה-API במקום בפרמטר client .

במדריך בנושא אימות בתוכנית Premium מוסבר איך עושים את זה.

InvalidKeyMapError שגיאה

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

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

MalformedCredentialsMapError שגיאה

האפליקציה משתמשת בסכימת URI שאינה נתמכת. מוודאים שהאפליקציה משתמשת בפורמט URI תקין כפי שמוגדר ב-RFC 3986.

MissingKeyMapError שגיאה

באלמנט הסקריפט שמטעין את ה-API חסר פרמטר האימות הנדרש.

אם אתם משתמשים בממשק ה-API הסטנדרטי של JavaScript במפות Google, עליכם להשתמש בפרמטר key עם מפתח API תקף. מידע נוסף זמין במאמר תחילת העבודה עם הפלטפורמה של מפות Google.

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

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

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

מסוף Cloud

RefererDeniedMapError שגיאה

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

RefererNotAllowedMapError שגיאה

כתובת ה-URL הנוכחית שמטעינה את Maps JavaScript API לא נוספה לרשימת המפנים המורשים. עליך לבדוק את הגדרות המפנה של מפתח ה-API במסוף Cloud.

אפשר לעיין בממשק API של JavaScript במפות Google ובמאמר קבלת מפתח API.
OverQuotaMapError שגיאה

מספר הבקשות חורג ממגבלות השימוש של API של JavaScript במפות Google. הבקשות של האפליקציה יתחילו לפעול שוב אחרי האיפוס הבא של המכסה היומית.

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

פרטים נוספים זמינים במדריך בנושא מגבלות שימוש. בדף הזה מוסבר גם איך אפשר לקבל מגבלות שימוש גבוהות יותר.

ApiProjectMapError שגיאה

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

מידע נוסף זמין במאמר תחילת העבודה עם הפלטפורמה של מפות Google.
ClientIdLooksLikeCryptoKey אזהרה

יכול להיות שסיפקתם מפתח קריפטוגרפית בפרמטר client. אם יש לכם מינוי Premium או רישיון ל-Maps APIs for Work, עליכם לציין את מזהה הלקוח כפרמטר client. אין צורך להשתמש במפתח הקריפטוגרפי שלכם בממשק API של JavaScript במפות Google.

מומלץ לעיין במדריך בנושא מזהי לקוח ללקוחות עם תוכנית Premium וללקוחות של מפות Google לעסקים.

ClientIdLooksLikeKey אזהרה

יכול להיות שסיפקתם מפתח API בפרמטר client. אם יש לכם מינוי לתוכנית Premium או רישיון ל-Maps APIs for Work, עליכם לציין את מזהה הלקוח כפרמטר client. אם יש לכם תוכנית Premium של הפלטפורמה של מפות Google, תוכלו להשתמש בפרמטר client או בפרמטר key. אם אין לכם רישיונות, עליכם להשתמש בפרמטר key במקום בפרמטר client .

במדריך בנושא אימות בתוכנית Premium תוכלו לקרוא מידע נוסף בנושא.

InvalidChannel אזהרה

יכול להיות שסיפקתם פרמטר channel לא חוקי. הערוץ חייב להיות מחרוזת אלפאנומרית ב-ASCII, שיכולה לכלול נקודה (.), קו תחתון (_) ומקף (-). חשוב לוודא שציינת פרמטר channel תקין.

דיווח | תוכנית Premium בפלטפורמה של מפות Google

InvalidClientId אזהרה

נראה שהפרמטר client לא מכיל מזהה לקוח נכון. מזהה הלקוח צריך להתחיל ב-'gme-‎'.

במדריך בנושא אימות בתוכנית Premium תוכלו לקרוא מידע נוסף בנושא.

InvalidKey אזהרה

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

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

InvalidVersion אזהרה

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

ניהול גרסאות | Google Maps JavaScript API

KeyLooksLikeClientId אזהרה יכול להיות שציינתם מזהה לקוח כפרמטר key. אם יש לכם מינוי Premium או רישיון Maps APIs for Work, עליכם לציין את מזהה הלקוח כפרמטר client במקום כפרמטר key. אם יש לכם תוכנית Premium של הפלטפורמה של מפות Google, תוכלו להשתמש בפרמטר client או בפרמטר key. אם אין לכם רישיונות, עליכם להשתמש בפרמטר key במקום בפרמטר client .

במדריך בנושא אימות בתוכנית Premium תוכלו לקרוא מידע נוסף בנושא.

KeyLooksLikeCryptoKey אזהרה

יכול להיות שסיפקתם מפתח קריפטוגרפיה או סוד חתימה כפרמטר key. אם יש לכם מינוי Premium או רישיון Maps APIs for Work, עליכם לציין את מזהה הלקוח כפרמטר client ולהסיר את הפרמטר key מרכיב הסקריפט. המפתח הקריפטוגרפי לא נדרש ל-Maps JavaScript API. אם יש לכם תוכנית Premium של הפלטפורמה של מפות Google, תוכלו להשתמש בפרמטר 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 v3.

RetiredVersion אזהרה

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

ניהול גרסאות | Google Maps JavaScript API

SensorNotRequired אזהרה

הפרמטר sensor כבר לא נדרש ל-Maps JavaScript API. הוא לא ימנע את הפעולה התקינה של Maps JavaScript API, אבל מומלץ להסיר את הפרמטר sensor מרכיב הסקריפט.

SignatureNotRequired אזהרה

הפרמטר signature לא נדרש ל-Maps JavaScript API. היא לא תמנע את הפעולה התקינה של ממשק ה-API של JavaScript במפות Google, אבל היא עלולה להציג סיכוני אבטחה. יש להסיר אותו מרכיב הסקריפט.

SignedInNotSupported אזהרה

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

UrlAuthenticationCommonError שגיאה

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

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

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

ב-Chrome, אפשר להשתמש במסוף JavaScript כדי לבדוק את הפלט של 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.

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

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

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