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

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