פתרון בעיות

תזכורת: כדי להשתמש ב-Maps JavaScript API:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

כדי לבדוק את המגבלות היומיות, נכנסים למרכז הבקרה של השירותים וממשקי ה-API במסוף Cloud. אחרי שנכנסים:

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

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

אפשר להשתמש במפתחות API עם הגבלה של כתובות IP רק בשירותי אינטרנט שמיועדים לשימוש בצד השרת (כמו Geocoding API וממשקי API אחרים של שירותי אינטרנט). לרוב שירותי האינטרנט האלה יש שירותים מקבילים ב-Maps JavaScript API (לדוגמה, שירות המרת כתובות לקואורדינטות (geocoding)). כדי להשתמש בשירותים בצד הלקוח של Maps JavaScript API, צריך ליצור מפתח API נפרד שאפשר לאבטח באמצעות הגבלה של גורמים מפנים מסוג HTTP (מידע נוסף זמין במאמר קבלת מפתח API, הוספה שלו והגבלת השימוש בו).

אם הקוד לא עובד:

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

• מחפשים שגיאות הקלדה. חשוב לזכור ש-JavaScript היא שפה תלויית אותיות רישיות.
• בודקים את הדברים הבסיסיים – חלק מהבעיות הנפוצות ביותר מתרחשות במהלך היצירה הראשונית של המפה. למשל:
  • מוודאים שציינתם את המאפיינים zoom ו-center באפשרויות המפה.
  • מוודאים שהצהרתם על רכיב div שבו המפה תופיע במסך.
  • מוודאים שלרכיב div של המפה יש גובה CSS מפורש שאינו אפס (לדוגמה, height: 400px). כברירת מחדל, רכיבי div נוצרים עם גובה 0, ולכן הם לא גלויים.
  אפשר לעיין בדוגמאות שלנו להטמעה לדוגמה.
• כדי לזהות בעיות, אפשר להשתמש ב-JavaScript debugger, כמו הכלי שזמין בכלים למפתחים ב-Chrome. קודם כל, בודקים אם יש שגיאות בלוח JavaScript, כמו InvalidKeyMapError או ApiNotActivatedMapError, ופותרים אותן לפי ההוראות במדריך הודעות שגיאה.
• לפרסם שאלות ב-Stack Overflow. בדף התמיכה מפורטות הנחיות לניסוח שאלות טובות.