בדף הזה מתוארות הודעות השגיאה שאפשר להחזיר באמצעות 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. |
TOSViolationMapError
|
נראה שהאתר הזה מפר את התנאים וההגבלות של Google Maps API. ה-API של מפות Google הושבת עבור האתר הזה. |
האפליקציה שלך נחסמה עקב אי-תאימות התנאים וההגבלות של הפלטפורמה של מפות Google, לאחר מספר התראות באימייל. כדי לערער על לחסום את ההטמעה שלהם ולבדוק את ההטמעה שלהם, את הטופס הזה. תישלח אליך תשובה באימייל תוך מספר ימי עסקים. אם יש לך רישיון לתוכנית הפרימיום של מפות Google, צריך להשתמש פרטי הכניסה לתוכנית הפרימיום של מפות Google כדי לפתור את השגיאה. אפשר לעיין במדריך לגבי אימות של תוכנית הפרימיום. |
UnauthorizedURLForClientIdMapError
|
כתובת ה-URL הזו אינה מורשית להשתמש במספר הלקוח של מפות Google שסופק. |
תוכנית הפרימיום או ממשקי ה-API של מפות Google לעבודה מזהה הלקוח הכלול בטעינת הסקריפט אינו חוקי, או שהכתובת הנוכחית טוענת את ממשק JavaScript API של מפות Google לא נוסף לרשימה של כתובות 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 לעבודה, עליך להשתמש
הפרמטר אפשר לעיין במדריך לגבי אימות של תוכנית הפרימיום. |
InvalidKeyMapError
|
שגיאה |
מפתח ה-API הכלול ברכיב הסקריפט שטוען את ה-API אינו נמצא. צריך לוודא שהשתמשת במפתח API נכון. אפשר ליצור מפתח API חדש במסוף Cloud. כדי לקבל מפתח API יש ללחוץ על הלחצן שלמטה.
|
MalformedCredentialsMapError
|
שגיאה |
האפליקציה שלך משתמשת בסכימת URI לא נתמכת. יש לוודא שהאפליקציה משתמשת ב- פורמט URI תקין כפי שמוגדר ב-RFC 3986. |
MissingKeyMapError
|
שגיאה |
ברכיב הסקריפט שטוען את ה-API חסר פרמטר האימות הנדרש. אם אתם משתמשים בגרסה הרגילה של Maps JavaScript API, צריך להשתמש
פרמטר אם אתם לקוחות של תוכנית Premium, עליכם:
צריך להשתמש בפרמטר אם אינך הבעלים של האתר, אין פעולות שתוכל לבצע כדי לתקן את הבעיה. שגיאה. עם זאת, אם אפשר, כדאי לך להודיע על כך לבעלי האתר. |
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
|
אזהרה |
יכול להיות שסיפקת מפתח קריפטוגרפי ב- אפשר לעיין במדריך לגבי לקוח מזהים לתוכנית הפרימיום וגם לקוחות של Maps APIs for Work. |
ClientIdLooksLikeKey
|
אזהרה |
יכול להיות שסיפקתם מפתח API בפרמטר אפשר לעיין במדריך לגבי אימות של תוכנית הפרימיום. |
InvalidChannel
|
אזהרה |
יכול להיות שסיפקתם פרמטר |
InvalidClientId
|
אזהרה |
נראה שהפרמטר אפשר לעיין במדריך לגבי אימות של תוכנית הפרימיום. |
InvalidKey
|
אזהרה |
מפתח ה-API הכלול ברכיב הסקריפט שטוען את ה-API לא נראה נכון. צריך לוודא שהשתמשת במפתח API נכון. אפשר ליצור מפתח API חדש במסוף Cloud. כדי לקבל מפתח API יש ללחוץ על הלחצן שלמטה.
|
InvalidVersion
|
אזהרה |
יכול להיות שסיפקתם מספר גרסה שגוי ברכיב הסקריפט. צריך לוודא שאתם משתמשים במספר הגרסה הנכון. |
KeyLooksLikeClientId
|
אזהרה |
יכול להיות שסיפקתם מזהה לקוח בתור הפרמטר key . אם
יש לכם תוכנית Premium או
רישיון Maps APIs for Work. יש לציין את מספר הלקוח שלך בתור
הפרמטר client במקום הפרמטר key . אם יש לך
תוכנית הפרימיום של הפלטפורמה של מפות Google, אפשר להשתמש בפרמטר client
או פרמטר key . אם אין לך רישיונות,
יש להשתמש בפרמטר key ולא בפרמטר client
.
אפשר לעיין במדריך לגבי אימות של תוכנית הפרימיום. |
KeyLooksLikeCryptoKey
|
אזהרה |
יכול להיות שסיפקת מפתח קריפטוגרפי או סוד חתימה בתור אפשר לעיין במדריך לגבי ציון מזהה לקוח כשטוענים את ה-API. |
KeyLooksLikeProjectNumber
|
אזהרה |
יכול להיות שסיפקתם מספר פרויקט כפרמטר כאן מוסבר איך לקבל מפתח API. |
NoApiKeys
|
אזהרה |
לאלמנט הסקריפט שטוען את ה-API אין מפתח API. חשוב להקפיד
כוללים מפתח API חוקי כפרמטר
כדי לקבל מפתח API, לחצו על הלחצן שלמטה כדי להתחיל.
אם טוענים את הממשק של Maps JavaScript API מגרסה 2 שהוצאה משימוש
נתיב, תוצג האזהרה |
RetiredVersion
|
אזהרה |
יכול להיות שסיפקתם גרסה שכבר לא זמינה ברכיב הסקריפט. צריך לעדכן את האפליקציה כדי להשתמש באחת מהגרסאות הזמינות. |
SensorNotRequired
|
אזהרה |
הפרמטר |
SignatureNotRequired
|
אזהרה |
הפרמטר |
SignedInNotSupported
|
אזהרה |
הפרמטר |
UrlAuthenticationCommonError
|
שגיאה |
אירעה שגיאה שלא מתאימה לקטגוריות האחרות כאן הדף הזה. יכול להיות שהסיבה לכך היא בעיה זמנית. כדאי לנסות שוב לאחר עיכוב קצר. אם זה לא פותר את הבעיה, לעיין מדריך למפתחים כדי לוודא שהבקשה בפורמט הנכון. |
בדיקת שגיאות בדפדפן
ממשק JavaScript API של מפות Google כותב הודעות שגיאה ל-
window.console
בקטע הזה מוסבר איך אפשר לבדוק את
הפלט של window.console
ב-Google Chrome. אם משתמשים בכל
דפדפנים, יש לעיין בתיעוד למפתחים של הדפדפן. עבור
זוהי רשימה של כלים לבדיקת הפלט של window.console
בדפדפנים אחרים.
- Web Console עבור Firefox.
- ניפוי באגים מרחוק ל-Android.
- Web Inspector ל-iOS.
ב-Chrome, אפשר להשתמש ב
JavaScript קונסולת
כדי לבדוק את פלט window.console
באופן הבא.
- כדי לפתוח את הכלים למפתחים, לוחצים על סמל התפריט > כלים נוספים > כלים למפתחים.
- כדי לפתוח את לוח 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.