הודעות שגיאה

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

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

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

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

פתרון בעיות

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

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

האם השתמשת במפתח API?

אני עדיין בהתלבטות. איך בודקים אם משתמשים במפתח API?

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

• אפשר להשתמש בתוסף Chrome Google Maps Platform API Checker. כך אפשר לבדוק אם באתר שלך מוטמעת הטמעה תקינה של ממשקי ה-API של מפות Google ברישיון של Google.
• אם אתם משתמשים בספרייה או בפלאגין כדי לטעון את Maps JavaScript API, צריך לבדוק את ההגדרות של הספרייה הזו ולחפש אפשרות של מפתח API.
• בודקים שגיאות בדפדפן. אם מופיעות ההודעות הבאות, סימן שאתם משתמשים במפתח ה-API לא תקין:
• אזהרה לגבי JavaScript API של מפות Google: NoApiKeys
• שגיאת JavaScript API של מפות Google : MissingKeyMapError

למפתחי אתרים:

• אם יש לך גישה לקוד המקור של האפליקציה, צריך לחפש את התג <script> שמשמש לטעינת ה-API של JavaScript במפות Google. כשטוענים את Maps JavaScript API, צריך להחליף את YOUR_API_KEY בקוד שבהמשך במפתח ה-API.

    <script async defer
      src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
    </script>
  

• צריך לבדוק את התנועה ברשת שנוצרת על ידי האתר בדפדפן. ב-Chrome אפשר לראות את הרשתות האלה באמצעות הכרטיסייה DevTools Network (רשת). כאן אפשר לראות את בקשות הרשת שבוצעו על ידי האתר שלך. בקשות שמתבצעות באמצעות Maps JavaScript API יופיעו מתחת לנתיב maps/api/js. כאן אפשר לבדוק אם הבקשות משתמשות בפרמטר key. כדאי לסנן את התנועה ברשת לפי maps/api/js כשמציגים את הכרטיסייה רשת.

לא, אני לא משתמש במפתח API.

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

כן, השתמשתי במפתח API.

נהדר! בואו נתקדם ונבדוק אם הפרויקט שלכם כולל חשבון לחיוב.

האם מצורף לפרויקט חשבון לחיוב?

אני עדיין בהתלבטות. איך בודקים אם חשבון לחיוב מצורף לפרויקט?

נכנסים ל דף Billing ב-Google Cloud Console ובוחרים את הפרויקט שבו נוצר מפתח ה-API. כדי לוודא שהמפתח משויך לפרויקט:

1. נכנסים לקטע Credentials (פרטי כניסה) בסרגל הצד שמימין, בקטע Google Maps Platform > Credentials (הפלטפורמה של מפות Google > פרטי כניסה).
2. בודקים שמפתח ה-API שבו אתם משתמשים כרגע באתר מופיע ברשימה. אם זה לא המצב, עוברים לפרויקט אחר ובודקים שם את פרטי הכניסה.
3. אם לא הצלחת לאתר את הפרויקט של מפתח ה-API שלך, ייתכן שכבר אין לך גישה לפרויקט הזה. כדאי לבקש עזרה ממשתמשים אחרים בארגון. אם לא ניתן לאתר את הפרויקט המקורי, צריך:
   1. יוצרים פרויקט חדש. כדי לעשות את זה, בוחרים באפשרות New Project מרשימת הפרויקטים, או בוחרים באפשרות Create Project (יצירת פרויקט) בדף Resource Manager.
   2. יוצרים מפתח API חדש. אפשר לעשות זאת בדף Credentials. לוחצים על Create credentials ואז על API key.

אחרי שמאתרים את הפרויקט ב-Cloud Console, בודקים אם מצורף חשבון לחיוב בקטע Billing בתפריט שבצד ימין.

לא, לפרויקט שלי לא מצורף חשבון לחיוב.

נכנסים לדף Enable Billing במסוף Cloud ומוסיפים לפרויקט חשבון לחיוב. מידע נוסף זמין במאמר תחילת השימוש בפלטפורמה של מפות Google.

