הודעה: בקרוב תהיה אפשרות להשתמש בסגנון חדש למפות הבסיס בפלטפורמה של מפות Google. העדכון הזה לסגנון המפה כולל ערכת צבעים חדשה שמוגדרת כברירת מחדל, סיכות מודרניות ושיפורים בחוויית השימוש במפה ובממשק שלה. כל סגנונות המפה יעודכנו באופן אוטומטי במרץ 2025. מידע נוסף על הזמינות ועל האופן שבו אפשר להצטרף מוקדם יותר זמין במאמר סגנון מפה חדש בפלטפורמה של מפות Google.

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

פתרון בעיות

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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