فهم عملية التحقّق من صحة المسار

بعد إنشاء مسار، تنفّذ Roads Selection API عملية تحقّق من الصحة. يضمن هذا التحقّق من الصحة أنّ المسار مناسب لجمع البيانات وتعديلها ضمن Roads Management Insights. تكتمل العملية عادةً في غضون بضع دقائق.

يمكنك مراقبة حالة التحقّق من صحة مساراتك من خلال الـ state في استجابة واجهة برمجة التطبيقات. يمكنك التحقّق من ذلك باستخدام نقطة النهاية get، كما هو موضّح في الحصول على المسارات المحدّدة، أو من خلال فحص جدول routes_status في BigQuery.

حالات المسار

يشير الحقل state في مورد SelectedRoute إلى حالة التحقّق من الصحة والحالة التشغيلية الحالية. يمكن أن يتضمّن حقل state القيم التالية:

  • STATE_UNSPECIFIED: لم يتم ضبط حالة التحقّق من صحة هذا المسار.
  • STATE_VALIDATING: يتم التحقّق من صحة المسار.
  • STATE_RUNNING: اجتاز المسار عملية التحقّق من الصحة بنجاح وأصبح نشطًا الآن. تجمع واجهة برمجة التطبيقات البيانات بنشاط وترسل تعديلات دورية لهذا المسار إلى 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: يشهد المسار استخدامًا منخفضًا للطريق، ما يعني أنّه لا يمكن جمع بيانات كافية عن الزيارات لإجراء تحليل مفيد. قد يصبح المسار الذي تم تصنيفه على أنّه غير صالح بسبب انخفاض استخدام الطريق صالحًا مرة أخرى إذا زاد حجم الزيارات عن حدّ معيّن. مزيد من المعلومات في مقالة المسار الذي يشهد استخدامًا منخفضًا للطريق.

المسار الذي يشهد استخدامًا منخفضًا للطريق

قد يتم وضع علامة على المسارات باستخدام VALIDATION_ERROR_LOW_ROAD_USAGE إذا رصدت واجهة برمجة التطبيقات أنّه لا تتوفّر بيانات كافية عن الزيارات لإجراء تحليل متّسق. يمكن أن يحدث ذلك أثناء التحقّق الأولي من الصحة أو أثناء التقييمات المستمرة.

في ما يلي ما يمكن توقّعه للمسارات التي تشهد استخدامًا منخفضًا للطريق:

  • يستمر نشر البيانات في BigQuery: حتى إذا تم تصنيف المسار على أنّه STATE_INVALID بسبب انخفاض استخدام الطريق، تواصل واجهة برمجة التطبيقات معالجة أي بيانات متاحة لهذا المسار ونشرها في BigQuery.
  • تتوقف تعديلات Pub/Sub: تتوقف التعديلات الدورية في الوقت الفعلي على Pub/Sub إذا تغيّرت state المسار إلى STATE_INVALID.
  • التقييمات الفصلية: تجري واجهة برمجة التطبيقات تقييمات فصلية لجميع المسارات النشطة من حيث حجم الزيارات.
    • إذا تم رصد عدد قليل من الزيارات أثناء التقييم، ستعرض واجهة برمجة التطبيقات تحذيرًا ضمن الـ SelectedRoute مورد.
    • إذا استمر انخفاض عدد الزيارات لأربعة فصول متتالية، ستتغيّر المسار state إلى STATE_INVALID، وستتوقف تعديلات Pub/Sub.
  • إعادة التحقّق من الصحة ممكنة: حتى إذا كانت `state` المسار هي STATE_INVALID، سيظل خاضعًا لتقييمات الزيارات المستمرة. قد تعيد التقييمات اللاحقة تصنيف المسار على أنّه صالح (STATE_RUNNING) إذا زاد حجم الزيارات عن حدّ معيّن.
  • مراقبة الحالة: يمكنك مراقبة حالة التحقّق من صحة المسار من خلال نقطة النهاية get، كما هو موضّح في مقالة الحصول على المسارات المحدّدة، أو من خلال فحص جدول routes_status في BigQuery.

تحديد المشاكل وحلّها في المسارات غير الصالحة

إذا كانت state المسار هي STATE_INVALID، اتّبِع إرشادات تحديد المشاكل وحلّها التالية استنادًا إلى validationError الذي تتلقّاه: