הודעות שגיאה

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

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

פתרון בעיות

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

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

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

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

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

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

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

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

טעינה של Maps JavaScript API

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

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

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

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

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

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

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

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

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

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

כדאי לעיין במדריך לאימות באמצעות בדיקת אפליקציה.

InvalidClientIdMapError שגיאה

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

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

אפשר לעיין במדריך לגבי אימות של תוכנית הפרימיום.

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.

מסוף Cloud

RefererDeniedMapError שגיאה

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

RefererNotAllowedMapError שגיאה

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

להציג את Maps JavaScript API קבלת מפתח API
OverQuotaMapError שגיאה

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

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

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

ApiProjectMapError שגיאה

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

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

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

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

ClientIdLooksLikeKey אזהרה

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

אפשר לעיין במדריך לגבי אימות של תוכנית הפרימיום.

InvalidChannel אזהרה

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

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

InvalidClientId אזהרה

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

אפשר לעיין במדריך לגבי אימות של תוכנית הפרימיום.

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 .

אפשר לעיין במדריך לגבי אימות של תוכנית הפרימיום.

KeyLooksLikeCryptoKey אזהרה

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

SignedInNotSupported אזהרה

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

UrlAuthenticationCommonError שגיאה

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

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

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

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

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

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

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.
  • פרסום השאלות במקבץ גלישה. הנחיות לפרסום שאלות מעולות זמינות ב- הדף Support.