Données routières accumulées

Les données routières cumulées désignent les données que vous pouvez collecter au fil du temps pour les itinéraires sélectionnés. Vous commencerez à recevoir des données une fois que vous aurez créé un itinéraire avec l'API Roads Selection. Ces données peuvent ensuite être utilisées pour une analyse approfondie, une planification stratégique et une compréhension du comportement à long terme des routes.

Les données routières cumulées sont fournies sous forme de données de séries temporelles, qui incluent :

Configurer BigQuery

Avant de pouvoir accéder à vos données routières dans BigQuery, vous devez configurer votre projet Google Cloud et vous abonner à l'échange de données.

Prérequis

Assurez-vous que votre projet et votre compte Google Cloud présentent les configurations suivantes :

  1. Activez l'API BigQuery. Pour obtenir des instructions, consultez Interroger un ensemble de données public avec la console Google Cloud.
  2. Activez l'API Analytics Hub. Consultez la page API Analytics Hub.
  3. Accorder les rôles IAM nécessaires. Assurez-vous que votre compte dispose des rôles suivants pour effectuer des tâches d'abonné et créer des ensembles de données :
  4. Abonné Analytics Hub (roles/analyticshub.subscriber)

S'abonner à votre échange de données

Vos données routières sont partagées avec vous via un échange de données privé dans BigQuery (Analytics Hub). Vous recevrez un lien d'abonnement spécifique d'un partenaire Google pour accéder à vos données. Cet ensemble de données respecte la convention d'attribution de noms suivante :

historical_roads_data_PROJECT_NUMBER.

Pour vous abonner à vos données :

  1. Cliquez sur le lien d'abonnement fourni par votre partenaire Google. Ce lien vous redirigera directement vers l'échange de données dans la console Google Cloud.
  2. Dans la console Google Cloud, examinez les détails de l'échange de données.
  3. Cliquez sur le bouton S'abonner dans la boîte de dialogue.
  4. Une fois l'abonnement terminé, l'ensemble de données associé apparaît dans le panneau Explorateur de BigQuery dans la console Google Cloud. Vous pouvez maintenant utiliser les noms de table affichés dans le panneau "Explorateur" pour accéder aux données de vos requêtes SQL.

les tables BigQuery

Les données routières cumulées des itinéraires que vous avez sélectionnés sont hébergées dans un ensemble de données BigQuery isolé d'un projet cloud appartenant à Google. Il est partagé avec vous via un échange de données privé créé exclusivement pour vous dans BigQuery Sharing (Analytics Hub). Pour accéder aux données, vous devez vous abonner à l'échange de données et créer un ensemble de données associé dans votre projet Google Cloud.

L'ensemble de données BigQuery partagé inclut quelques tables BigQuery définies et créées par Google. Voici les détails de chaque table.

historical_travel_time table

Voici le schéma de la table BigQuery historical_travel_time :

Nom Mode Type Description
selected_route_id NULLABLE STRING selected_route_id de l'itinéraire
nom_affiché NULLABLE STRING Nom à afficher de la route
record_time NULLABLE TIMESTAMP Code temporel du calcul des données d'itinéraire
duration_in_seconds NULLABLE FLOAT Durée de l'itinéraire en tenant compte du trafic. Omission (NULL) lorsque has_road_closure est true.
static_duration_in_seconds NULLABLE FLOAT La durée de l'itinéraire sans tenir compte du trafic
route_geometry NULLABLE GEOGRAPHY La géométrie de la polyligne de l'itinéraire, tenant compte du trafic
road_segment_ids REPEATED STRING Segments de route le long de l'itinéraire, représentés par des ID de lieu
has_road_closure NULLABLE BOOLÉEN Indique si une route est complètement fermée sur l'itinéraire. Lorsque true, duration_in_seconds est omis (NULL), car l'itinéraire est impraticable. La valeur NULL indique que les informations sur la fermeture de la route ne sont pas déterminées.