כן, לפרויקט שלי מצורף חשבון לחיוב.

נהדר! עלינו לוודא שאמצעי החיוב שסיפקת תקין.

האם אמצעי החיוב שסיפקת כבר לא בתוקף (לדוגמה, כרטיס אשראי שפג תוקפו)?

אפשר להוסיף, להסיר ולעדכן אמצעי תשלום במסוף Cloud.

האם יש חריגה מהמגבלה היומית של ה-API?

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

אפשר לבדוק את המגבלות היומיות ב-APIs & Services Dashboard במסוף Cloud. משם:

1. אם מוצגת הנחיה, בוחרים פרויקט.
2. בוחרים ממשק API מהרשימה ולאחר מכן לוחצים על הכרטיסייה Quotas.

האם במפתח ה-API יש הגבלה על כתובות IP?

ניתן להשתמש במפתחות API עם הגבלה על כתובות IP רק בשירותי אינטרנט שמיועדים לשימוש מצד השרת (כמו Geocoding API וממשקי API אחרים של שירותי אינטרנט). לרוב שירותי האינטרנט האלה יש שירותים מקבילים בתוך Maps JavaScript API (לדוגמה, ניתן לעיין ב-Geocoding Service). כדי להשתמש בשירותים בצד הלקוח של Maps JavaScript API, צריך ליצור מפתח API נפרד שניתן לאבטח באמצעות הגבלה של גורמים מפנים מסוג HTTP (מידע נוסף זמין במאמר קבלה, הוספה והגבלה של מפתח 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, עליך להשתמש בפרמטר 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. פרטים נוספים זמינים במסוף Cloud.
RefererDeniedMapError	שגיאה	האפליקציה שלך נחסמה עקב אי-תאימות לתנאים ולהגבלות של הפלטפורמה של מפות Google בעקבות כמה התראות באימייל. כדי לערער על החסימה ולבדוק את ההטמעה, צריך למלא את הטופס הזה. תקבלו תשובה באימייל תוך מספר ימי עסקים.
RefererNotAllowedMapError	שגיאה	כתובת האתר הנוכחית שטוענת את API JavaScript של מפות Google לא נוספה לרשימת הגורמים המפנים המותרים. עליך לבדוק את הגדרות הגורם המפנה של מפתח ה-API במסוף Cloud. אפשר לעיין ב-API של Maps JavaScript ולקבל מפתח API.
OverQuotaMapError	שגיאה	מספר הבקשות חרג ממגבלות השימוש של Maps JavaScript API. הבקשות של האפליקציה שלך יחזרו לפעול באיפוס המכסה היומית הבאה. אם אינך הבעלים של האתר, אין פעולות שאפשר לבצע כדי לתקן את השגיאה הזו. עם זאת, מומלץ להודיע לבעלים של האתר אם אפשר. לפרטים נוספים אפשר לעיין במדריך בנושא מגבלות שימוש. בדף מוסבר גם איך אפשר להחיל מגבלות שימוש גבוהות יותר.
ApiProjectMapError	שגיאה	לא הצלחנו לפענח את מפתח ה-API שסופק או את פרויקט ה-API שאליו הוא משויך. ייתכן שזו שגיאה זמנית. אם הודעת השגיאה ממשיכה להופיע, יכול להיות שצריך לקבל מפתח API חדש או ליצור פרויקט API חדש. מידע נוסף זמין במאמר תחילת השימוש בפלטפורמה של מפות Google.
ClientIdLooksLikeCryptoKey	אזהרה	יכול להיות שסיפקת מפתח קריפטוגרפי בפרמטר client. אם יש לך רישיון בתוכנית Premium או ממשקי Maps API for Work, עליך לציין את מזהה הלקוח כפרמטר client. אין צורך להשתמש במפתח הקריפטוגרפי עבור Maps JavaScript API. מומלץ לעיין במדריך למזהי לקוחות ללקוחות של תוכנית Premium ושל ממשקי Maps API for Work.
ClientIdLooksLikeKey	אזהרה	יכול להיות שסיפקת מפתח API בפרמטר client. אם יש לך רישיון בתוכנית Premium או ממשקי Maps API for Work, עליך לציין את מזהה הלקוח כפרמטר client. אם יש לך תוכנית פרימיום של הפלטפורמה של מפות Google, אפשר להשתמש בפרמטר client או בפרמטר key. אם אין לך רישיונות, עליך להשתמש בפרמטר key במקום בפרמטר client . אפשר להיעזר במדריך לאימות תוכנית Premium.
InvalidChannel	אזהרה	יכול להיות שסיפקת פרמטר channel לא חוקי. הערוץ חייב להיות מחרוזת אלפאנומרית של ASCII, שעשויה לכלול נקודה (.), קו תחתון (_) ומקף (-). עליך לוודא שציינת פרמטר channel חוקי. למידע נוסף, אפשר לעיין בקטע דיווח | תוכנית הפרימיום של הפלטפורמה של מפות Google.
InvalidClientId	אזהרה	נראה שהפרמטר client לא מכיל מזהה לקוח נכון. מזהה לקוח צריך להתחיל ב-'gme- '. אפשר להיעזר במדריך לאימות תוכנית 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	אזהרה	יכול להיות שסיפקת מפתח קריפטוגרפי או סוד חתימה כפרמטר key. אם יש לך רישיון בתוכנית Premium או ממשקי Maps API 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, לוחצים על הלחצן שלמטה ומתחילים את התהליך. תחילת העבודה אם תטען את ממשק ה-API של JavaScript של מפות Google מנתיב v2 שהוצא משימוש, תופיע האזהרה NoApiKeys, גם אם ציינת את הפרמטר key. מומלץ לעיין במדריך לשדרוג מגרסאות v2 ל-v3 ומעבירים את האפליקציה אל Maps JavaScript API v3.
RetiredVersion	אזהרה	ייתכן שסיפקת גרסה שיצאה משימוש ברכיב הסקריפט שלך. כדי להשתמש באחת מהגרסאות הזמינות צריך לעדכן את האפליקציה. אפשר לעיין בקטע ניהול גרסאות | API של JavaScript במפות Google.
SensorNotRequired	אזהרה	הפרמטר sensor לא נדרש יותר עבור Maps JavaScript API. זה לא ימנע מה-API של JavaScript במפות Google לפעול בצורה תקינה, אבל מומלץ להסיר את הפרמטר sensor מרכיב הסקריפט.
SignatureNotRequired	אזהרה	הפרמטר signature לא נדרש עבור Maps JavaScript API. זה לא ימנע מ-מפות JavaScript API לפעול בצורה תקינה, אבל הוא עלול ליצור סיכוני אבטחה. יש להסיר אותו מרכיב הסקריפט.
SignedInNotSupported	אזהרה	הפרמטר signed_in הוצא משימוש ואינו נתמך בגרסה של Maps JavaScript API שבו אתה משתמש. הפעולה הזו לא תמנע מה-API של JavaScript במפות Google לפעול, אבל אופן הפעולה של האפליקציה עשוי להשתנות אם מסתמכים על תכונות שמחוברות לחשבון.
UrlAuthenticationCommonError	שגיאה	אירעה שגיאה שאינה מתאימה לקטגוריות האחרות בדף הזה. הסיבה לכך יכולה להיות בעיה זמנית. יש לנסות שוב לבצע את הבקשה לאחר עיכוב קצר. אם הפעולה לא פותרת את הבעיה, אפשר לעיין במדריך למפתחים כדי לוודא שפורמט הבקשה נכון.

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

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

• מסוף האינטרנט עבור Firefox.
• ניפוי באגים מרחוק ב-Android.
• Web Inspector (סוקר האינטרנט) ל-iOS.

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