הודעות שגיאה

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

שגיאות שקשורות למפתח API ולחיוב

פתרון בעיות

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

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

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

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

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

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

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

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

InvalidClientIdMapError שגיאה

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

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

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

InvalidKeyMapError שגיאה

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

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

MalformedCredentialsMapError שגיאה

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

MissingKeyMapError שגיאה

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

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

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

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

ProjectDeniedMapError שגיאה

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

ראו מסוף Cloud.

RefererDeniedMapError שגיאה

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

RefererNotAllowedMapError שגיאה

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

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

OverQuotaMapError שגיאה

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

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

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

ApiProjectMapError שגיאה

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

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

ClientIdLooksLikeCryptoKey אזהרה

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

אפשר לעיין במדריך לגבי לקוח מזהים לתוכנית הפרימיום וגם לקוחות של Maps APIs for Work.

ClientIdLooksLikeKey אזהרה

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

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

InvalidChannel אזהרה

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

ראו דיווח | תוכנית פרימיום של הפלטפורמה של מפות Google.

InvalidClientId אזהרה

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

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

InvalidKey אזהרה

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

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

InvalidVersion אזהרה

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

ראו ניהול גרסאות | API של מפות Google ל-JavaScript.

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

RetiredVersion אזהרה

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

ראו ניהול גרסאות | API של מפות Google ל-JavaScript.

SensorNotRequired אזהרה

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

SignatureNotRequired אזהרה

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

SignedInNotSupported אזהרה

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

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

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

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

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

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

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

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