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

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

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