בדף הזה מתוארות הודעות השגיאה שה-API של JavaScript של מפות Google יכול להחזיר. ה-API של JavaScript במפות Google כותב הודעות שגיאה ואזהרה בלוח JavaScript. ייתכן שיחולו גם תנאי שגיאה מסוימים, וכתוצאה מכך תופיע מפה עם סימן מים חשוך.
שגיאות במפתח API ובחיוב
פתרון בעיות
בנסיבות מסוימות, ניתן להציג מפה כהה או תמונה 'שלילית' של Street View עם הטקסט "למטרות פיתוח בלבד". ההתנהגות הזו בדרך כלל מצביעה על בעיות במפתח API או בחיוב. כדי להשתמש במוצרי הפלטפורמה של מפות Google, עליכם להפעיל את החיוב בחשבון וכל הבקשות צריכות לכלול מפתח API תקף. למידע נוסף על איתור הודעות שגיאה, קראו את הקטע בנושא בדיקת שגיאות בדפדפן.
התהליך הבא יעזור לכם לפתור את הבעיה.
קודי שגיאה של Maps JavaScript API עבור מפתחים ובעלי אתרים
בטבלאות הבאות מפורטים קודי השגיאה האפשריים שהוחזרו על ידי Maps JavaScript API, ותיאור של הסיבה לכך והדרכים לפתור את הבעיה. למידע נוסף על איתור הודעות השגיאה, קראו את הקטע בנושא בדיקת שגיאות בדפדפן.
שגיאות בטעינת המפה
אם תיתקלו בשגיאה במהלך הטעינה של Maps JavaScript API, תוכלו לעיין בטבלה שלמטה כדי למצוא הסברים לקודי השגיאה.
קוד שגיאה | מסר | התיאור |
---|---|---|
NotLoadingAPIFromGoogleMapsError
|
צריך להוריד את Maps JavaScript API ישירות מהשרתים של Google. |
רכיב הסקריפט שטוען את ממשק ה-API של JavaScript במפות לא נכלל בצורה נכונה בדף. כדי שה-API יפעל כהלכה, יש לטעון אותו ישירות מהכתובת https://maps.googleapis.com. אפשר לעיין במאמר טעינת ה-API של JavaScript של מפות Google. |
TOSViolationMapError
|
נראה שהאתר הזה מפר את התנאים וההגבלות של Google Maps API. API של מפות Google הושבת עבור האתר הזה. |
האפליקציה שלך נחסמה עקב אי-תאימות לתנאים ולהגבלות של הפלטפורמה של מפות Google בעקבות כמה התראות באימייל. כדי לערער על החסימה ולבדוק את ההטמעה, צריך למלא את הטופס הזה. תקבלו תשובה באימייל תוך מספר ימי עסקים. אם יש לך רישיון בתוכנית פרימיום של הפלטפורמה של מפות Google, עליך להשתמש בפרטי הכניסה שלך לתוכנית הפרימיום של מפות Google כדי לפתור את השגיאה הזו. אפשר להיעזר במדריך לאימות תוכנית Premium. |
UnauthorizedURLForClientIdMapError
|
לכתובת ה-URL הזו אין הרשאה להשתמש במזהה הלקוח של מפות Google שסופק. |
מזהה הלקוח בתוכנית Premium או Maps API for Work שנכלל בטעינת הסקריפט אינו חוקי, פג תוקפו או שהכתובת הנוכחית שטוענת את ממשק ה-API של JavaScript של מפות Google לא נוספה לרשימת כתובות האתרים המורשות. למידע נוסף, ראו רישום כתובות URL מורשות. |
קודי שגיאה של Maps JavaScript API
אם נתקלת בשגיאה במסוף JavaScript של Chrome, ב-Firefox Web Console או בכל כלי מקביל אחר בדפדפנים שלך, היעזר בטבלה הבאה לקבלת הסברים לגבי קודי השגיאה.
ה-API של JavaScript במפות Google מחזיר גם שגיאות וגם אזהרות. שגיאה מציינת בעיה חמורה שאירעה במהלך טעינת ממשק ה-API של JavaScript של מפות Google. הדף שלך לא יכול לטעון את ה-API כראוי, וה-API לא יפעל בדף הזה. אזהרה היא הודעה משלימה לגבי הטעינה של Maps JavaScript API. האזהרה מתארת את הסיבות האפשריות לשגיאה, או מציינת בעיות אפשריות בקוד שטוען את API JavaScript של מפות Google. אם מופיעות רק אזהרות ללא שגיאות, ה-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 Console. למידע נוסף, ראו שיטות מומלצות לאבטחת API. |
DeletedApiProjectMapError
|
שגיאה |
יכול להיות שפרויקט ה-API נמחק ממסוף Cloud. יש לבדוק את הפרויקט שעבורו יצרת את מפתח ה-API שכלול בכלי לטעינת API של JavaScript. אפשר ליצור פרויקט API חדש ולקבל מפתח חדש במסוף Cloud. כדי ליצור פרויקט חדש ולקבל מפתח API לפרויקט, יש ללחוץ על הלחצן שלמטה.
|
ClientBillingNotEnabledMapError
|
שגיאה |
לא הפעלת את החיוב בפרויקט. צריך להפעיל את החיוב בפרויקט Google Cloud שמשויך למזהה הלקוח הזה כאן. |
BillingNotEnabledMapError
|
שגיאה |
לא הפעלת את החיוב בפרויקט, וזה גורם לשגיאה הזו. צריך להפעיל את החיוב בפרויקט Google Cloud כאן. |
ExpiredKeyMapError
|
שגיאה |
מפתח ה-API שכלול ברכיב הסקריפט שטוען את ה-API פג או שהמערכת לא מזהה אותו. השגיאה הזו יכולה להופיע אחרי יצירת מפתח API חדש, אם תנסו להשתמש במפתח לפני שהמערכת תזהה אותו. המתינו כמה דקות ונסו שוב. יכול להיות שתצטרכו ליצור מפתח API חדש במסוף Cloud. כדי לקבל מפתח API, לחצו על הלחצן שלמטה.
|
InvalidClientIdMapError
|
שגיאה |
מזהה הלקוח שכלול ברכיב הסקריפט שטוען את ה-API לא חוקי או שתוקפו פג. חשוב לוודא שהשתמשת במזהה הלקוח שלך בצורה נכונה. מזהה הלקוח צריך להתחיל בקידומת 'gme- '. אם השגיאה הזו מופיעה גם כשמשתמשים במזהה הלקוח באופן תקין, יכול להיות שפג התוקף של מזהה הלקוח. עליך לפנות לנציג של חשבון Google שלך.
אם אין לך רישיון בתוכנית Premium או
Maps APIs for Work, עליך להשתמש בפרמטר אפשר להיעזר במדריך לאימות תוכנית Premium. |
InvalidKeyMapError
|
שגיאה |
מפתח ה-API שכלול ברכיב הסקריפט שטוען את ה-API לא נמצא. עליך לוודא שהשתמשת במפתח API נכון. תוכלו ליצור מפתח API חדש במסוף Cloud. כדי לקבל מפתח API, לחצו על הלחצן שלמטה.
|
MalformedCredentialsMapError
|
שגיאה |
האפליקציה שלך משתמשת בסכימת URI שאינה נתמכת. מוודאים שהאפליקציה משתמשת בפורמט URI חוקי כפי שמוגדר ב-RFC 3986. |
MissingKeyMapError
|
שגיאה |
ברכיב הסקריפט שטוען את ה-API חסר פרמטר האימות הנדרש. אם השתמשת ב-API הסטנדרטי של JavaScript במפות Google, עליך להשתמש
בפרמטר לקוחות של תוכנית Premium צריכים
להשתמש בפרמטר אם אינך הבעלים של האתר, אין פעולות שאפשר לבצע כדי לתקן את השגיאה הזו. עם זאת, מומלץ להודיע לבעלים של האתר אם אפשר. |
ProjectDeniedMapError
|
שגיאה |
הבקשה שלך לא הושלמה. יכול להיות שיוצגו פרטים נוספים על השגיאה במסוף Cloud. פרטים נוספים זמינים במסוף Cloud. |
RefererDeniedMapError
|
שגיאה |
האפליקציה שלך נחסמה עקב אי-תאימות לתנאים ולהגבלות של הפלטפורמה של מפות Google בעקבות כמה התראות באימייל. כדי לערער על החסימה ולבדוק את ההטמעה, צריך למלא את הטופס הזה. תקבלו תשובה באימייל תוך מספר ימי עסקים. |
RefererNotAllowedMapError
|
שגיאה |
כתובת האתר הנוכחית שטוענת את API JavaScript של מפות Google לא נוספה לרשימת הגורמים המפנים המותרים. עליך לבדוק את הגדרות הגורם המפנה של מפתח ה-API במסוף Cloud. אפשר לעיין ב-API של Maps JavaScript ולקבל מפתח API. |
OverQuotaMapError
|
שגיאה |
מספר הבקשות חרג ממגבלות השימוש של Maps JavaScript API. הבקשות של האפליקציה שלך יחזרו לפעול באיפוס המכסה היומית הבאה. אם אינך הבעלים של האתר, אין פעולות שאפשר לבצע כדי לתקן את השגיאה הזו. עם זאת, מומלץ להודיע לבעלים של האתר אם אפשר. לפרטים נוספים אפשר לעיין במדריך בנושא מגבלות שימוש. בדף מוסבר גם איך אפשר להחיל מגבלות שימוש גבוהות יותר. |
ApiProjectMapError
|
שגיאה |
לא הצלחנו לפענח את מפתח ה-API שסופק או את פרויקט ה-API שאליו הוא משויך. ייתכן שזו שגיאה זמנית. אם הודעת השגיאה ממשיכה להופיע, יכול להיות שצריך לקבל מפתח API חדש או ליצור פרויקט API חדש. מידע נוסף זמין במאמר תחילת השימוש בפלטפורמה של מפות Google. |
ClientIdLooksLikeCryptoKey
|
אזהרה |
יכול להיות שסיפקת מפתח קריפטוגרפי בפרמטר מומלץ לעיין במדריך למזהי לקוחות ללקוחות של תוכנית Premium ושל ממשקי Maps API for Work. |
ClientIdLooksLikeKey
|
אזהרה |
יכול להיות שסיפקת מפתח API בפרמטר אפשר להיעזר במדריך לאימות תוכנית Premium. |
InvalidChannel
|
אזהרה |
יכול להיות שסיפקת פרמטר למידע נוסף, אפשר לעיין בקטע דיווח | תוכנית הפרימיום של הפלטפורמה של מפות Google. |
InvalidClientId
|
אזהרה |
נראה שהפרמטר אפשר להיעזר במדריך לאימות תוכנית Premium. |
InvalidKey
|
אזהרה |
מפתח ה-API שכלול ברכיב הסקריפט שטוען את ה-API לא נראה תקין. עליך לוודא שהשתמשת במפתח API נכון. אתם יכולים ליצור מפתח API חדש במסוף Cloud. כדי לקבל מפתח API, לחצו על הלחצן שלמטה.
|
InvalidVersion
|
אזהרה |
ייתכן שסיפקת מספר גרסה שגוי ברכיב הסקריפט שלך. ודא שאתה משתמש במספר הגרסה הנכון. אפשר לעיין בקטע ניהול גרסאות | API של JavaScript במפות Google. |
KeyLooksLikeClientId
|
אזהרה |
יכול להיות שסיפקתם מזהה לקוח כפרמטר key . אם יש לך
רישיון Premium או
Maps APIs for Work, צריך לציין את מזהה הלקוח כפרמטר
client במקום כפרמטר key . אם יש לך
תוכנית פרימיום של הפלטפורמה של מפות Google, אפשר להשתמש בפרמטר client
או בפרמטר key . אם אין לך רישיונות,
עליך להשתמש בפרמטר key במקום בפרמטר client
.
אפשר להיעזר במדריך לאימות תוכנית Premium. |
KeyLooksLikeCryptoKey
|
אזהרה |
יכול להיות שסיפקת מפתח קריפטוגרפי או סוד חתימה כפרמטר
אפשר להיעזר במדריך לציון מזהה לקוח במהלך טעינת ה-API. |
KeyLooksLikeProjectNumber
|
אזהרה |
יכול להיות שסיפקתם מספר פרויקט כפרמטר כאן מוסבר איך לקבל מפתח API. |
NoApiKeys
|
אזהרה |
לרכיב הסקריפט שטוען את ה-API אין מפתח API. צריך לוודא
שכללת מפתח API תקין כפרמטר של
כדי לקבל מפתח API, לוחצים על הלחצן שלמטה ומתחילים את התהליך.
אם תטען את ממשק ה-API של JavaScript של מפות Google מנתיב v2 שהוצא משימוש, תופיע האזהרה |
RetiredVersion
|
אזהרה |
ייתכן שסיפקת גרסה שיצאה משימוש ברכיב הסקריפט שלך. כדי להשתמש באחת מהגרסאות הזמינות צריך לעדכן את האפליקציה. אפשר לעיין בקטע ניהול גרסאות | API של JavaScript במפות Google. |
SensorNotRequired
|
אזהרה |
הפרמטר |
SignatureNotRequired
|
אזהרה |
הפרמטר |
SignedInNotSupported
|
אזהרה |
הפרמטר |
UrlAuthenticationCommonError
|
שגיאה |
אירעה שגיאה שאינה מתאימה לקטגוריות האחרות בדף הזה. הסיבה לכך יכולה להיות בעיה זמנית. יש לנסות שוב לבצע את הבקשה לאחר עיכוב קצר. אם הפעולה לא פותרת את הבעיה, אפשר לעיין במדריך למפתחים כדי לוודא שפורמט הבקשה נכון. |
בדיקת שגיאות בדפדפן
ה-API של JavaScript של מפות Google כותב הודעות שגיאה ב-window.console
. בקטע הזה נסביר איך בודקים את הפלט window.console
ב-Google Chrome. אם אתם משתמשים בדפדפנים אחרים, עיינו במסמכי התיעוד למפתחים של הדפדפן. לעיונך, זו רשימה של כלים לבדיקת הפלט של window.console
בדפדפנים אחרים.
- מסוף האינטרנט עבור Firefox.
- ניפוי באגים מרחוק ב-Android.
- Web Inspector (סוקר האינטרנט) ל-iOS.
ב-Chrome, תוכלו להשתמש ב-JavaScript Console כדי לבדוק את הפלט של window.console
באופן הבא.
- כדי לפתוח את 'כלים למפתחים', יש לבחור בסמל התפריט > כלים נוספים > כלים למפתחים.
- כדי לפתוח את לוח 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. הנחיות לפרסום שאלות מוצלחות זמינות בדף Support.