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

بعد إنشاء مسار، تنفّذ 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_INVALID، سيظل خاضعًا لعمليات تقييم مستمرة لحركة المرور. وقد تؤدي التقييمات اللاحقة إلى إعادة تصنيف المسار على أنّه صالح (STATE_RUNNING) إذا زاد حجم حركة البيانات فيه عن الحدّ الأدنى المحدّد مسبقًا.
• مراقبة الحالة: يمكنك مراقبة حالة التحقّق من صحة مسار من خلال نقطة النهاية get، كما هو موضّح في الحصول على مسارات محدّدة، أو من خلال فحص جدول routes_status في BigQuery.

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

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

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

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