בנסיבות מסוימות, ייתכן שתוצג מפה כהה או תמונה 'שלילית' של Street View עם סימן מים עם הכיתוב 'לצורכי פיתוח בלבד'.
בדרך כלל, התנהגות כזו מעידה על בעיות במפתח API או בחיוב.
כדי להשתמש במוצרים של הפלטפורמה של מפות Google, צריך להפעיל את החיוב בחשבון, וכל הבקשות צריכות לכלול מפתח API תקין. התהליך הבא יעזור לכם לפתור את הבעיה:
האם אתם משתמשים במפתח API?
לא בטוח. איך אפשר לבדוק אם אתם משתמשים במפתח API?
מפתח API מועבר כפרמטר key בכתובת ה-URL שמשמשת לטעינת API של JavaScript במפות Google. ריכזנו כאן כמה אפשרויות לבדוק אם אתם משתמשים במפתח API:
להשתמש בתוסף Chrome
Google Maps Platform API Checker. כך תוכלו לקבוע אם האתר שלכם מטמיע בצורה נכונה את ממשקי ה-API ברישיון של מפות Google.
אם אתם משתמשים בספרייה או בפלאגין כדי לטעון את Maps JavaScript API, בודקים את ההגדרות של הספרייה ומחפשים אפשרות של מפתח API.
בודקים את השגיאות בדפדפן.
אם מוצגות לכם ההודעות הבאות, סימן שאתם לא משתמשים במפתח ה-API בצורה נכונה:
אם יש לכם גישה לקוד המקור של האפליקציה, חפשו את התג <script> שמשמש לטעינה של Maps JavaScript API.
כשאתם מעמיסים את Maps JavaScript API, מחליפים את הערך YOUR_API_KEY בקוד שלמטה במפתח ה-API שלכם.
בודקים בדפדפן את תעבורת הנתונים ברשת שנוצרת על ידי האתר.
ב-Chrome, אפשר לראות את זה בכרטיסייה רשת בDevTools.
כאן יוצגו בקשות הרשת שנשלחו מהאתר שלכם. בקשות שנשלחות באמצעות API של JavaScript במפות Google יהיו בנתיב maps/api/js.
כאן אפשר לוודא אם הבקשות כוללות את הפרמטר key.
כדאי
לסנן את תעבורת הנתונים ברשת לפי maps/api/js כשמציגים את הכרטיסייה Network.
עוברים לדף
Billing במסוף Google Cloud ובוחרים את הפרויקט שבו נוצר מפתח ה-API.
כדי לוודא שהמפתח משויך לפרויקט:
עוברים לקטע פרטי כניסה. אפשר לגשת לקטע הזה מהסרגל הימני בקטע פלטפורמת מפות Google > פרטי כניסה.
מוודאים שמופיע מפתח ה-API שבו אתם משתמשים כרגע באתר.
אם לא, עוברים לפרויקט אחר ובודקים את פרטי הכניסה שם.
אם אתם לא מצליחים לאתר את הפרויקט של מפתח ה-API, יכול להיות שאבדתם את הגישה לפרויקט הזה.
בקשו עזרה מאנשים אחרים בארגון. אם לא ניתן לאתר את הפרויקט המקורי, צריך:
יוצרים פרויקט חדש. כדי לעשות זאת, בוחרים באפשרות New Project ברשימת הפרויקטים, או באפשרות Create Project דרך הדף Resource Manager.
יוצרים מפתח API חדש. אפשר לעשות זאת בדף Credentials.
לאחר מכן, לוחצים על Create credentials ובוחרים באפשרות API key.
אחרי שמאתרים את הפרויקט במסוף Cloud, עוברים לקטע Billing בתפריט הימני כדי לבדוק אם חשבון לחיוב מצורף אליו.
[null,null,["עדכון אחרון: 2025-03-21 (שעון UTC)."],[[["To use the Google Maps JavaScript API, you must include an API key and enable billing for your project."],["If you see a darkened map or a negative Street View image watermarked with \"for development purposes only\", you might have an issue with your API key or billing."],["Troubleshooting steps involve verifying your API key implementation, checking billing account attachment, ensuring billing method validity, and reviewing daily usage limits and IP restrictions."],["This page offers solutions to common billing and API errors, and links to resources for further assistance."]]],["Using the Maps JavaScript API requires a valid API key and enabled billing. Issues like a darkened map typically stem from these. Verify API key usage via browser checks, source code, or network traffic. Ensure the project linked to your API key has an active billing account. Check for invalid payment methods or exceeded API daily limits. If restricted by IP address, create a key with HTTP referrers. Troubleshoot by checking for typos, verifying map element properties, or using a JavaScript debugger.\n"]]