آشنایی با اعتبارسنجی مسیر

پس‌از ایجاد مسیر، Roads Selection API فرایند اعتبارسنجی را انجام می‌دهد. این اعتبارسنجی تضمین می‌کند که مسیر برای جمع‌آوری داده و به‌روزرسانی در «بینش‌های تحلیلی مدیریت راه‌ها» مناسب است. این فرایند معمولاً ظرف چند دقیقه تکمیل می‌شود.

می‌توانید وضعیت اعتبارسنجی مسیرهایتان را ازطریق فیلد state در پاسخ میانای برنامه‌سازی کاربردی پایش کنید. می‌توانید این موضوع را بااستفاده از نقطه پایانی 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 باشد، پاسخ میانای برنامه‌سازی کاربردی شامل فیلد validationError است. این فیلد دلیل خاصی برای ناموفق بودن اعتبارسنجی ارائه می‌دهد.

فیلد validationError می‌تواند مقادیر زیر را داشته باشد:

• VALIDATION_ERROR_UNSPECIFIED: خطای اعتبارسنجی برای این مسیر تنظیم نشده است.
• ‫VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: مسیر خارج از حوزه قضایی مجاز پروژه شما است.
• ‫VALIDATION_ERROR_LOW_ROAD_USAGE: استفاده از جاده در این مسیر کم است، یعنی داده‌های ترافیک کافی برای تحلیل معنادار جمع‌آوری نمی‌شود. مسیری که به‌دلیل استفاده کم از جاده نامعتبر طبقه‌بندی شده است، اگر حجم ترافیک از آستانه ازپیش تعیین‌شده بیشتر شود، ممکن است دوباره معتبر شود. در مسیر با استفاده کم از جاده بیشتر بدانید.

مسیر با استفاده کم از جاده

اگر API تشخیص دهد که داده‌های ترافیک کافی برای تحلیل منسجم وجود ندارد، ممکن است مسیرها با VALIDATION_ERROR_LOW_ROAD_USAGE پرچم‌گذاری شوند. این اتفاق ممکن است درطول اعتبارسنجی اولیه یا درطول ارزیابی‌های مداوم رخ دهد.

در اینجا آنچه را که باید برای مسیرهایی با استفاده کم از جاده انتظار داشته باشید آورده‌ایم:

• انتشار داده‌ها در BigQuery ادامه می‌یابد: حتی اگر مسیری به‌دلیل استفاده کم از جاده به‌عنوان STATE_INVALID طبقه‌بندی شود، API همچنان به پردازش و انتشار داده‌های دردسترس برای آن مسیر در BigQuery ادامه می‌دهد.
• به‌روزرسانی‌های Pub/Sub متوقف می‌شود: اگر state مسیر به STATE_INVALID تغییر کند، به‌روزرسانی‌های هم‌زمان دوره‌ای Pub/Sub متوقف می‌شود.
• ارزیابی‌های فصلی: میانای برنامه‌سازی کاربردی ارزیابی‌های فصلی را برای همه مسیرهای فعال ازنظر حجم ترافیک انجام می‌دهد.
  • اگر ترافیک کم درطول ارزیابی شناسایی شود، 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 تغییر کند اگر ترافیک درطول زمان افزایش یابد، همان‌طور که در مسیر با استفاده کم از جاده توضیح داده شده است.