פתרון בעיות

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

בנסיבות מסוימות, ייתכן שתוצג מפה כהה או תמונה 'שלילית' של Street View עם סימן מים עם הכיתוב 'לצורכי פיתוח בלבד'. בדרך כלל, התנהגות כזו מעידה על בעיות במפתח API או בחיוב. כדי להשתמש במוצרים של הפלטפורמה של מפות Google, צריך להפעיל את החיוב בחשבון, וכל הבקשות צריכות לכלול מפתח 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 שלכם. 
      <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, לוחצים על הלחצן שלמטה. אם לא מופיעה הנחיה להגדרה, פועלים לפי ההוראות המלאות במאמר תחילת העבודה עם הפלטפורמה של מפות Google.
תחילת העבודה

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

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

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

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

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

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

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

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

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

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

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

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

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

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