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 permet de s'assurer que l'itinéraire est adapté à la collecte de données et aux mises à jour dans les insights de Gestion des routes. Le processus prend généralement quelques minutes.

Vous pouvez surveiller l'état de validation de vos routes via le champ state de la réponse de l'API. Pour le vérifier, utilisez le point de terminaison get, comme décrit dans Obtenir les routes sélectionnées, ou examinez la table routes_status dans BigQuery.

États des routes

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

• STATE_UNSPECIFIED : l'état de validation de cette route n'est pas défini.
• STATE_VALIDATING : la route est en cours de validation.
• STATE_RUNNING : la route a bien été validée et est désormais active. L'API collecte activement des données et envoie des mises à jour périodiques pour cette route vers BigQuery, Pub/Sub ou les 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 l'itinéraire a échoué en fonction de critères spécifiques. Lorsqu'une route est à l'état STATE_INVALID, la réponse inclut un champ validationError contenant des détails sur l'échec de la validation.

Erreurs de validation

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

Le champ validationError peut avoir les valeurs suivantes :

• VALIDATION_ERROR_UNSPECIFIED : l'erreur de validation de cette route n'est pas définie.
• VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION : l'itinéraire se trouve en dehors de la juridiction autorisée de votre projet.
• VALIDATION_ERROR_LOW_ROAD_USAGE : l'itinéraire est peu fréquenté, ce qui signifie que les données de trafic collectées sont insuffisantes pour permettre une analyse pertinente. Une route classée 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 de la route.

Itinéraire à faible utilisation de la route

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 des évaluations en cours.

Voici ce qui se passe pour les routes peu fréquenté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 le champ state de l'itinéraire passe à STATE_INVALID.
• Évaluations trimestrielles : l'API effectue des évaluations trimestrielles du volume de trafic de toutes les routes actives.
  • Si un trafic faible 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, l'state de la route passe à STATE_INVALID et les mises à jour Pub/Sub s'arrêtent.
• La revalidation est possible : même si une route est STATE_INVALID, elle reste soumise à des évaluations de trafic continues. Les évaluations ultérieures peuvent reclasser la route comme valide (STATE_RUNNING) si son volume de trafic dépasse un seuil prédéterminé.
• État de la surveillance : vous pouvez surveiller l'état de validation d'une route via le point de terminaison get, comme décrit dans Obtenir les routes sélectionnées, ou en examinant la table routes_status dans BigQuery.

Résoudre les problèmes de routes non valides

Si votre route state est STATE_INVALID, suivez les consignes de dépannage suivantes 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 (départ, 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 de la route 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ù l'utilisation de la route ou l'affluence est plus élevée pour la collecte de données. Notez que si votre route présente cette erreur, son état peut revenir à STATE_RUNNING si le trafic augmente au fil du temps, comme décrit dans Route à faible utilisation.