הודעת אבטחה: נודע לנו על בעיית אבטחה שעשויה להשפיע על אתרים שמשתמשים בספריות ספציפיות של צד שלישי (כולל polyfill.io). בעיה זו עלולה לפעמים להפנות מבקרים אל מחוץ לאתר המיועד ללא ידיעתו או אישור של בעלי האתר. רבות מדוגמאות ה-JavaScript שלנו כללו בעבר הצהרה של סקריפט polyfill.io. הסרנו את הדוגמאות האלה מהדוגמאות. אם השתמשת בדוגמאות JavaScript שלנו שמכילות את ההצהרה הזו, מומלץ להסיר את ההצהרה.

דף זה תורגם על ידי Cloud Translation API.

הודעות שגיאה

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

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

פתרון בעיות

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

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

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

אין לי מושג איך אפשר לבדוק אם משתמשים במפתח API?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

אפשר להשתמש במפתחות API עם הגבלה על כתובות IP רק בשירותי אינטרנט שנועדו לשימוש בצד השרת (כמו Geocoding API וממשקי API אחרים של שירותי אינטרנט). לרוב שירותי האינטרנט האלה יש שירותים מקבילים ב-Maps JavaScript API (לדוגמה, שירות המרת כתובות לקואורדינטות). כדי להשתמש בשירותים של Maps JavaScript API בצד הלקוח, צריך ליצור מפתח API נפרד שאפשר לאבטח באמצעות הגבלה על גורמים מפנים מסוג HTTP (ראו איך מקבלים, מוסיפים ומגבילים מפתח 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 מורשות.

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 בדפדפנים אחרים.

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 שמקושר מההודעה.

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

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

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

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

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

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

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