Comportements et faits des tables

  • La table est partitionnée par jour et chaque partition est configurée pour expirer au bout de 10 ans.
  • La table est mise à jour toutes les heures avec les dernières données de trafic écrites par lot.
  • Une fois qu'un nouvel itinéraire est créé dans l'API Roads Selection, attendez jusqu'à une heure avant de voir les données disponibles dans cette table.
  • Une fois qu'un itinéraire est supprimé de l'API Roads Selection, aucune nouvelle donnée n'est écrite dans cette table pour l'itinéraire. Toutefois, les données historiques sont conservées jusqu'à leur expiration.
  • Les segments de route le long de l'itinéraire suivent l'ordre topologique et sont toujours connectés.
  • L'indicateur has_road_closure est cohérent avec l'état de fermeture complète de la route sur Google Maps.

recent_roads_data table

Remarque : Ce tableau n'est disponible que si votre contrat inclut les données routières en temps réel.

Contrairement à historical_travel_time, cette table contient également des intervalles de lecture de vitesse basés sur le décalage (speed_reading_offsets) et des intervalles de lecture de vitesse basés sur les coordonnées (speed_reading_intervals). Voici le schéma dans BigQuery :

Nom Mode Type Description
selected_route_id NULLABLE STRING selected_route_id de l'itinéraire
nom_affiché NULLABLE STRING Nom à afficher de la route
record_time NULLABLE TIMESTAMP Code temporel du calcul des données d'itinéraire
duration_in_seconds NULLABLE FLOAT Durée de l'itinéraire en tenant compte du trafic. Omission (NULL) lorsque has_road_closure est true.
static_duration_in_seconds NULLABLE FLOAT La durée de l'itinéraire sans tenir compte du trafic
route_geometry NULLABLE GEOGRAPHY La géométrie de la polyligne de l'itinéraire, tenant compte du trafic
speed_reading_intervals REPEATED RECORD Anciens intervalles de lecture de la vitesse basés sur les coordonnées. Il se peut qu'il ne soit plus renseigné à partir du 9 novembre 2026. Utilisez plutôt speed_reading_offsets. Consultez Intervalles de lecture de la vitesse.
speed_reading_intervals.interval_coordinates REPEATED GEOGRAPHY Ancien. Il est possible qu'il ne soit plus renseigné à partir du 9 novembre 2026. Utilisez plutôt speed_reading_offsets. Géométrie de cet intervalle
speed_reading_intervals.speed NULLABLE STRING Ancien. Il est possible qu'il ne soit plus renseigné à partir du 9 novembre 2026. Utilisez plutôt speed_reading_offsets. Classification de la vitesse pour cet intervalle. Valeurs possibles : NORMAL, SLOW, TRAFFIC_JAM. Dans ce champ hérité, les embouteillages importants (rouge foncé) sont également signalés comme TRAFFIC_JAM. TRAFFIC_JAM_HEAVY n'est jamais utilisé.
road_segment_ids REPEATED STRING Les segments de route le long de l'itinéraire, représentés par des ID de lieu
speed_reading_offsets REPEATED RECORD Intervalles de lecture de la vitesse basés sur le décalage représentant la densité du trafic sur l'itinéraire. Chaque intervalle est délimité par la distance de décalage par rapport au début de l'itinéraire. Omettez ce champ lorsque has_road_closure est défini sur true. Consultez la section Intervalles de lecture de la vitesse.
speed_reading_offsets.start_offset NULLABLE INTEGER Décalage de distance par rapport au début de l'itinéraire en mètres pour le début de l'intervalle (inclus)
speed_reading_offsets.end_offset NULLABLE INTEGER Décalage de distance par rapport au début de l'itinéraire en mètres pour la fin de l'intervalle (exclusif ; égal à start_offset de l'intervalle suivant)
speed_reading_offsets.speed NULLABLE STRING Classification de la vitesse pour cet intervalle, alignée sur les couleurs de la couche de trafic Google Maps. Valeurs possibles : NORMAL (vert), SLOW (jaune), TRAFFIC_JAM (rouge), TRAFFIC_JAM_HEAVY (rouge foncé, disponible à partir du 8 octobre 2026)
has_road_closure NULLABLE BOOLÉEN Indique si une route est complètement fermée sur l'itinéraire. Lorsque true, duration_in_seconds et speed_reading_offsets sont omis, car l'itinéraire est impraticable. Une valeur NULL indique que les informations sur la fermeture de la route ne sont pas déterminées.

Comportements et faits des tables

  • La table est partitionnée par jour et un délai d'expiration de 60 jours est défini pour chaque partition.
  • La table est mise à jour toutes les heures avec les dernières données de trafic écrites par lot.
  • Une fois qu'un nouvel itinéraire est créé dans l'API Roads Selection, attendez jusqu'à une heure avant de voir les données disponibles dans cette table.
  • Une fois qu'un itinéraire est supprimé de l'API Roads Selection, aucune nouvelle donnée n'est écrite dans cette table pour cet itinéraire. Toutefois, les données historiques sont conservées jusqu'à leur expiration.
  • Les segments de route le long de l'itinéraire suivent l'ordre topologique et sont toujours connectés.
  • La colonne speed_reading_offsets est renseignée pour les lignes enregistrées à partir du 8 octobre 2026. Les lignes précédentes contiennent des tableaux vides.
  • La colonne speed_reading_intervals héritée pourrait ne plus être renseignée à partir du 9 novembre 2026. Utilisez speed_reading_offsets à la place.
  • L'indicateur has_road_closure est cohérent avec l'état de fermeture complète de la route sur Google Maps.

routes_status table

La table contient les métadonnées et les informations d'état des routes sélectionnées. Il vise à faciliter l'affichage de toutes les routes et de leur état. Elle peut être jointe aux deux autres tables pour filtrer les données. Voici le schéma dans BigQuery :

Nom Mode Type Description
selected_route_id NULLABLE STRING selected_route_id de l'itinéraire
nom_affiché NULLABLE STRING Nom à afficher de la route
status* NULLABLE STRING État de la route
validation_error NULLABLE STRING Erreur de validation de l'itinéraire
low_road_usage_start_time NULLABLE TIMESTAMP Heure à laquelle la route a été observée pour la première fois comme étant peu utilisée lors de la revalidation. Il est associé à VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes NULLABLE STRING Attributs personnalisés pour la route sélectionnée
dynamic_routing NULLABLE BOOLÉEN Indique si la route est dynamique (true) ou fixe (false). Voir dynamicRouting.
origin NULLABLE GEOGRAPHY Point de cheminement de départ de l'itinéraire
destination NULLABLE GEOGRAPHY Point de cheminement de destination de l'itinéraire
intermédiaires REPEATED GEOGRAPHY Points de cheminement intermédiaires de l'itinéraire
static_route_geometry NULLABLE GEOGRAPHY Géométrie de polyligne de l'itinéraire statique calculé sans trafic en temps réel à partir des points de cheminement
road_segment_ids REPEATED STRING Segments de route le long de l'itinéraire statique calculé sans trafic en temps réel, représentés par des ID de lieu

Comportements et faits des tables

  • Seules les routes à l'état STATUS_RUNNING ou STATUS_INVALID sont incluses dans ce tableau.
  • Les métadonnées et l'état des routes sont mis à jour toutes les heures, sans interruption.
  • Une fois qu'une route est créée dans l'API Roads Selection, vous devrez peut-être attendre jusqu'à une heure avant qu'elle ne soit disponible dans ce tableau.
  • Une fois qu'un itinéraire est supprimé de l'API Roads Selection, attendez jusqu'à une heure pour que l'itinéraire sélectionné soit supprimé de ce tableau.
  • Pour les itinéraires fixes (dynamic_routing: false), les ID de lieu dans road_segment_ids sont automatiquement mis à jour pour refléter les modifications apportées au réseau routier de Google, tout en représentant le même itinéraire. Pour les routes dynamiques (dynamic_routing: true), road_segment_ids n'est pas mis à jour.