Comprendre la validation des itinéraires

Une fois que vous avez créé un itinéraire, l'API Roads Selection effectue un processus de validation. Cette validation garantit que l'itinéraire est adapté à la collecte et à la mise à jour des données dans Gestion des routes. Le processus prend généralement quelques minutes.

Vous pouvez surveiller l'état de validation de vos itinéraires grâce au champ state de la réponse de l'API. Pour le vérifier, vous pouvez utiliser le point de terminaison get, comme décrit dans Obtenir les itinéraires sélectionnés, ou examiner la table routes_status dans BigQuery.

États de la route

Le champ state d'une ressource SelectedRoute indique son état actuel de validation et opérationnel. Le champ state peut avoir les valeurs suivantes :

• STATE_UNSPECIFIED : l'état de validation de cet itinéraire n'est pas défini.
• STATE_VALIDATING : la route est en cours de validation.
• STATE_RUNNING : l'itinéraire a été validé et est désormais actif. L'API collecte activement des données et envoie des mises à jour périodiques pour cet itinéraire à BigQuery, Pub/Sub ou aux deux.
• STATE_DELETING : La route a été marquée pour suppression et est en cours de suppression du système.
• STATE_INVALID : la validation de la route a échoué en fonction de critères spécifiques. Lorsqu'un itinéraire est en STATE_INVALID, la réponse inclut un champ validationError avec des informations sur la raison de l'échec de la validation.

Erreurs de validation

Lorsque la valeur state d'une ressource SelectedRoute est STATE_INVALID, la réponse de l'API inclut un champ validationError. Ce champ fournit une raison spécifique de l'échec de la validation.

Le champ validationError peut présenter les valeurs suivantes :

• VALIDATION_ERROR_UNSPECIFIED : l'erreur de validation pour cette route n'est pas définie.
• VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION : la route se trouve en dehors de la juridiction autorisée de votre projet.
• VALIDATION_ERROR_LOW_ROAD_USAGE : La route est peu fréquentée, ce qui signifie que nous ne pouvons pas collecter suffisamment de données sur le trafic pour effectuer une analyse pertinente. Un itinéraire classé comme non valide en raison d'une faible utilisation de la route peut redevenir valide si le volume de trafic dépasse un seuil prédéterminé. Pour en savoir plus, consultez Itinéraire à faible utilisation des routes.

Itinéraire à faible utilisation de routes

Les itinéraires peuvent être signalés par VALIDATION_ERROR_LOW_ROAD_USAGE si l'API détermine qu'il n'y a pas assez de données de trafic pour une analyse cohérente. Cela peut se produire lors de la validation initiale ou lors d'évaluations continues.

Voici ce qui se passe pour les itinéraires empruntant des routes peu utilisées :

• La publication des données dans BigQuery se poursuit : même si un itinéraire est classé comme STATE_INVALID en raison d'une faible utilisation de la route, l'API continue de traiter et de publier toutes les données disponibles pour cet itinéraire dans BigQuery.
• Arrêt des mises à jour Pub/Sub : les mises à jour périodiques en temps réel de Pub/Sub cessent si la state de l'itinéraire passe à STATE_INVALID.
• Évaluations trimestrielles : l'API effectue des évaluations trimestrielles du volume de trafic pour toutes les routes actives.
  • Si un faible trafic est détecté lors d'une évaluation, l'API émet un avertissement dans la ressource SelectedRoute.
  • Si le trafic reste faible pendant quatre trimestres consécutifs, la valeur state de l'itinéraire passe à STATE_INVALID et les mises à jour Pub/Sub s'arrêtent.
• Revalidation possible : même si un itinéraire est STATE_INVALID, il reste soumis à des évaluations continues du trafic. Les évaluations ultérieures peuvent reclasser la route comme valide (STATE_RUNNING) si son volume de trafic augmente au-dessus d'un seuil prédéterminé.
• État de la surveillance : vous pouvez surveiller l'état de validation d'un itinéraire via le point de terminaison get, comme décrit dans Obtenir les itinéraires sélectionnés, ou en examinant la table routes_status dans BigQuery.

Résoudre les problèmes liés aux itinéraires non valides

Si votre itinéraire state est STATE_INVALID, suivez les consignes de dépannage ci-dessous en fonction du validationError que vous recevez :

• VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION : cette erreur indique que la route définie s'étend au-delà de la zone géographique autorisée pour votre projet. Pour résoudre ce problème, supprimez l'itinéraire existant et recréez-le en vous assurant que tous ses points (origine, destination et points intermédiaires) se trouvent dans la juridiction de votre projet autorisé.

• VALIDATION_ERROR_LOW_ROAD_USAGE : cette erreur signifie que l'itinéraire sélectionné ne dispose pas de suffisamment de données sur l'utilisation des routes pour permettre une analyse et des mises à jour pertinentes. Pour résoudre ce problème, supprimez l'itinéraire existant et recréez-le en sélectionnant une zone où les routes sont plus utilisées ou plus fréquentées pour la collecte de données. Notez que si votre route présente cette erreur, son état peut redevenir STATE_RUNNING si le trafic augmente au fil du temps, comme décrit dans Route à faible utilisation de la route.