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

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

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

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

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

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

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

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

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

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

אזהרות

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

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

לדוגמה, כתובת ה-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 או בכלים מקבילים אחרים בדפדפן.