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 des données et à la mise à jour dans Insights de gestion des routes. Le processus se termine généralement en quelques minutes.

Vous pouvez surveiller l'état de validation de vos itinéraires à l'aide du state champ dans la réponse de l'API. Pour ce faire, utilisez le get point de terminaison, comme décrit dans Obtenir les itinéraires sélectionnés, ou examinez la routes_status table dans BigQuery.

États des itinéraires

Le champ state d'une ressource SelectedRoute indique son état actuel de validation et de fonctionnement. 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 : l'itinéraire 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 les deux.
  • STATE_DELETING: l'itinéraire a été marqué pour suppression et est en cours de suppression du système.
  • STATE_INVALID : l'itinéraire n'a pas été validé en fonction de critères spécifiques. Lorsqu'un itinéraire est dans l'état STATE_INVALID, la réponse inclut un validationError champ contenant des informations sur l'échec de la validation.

Erreurs de validation

Lorsque l'état 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 avoir les valeurs suivantes :

  • VALIDATION_ERROR_UNSPECIFIED: l'erreur de validation de cet itinéraire n'est pas définie.
  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: l'itinéraire se trouve en dehors de la zone géographique autorisée pour votre projet.
  • VALIDATION_ERROR_LOW_ROAD_USAGE: l'itinéraire est peu utilisé, ce qui signifie que des données sur le trafic insuffisantes peuvent être collectées pour une analyse significative. 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 peu utilisé.

Itinéraire peu utilisé

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

Voici ce à quoi vous pouvez vous attendre pour les itinéraires peu utilisés :

  • 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.
  • Les mises à jour Pub/Sub s'arrêtent : les mises à jour périodiques en temps réel de Pub/Sub cessent si l' état state de l'itinéraire passe à STATE_INVALID.
  • Évaluations trimestrielles : l'API effectue des évaluations trimestrielles du volume de trafic de tous les itinéraires actifs.
    • Si un faible trafic est détecté lors d'une évaluation, l'API émet un avertissement dans la SelectedRoute ressource.
    • Si le trafic reste faible pendant quatre trimestres consécutifs, l'état de l'itinéraire state passe à STATE_INVALID et les mises à jour Pub/Sub s'arrêtent.
  • La revalidation est possible : même si un itinéraire est STATE_INVALID, il reste soumis à des évaluations continues du trafic. Les évaluations ultérieures peuvent reclasser l'itinéraire comme valide (STATE_RUNNING) si son volume de trafic dépasse un seuil prédéterminé.
  • Surveillance de l'état : vous pouvez surveiller l'état de validation d'un itinéraire à l'aide du 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 de l'erreur validationError que vous recevez :

  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: cette erreur indique que l'itinéraire défini 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 intermédiaires) se trouvent dans la zone géographique autorisée pour votre projet.

  • VALIDATION_ERROR_LOW_ROAD_USAGE: cette erreur signifie que l'itinéraire sélectionné ne dispose pas de suffisamment de données d'utilisation de la route pour une analyse et des mises à jour significatives. 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 des données. Notez que si votre itinéraire présente cette erreur, son état peut revenir à STATE_RUNNING si le trafic augmente au fil du temps, comme décrit dans Itinéraire peu utilisé.