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

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

يمكنك تتبُّع حالة التحقّق من صحة مساراتك من خلال 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 الذي تتلقّاه:

• VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: يشير هذا الخطأ إلى أنّ المسار المحدّد يمتد خارج المنطقة الجغرافية المفوّضة لمشروعك. لحلّ هذه المشكلة، احذف المسار الحالي وأعِد إنشاءه، مع التأكّد من أنّ جميع نقاطه (المصدر والوجهة وأي نقاط وسيطة) تقع ضمن نطاق السلطة القضائية لمشروعك المفوّض.

• VALIDATION_ERROR_LOW_ROAD_USAGE: يعني هذا الخطأ أنّ المسار المحدّد لا يتضمّن بيانات كافية عن استخدام الطريق لإجراء تحليل وتعديلات مفيدة. لحلّ هذه المشكلة، احذف المسار الحالي وأعِد إنشاءه، مع اختيار منطقة تشهد استخدامًا أعلى للطريق أو "مدى الازدحام" لجمع البيانات. يُرجى العِلم أنّه إذا كان مسارك يتضمّن هذا الخطأ، يمكن أن تتغيّر حالة المسار مرة أخرى إلى STATE_RUNNING إذا ارتفعت الزيارات بمرور الوقت كما هو موضّح في مقالة المسار الذي يشهد استخدامًا منخفضًا للطريق.