הודעות שגיאה ב-Maps Static API

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

בקשות לא חוקיות

במקרה של בקשה לא חוקית, ה-Maps Static API מחזיר קוד סטטוס HTTP‏ 4xx והודעה שמתארת את הבעיה. בהמשך מפורטות דוגמאות לתנאי שגיאה כאלה. הערה: המקור הזה הוא לא רשימה מלאה של השגיאות האפשריות. כדי לקבל פרטים על בעיות ספציפיות, צריך לבדוק את קוד השגיאה ואת ההודעה בפועל שמוחזרים על ידי ה-API.

דוגמה למצב שגיאה קוד סטטוס
הבקשה כוללת פרמטר לא חוקי, או שפרמטר נדרש חסר. לדוגמה, הפרמטר size לא נמצא בטווח הצפוי של ערכים מספריים, או שהוא חסר בבקשה. 400 BAD REQUEST
מפתח ה-API שנכלל בבקשה לא תקין. 403 FORBIDDEN

שגיאות שמונעות את הצגת המפה

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

תמונת שגיאה מוצגת במקום מפה
איור: תמונת שגיאה שמוצגת במקום מפה

אם משתמשים ב-Maps Static API ללא מפתח API, או אם החיוב לא מופעל בחשבון, בדף יוצג תמונת שגיאה במקום מפה, עם קישור שמציין את סוג השגיאה. לדוגמה 'g.co/staticmaperror/key'.

שגיאות ופתרונות ללא מפתח
שגיאה בנושא מגבלות שימוש: חרגת ממגבלת הטעינות היומיות של המפה השתמשת ב-API הסטטי של מפות Google ללא מפתח API. כדי לפתור את הבעיה:
  1. קבלת מפתח API
  2. הפעלת החיוב
  3. חתימה על כתובת ה-URL
שגיאה בנושא מגבלות שימוש: חסרה חתימה דיגיטלית בכתובות ה-URL של הבקשה בבקשה שלך חסרה חתימה דיגיטלית (חובה). כדי לפתור את הבעיה, צריך לחתום על כתובת ה-URL.

אזהרות

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

  • אחת – המפה מוצגת, אבל עם סרגל שגיאות צהוב מעליה. בחלק העליון של המפה עם הכיתוב 'שגיאה במפה: g.co/staticmaperror'.
  • שתיים, ה-API מחזיר אזהרה הפורמט של כותרת HTTP בשם X-Staticmap-API-Warning.

לדוגמה, כתובת ה-URL הבאה מכילה ערך לא צפוי בקובץ ה-URL הפרמטר markers:

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY

ה-API מחזיר מפה, אבל מעליה מוצג סרגל שגיאות צהוב מעל התמונה עם הכיתוב 'שגיאה במפה: g.co/staticmaperror':

מוצגות במפה, אבל עם שגיאת מפה: g.co/staticmaperror

ה-API מחזיר גם את כותרת ה-HTTP הבאה:

X-Staticmap-API-Warning:Error geocoding: marker 1

בטבלה הבאה מתוארות האזהרות שה-API עשוי להפיק כ-HTTP כותרות:

אזהרות בכותרות של X-Staticmap-API-Warning
Error geocoding: [center, ][marker #number, ][visible #num, ][path #num, ]* אירעה שגיאה במהלך הניסיון לבצע קידוד גיאוגרפי של הבקשה. יש הרבה וריאציות של ההודעה, בהתאם לרכיב שבו אפשר לבצע קידוד גיאוגרפי נכשל (מרכז, סמן, גלוי או נתיב) ומספר הרכיבים שנכשל. דוגמה לאזהרה הזו היא הערך X-Staticmap-API-Warning:Error geocoding: marker 1, כפי שמוצג בדוגמה שלמעלה.
Too many geocoded markers requested (max is 15). הבקשה מציינת יותר מהמספר המקסימלי המותר של סמנים עם כתובת שבודק אנושי יכול לקרוא. המספר המקסימלי הוא 15. שימו לב שהמגבלה הזו חלה רק על סמנים שצוינו ככתובת קריאה לאנשים דורש קידוד גיאוגרפי. הוא לא חל על סמנים שצוינו באמצעות קואורדינטות של קו אורך וקו רוחב.
Too many geocoded polyline vertices requested (max is 15). הבקשה כוללת יותר מהמספר המקסימלי המותר של קווים פוליגונליים עם כתובת שניתנת לקריאה על ידי בני אדם. המספר המקסימלי הוא 15. חשוב לציין שהמגבלה הזו חלה רק על קווים פוליגונליים עם קודקודים שצוינו ככתובות שניתנות לקריאה על ידי בני אדם, שדורשות גיאוקודינג. הוא לא חל על קווים פוליגונליים שצוינו באמצעות קואורדינטות של קו אורך וקו רוחב.

אפשר לראות את האזהרות בכותרת ה-HTTP מסוף כלי הפיתוח ל-Chrome, Firefox Web Console או כלים מקבילים אחרים בדפדפן.