פתרון בעיות

שגיאות

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

התשובה מכילה אובייקט עם אובייקט error יחיד עם המפתחות הבאים:

• ‫code: זהה לסטטוס ה-HTTP של התגובה.
• ‫message: תיאור קצר של השגיאה.
• ‫status: קוד סטטוס שמציין את אופי השגיאה.

לדוגמה, שליחת פרמטר placeId לא תקין תחזיר את השגיאה הבאה:

{
  "error": {
    "code": 400,
    "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"",
    "status": "INVALID_ARGUMENT"
  }
}

השגיאות האפשריות כוללות:

השהיה מעריכית לפני ניסיון חוזר (exponential backoff)

אם הבקשות נכשלות, צריך לוודא שאתם מנסים לשלוח אותן שוב עם השהיה מעריכית לפני ניסיון חוזר (exponential backoff). לדוגמה, אם בקשה נכשלת פעם אחת, צריך לנסות שוב אחרי שנייה. אם היא נכשלת שוב, צריך לנסות שוב אחרי שתי שניות, ואז אחרי ארבע שניות וכן הלאה. כך נמנע מצב שבו בקשות פגומות או כשלים נרחבים יציפו את השרתים של Google, כי הרבה לקוחות מנסים לשלוח מחדש בקשות במהירות רבה.

שאלות נפוצות על פתרון בעיות

בעיות יישום

באיזו תדירות כדאי לדגום את מיקום הרכב?

מומלץ להשתמש בערך של 1-10 שניות כדי לקבל תוצאות באיכות גבוהה של הצמדה לכביש.

האם יש הגבלה על מספר הנקודות שאפשר לשלוח בכל שאילתה?

כן, שאילתה יכולה לכלול עד 100 נקודות.

באיזו רמת דיוק כדאי להשתמש כדי לאחסן את זוגות קווי הרוחב והאורך שמוצמדים למיקום?

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

האם אפשר להשתמש בקווים פוליגוניים מקודדים כדי להציג נתיבים שמוצמדים לכבישים?

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

בעיות נפוצות

חלק מהנקודות לא נצמדות, או שיש לי פערים בנתיבים שנצמדו. איך אפשר לתקן את זה?

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

למה כשמגדילים את התצוגה, הנתיבים המחוברים נראים משוננים או לא בדיוק על הכביש?

• האם אתה חותך את הדיוק של זוגות קווי הרוחב והאורך שהוצגו לפני שאתה מציג אותם? שמירה של זוגות של קווי אורך וקווי רוחב שמוצמדים במיקום עם דיוק של פחות מ-7 ספרות אחרי הנקודה העשרונית גורמת לשגיאות דיוק כשנתיב ההצמדה מוצג במפה.
• האם אתם משתמשים בקווים פוליגוניים מקודדים? פוליגונים מקודדים חותכים זוגות של קווי רוחב ואורך ל-5 מקומות אחרי הנקודה העשרונית, מה שיוצר שגיאה של כמה מטרים. כתוצאה מכך, הקווים משוננים או מעט לא מדויקים ברמות זום גבוהות.

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

מה יכול לגרום להצגה שגויה של מגבלת המהירות בכביש X?

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

1. פותחים את מפות Google במחשב או את אפליקציית מפות Google ל-Android.
2. פותחים את תפריט הצד השמאלי.
3. לוחצים על שליחת משוב. הערה: יכול להיות שתתבקשו להתחבר לחשבון.
4. לוחצים על עריכת המפה.
5. בוחרים את קטע הכביש שרוצים לערוך.
6. לוחצים על הבא.
7. בשדה 'אחר', מציינים שהמהירות המותרת בכביש הזה שגויה.
8. לוחצים על שליחה.

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

למה הנתיב המצולם שלי חותך פינות במקום לעקוב אחרי הכביש?

כדי לפתור את הבעיה, צריך לבדוק את הדברים הבאים:

• ודאו שהפרמטר interpolate מוגדר ל-true.
• צריך לוודא שהמערכת דוגמת את נקודות הנתונים המקוריות במרווחי זמן קצרים מספיק (כל שנייה עד 10 שניות).

למה מקבלים הרבה קטעי דרך בנתיב המצמיד עבור דרך ללא שינויים במגבלת המהירות?

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