اعتبار سنجی مسیر را درک کنید

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

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

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

اگر 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 ، همانطور که در Get Selected Routes توضیح داده شده است، یا با بررسی جدول routes_status در BigQuery نظارت کنید.

عیب یابی مسیرهای نامعتبر

اگر state مسیر شما STATE_INVALID است، دستورالعمل‌های عیب‌یابی بعدی را براساس خطای validationError که دریافت می‌کنید دنبال کنید:

  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION : این خطا نشان می دهد که مسیر تعریف شده فراتر از منطقه جغرافیایی مجاز برای پروژه شما است. برای رفع این مشکل، مسیر موجود را حذف کرده و مسیر را دوباره ایجاد کنید، مطمئن شوید که تمام نقاط آن (مبدع، مقصد و هر واسطه) در صلاحیت پروژه مجاز شما هستند.

  • VALIDATION_ERROR_LOW_ROAD_USAGE : این خطا به این معنی است که مسیر انتخابی داده‌های استفاده از جاده کافی برای تجزیه و تحلیل و به‌روزرسانی معنادار ندارد. برای رفع این مشکل، مسیر موجود را حذف کنید و مسیر را دوباره ایجاد کنید و منطقه ای را با استفاده از جاده بالاتر یا "مشغله" برای جمع آوری داده ها انتخاب کنید. توجه داشته باشید که اگر مسیر شما دارای این خطا باشد، وضعیت مسیر می‌تواند به STATE_RUNNING تغییر کند، اگر ترافیک در طول زمان افزایش یابد همانطور که در مسیر استفاده کم از جاده توضیح داده شده است.