הסבר על אימות מסלולים

אחרי שיוצרים מסלול, Roads Selection API מבצע תהליך אימות. האימות הזה מבטיח שהמסלול מתאים לאיסוף נתונים ולעדכונים ב"תובנות לניהול נתוני דרכים". התהליך בדרך כלל מסתיים תוך כמה דקות.

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

מצבי מסלול

השדה state במשאב SelectedRoute מציין את סטטוס האימות והפעילות הנוכחי שלו. השדה state יכול להכיל את הערכים הבאים:

  • STATE_UNSPECIFIED: מצב האימות של המסלול הזה לא מוגדר.
  • ‫STATE_VALIDATING: המסלול בתהליך אימות.
  • ‫STATE_RUNNING: המסלול עבר את האימות ועכשיו הוא פעיל. ה-API אוסף נתונים באופן פעיל ושולח עדכונים תקופתיים לגבי המסלול הזה ל-BigQuery, ל-Pub/Sub או לשניהם.
  • ‫STATE_DELETING: המסלול סומן למחיקה והוא מוסר מהמערכת.
  • ‫STATE_INVALID: האימות של המסלול נכשל על סמך קריטריונים ספציפיים. כשהמסלול נמצא במצב STATE_INVALID, התשובה כוללת את השדה validationError עם פרטים על הסיבה לכך שהאימות נכשל.

שגיאות אימות

כשהערך של state במשאב SelectedRoute הוא STATE_INVALID, התגובה מה-API כוללת את השדה validationError. בשדה הזה מופיעה הסיבה הספציפית לכך שהאימות נכשל.

השדה validationError יכול להכיל את הערכים הבאים:

  • ‫VALIDATION_ERROR_UNSPECIFIED: שגיאת האימות של המסלול הזה לא מוגדרת.
  • ‫VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: המסלול נמצא מחוץ לתחום השיפוט המורשה של הפרויקט.
  • ‫VALIDATION_ERROR_LOW_ROAD_USAGE: השימוש בכביש נמוך, כלומר אי אפשר לאסוף מספיק נתוני תנועה כדי לבצע ניתוח משמעותי. מסלול שסווג כלא חוקי בגלל שימוש מועט בכביש יכול להפוך שוב לחוקי אם נפח התנועה יעלה מעל לסף שנקבע מראש. מידע נוסף על מסלול עם שימוש מועט בכבישים

מסלול עם שימוש מועט בכבישים

יכול להיות שהמסלולים יסומנו ב-VALIDATION_ERROR_LOW_ROAD_USAGE אם ה-API יקבע שאין מספיק נתוני תנועה לניתוח עקבי. זה יכול לקרות במהלך האימות הראשוני או במהלך הערכות שוטפות.

מה קורה במסלולים עם שימוש נמוך בכביש:

  • פרסום הנתונים ב-BigQuery נמשך: גם אם קטע כביש מסווג כ-STATE_INVALID בגלל שימוש מועט, ה-API ממשיך לעבד ולפרסם ב-BigQuery את כל הנתונים הזמינים לגבי קטע הכביש הזה.
  • הפסקת העדכונים של Pub/Sub: העדכונים התקופתיים בזמן אמת ל-Pub/Sub מפסיקים אם הערך של state של המסלול משתנה ל-STATE_INVALID.
  • הערכות רבעוניות: ה-API מבצע הערכות רבעוניות של כל המסלולים הפעילים לנפח התנועה.
    • אם ה-API מזהה נפח תנועה נמוך במהלך הבדיקה, הוא מציג אזהרה במשאב SelectedRoute.
    • אם נפח התנועה הנמוך נמשך במשך ארבעה רבעונים רצופים, הערך של state של הנתיב משתנה ל-STATE_INVALID, והעדכונים של Pub/Sub מפסיקים.
  • אפשר לבצע אימות מחדש: גם אם המסלול הוא STATE_INVALID, הוא עדיין כפוף להערכות תנועה שוטפות. בבדיקות הבאות, יכול להיות שהנתיב יסווג מחדש כתקין (STATE_RUNNING) אם נפח התנועה שלו יעלה מעל לסף שנקבע מראש.
  • מעקב אחרי הסטטוס: אתם יכולים לעקוב אחרי סטטוס האימות של המסלול באמצעות נקודת הקצה get, כמו שמתואר בקטע קבלת המסלולים שנבחרו, או על ידי בדיקת הטבלה routes_status ב-BigQuery.

פתרון בעיות במסלולים לא תקינים

אם הנתיב state הוא STATE_INVALID, פועלים לפי ההנחיות הבאות לפתרון בעיות בהתאם ל-validationError שמתקבל:

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

  • ‫VALIDATION_ERROR_LOW_ROAD_USAGE: השגיאה הזו מציינת שבמסלול שנבחר אין מספיק נתוני שימוש בכביש כדי לבצע ניתוח ועדכונים משמעותיים. כדי לפתור את הבעיה, צריך למחוק את המסלול הקיים וליצור אותו מחדש, ולבחור אזור עם שימוש גבוה יותר בכבישים או "מידת העומס" לאיסוף נתונים. שימו לב: אם במסלול שלכם יש את השגיאה הזו, הסטטוס של המסלול יכול להשתנות בחזרה ל-STATE_RUNNING אם התנועה תגדל עם הזמן, כמו שמתואר בקטע מסלול עם שימוש מועט בכביש.