Les données routières cumulées font référence aux données que vous pouvez générer au fil du temps pour les itinéraires sélectionnés. Vous commencez à recevoir des données une fois que vous avez 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 itinéraires.
Les données routières cumulées sont fournies sous forme de séries temporelles, qui incluent la durée du trajet, les intervalles de lecture de la vitesse (SRI) et la géométrie de l'itinéraire pour chaque itinéraire. Ces données sont stockées et accessibles via BigQuery.
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 :
- Activez l'API BigQuery. Pour obtenir des instructions, consultez Interroger un ensemble de données public avec la console Google Cloud.
- Activez l'API Analytics Hub. Consultez la page API Analytics Hub.
- Accordez les rôles IAM nécessaires. Assurez-vous que votre compte dispose des rôles suivants pour effectuer des tâches liées aux abonnés et créer des ensembles de données :
- Abonné Analytics Hub (
roles/analyticshub.subscriber) - Utilisateur BigQuery (
roles/bigquery.user)
- Abonné Analytics Hub (
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 de dénomination suivante :
historical_roads_data_PROJECT_NUMBER.
Pour vous abonner à vos données :
- 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.
- Dans la console Google Cloud, examinez les détails de l'échange de données.
- Cliquez sur le bouton S'abonner dans la boîte de dialogue.
- 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 désormais utiliser les noms de tables 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 de vos itinéraires 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. Vous trouverez ci-dessous des informations détaillées sur chaque tableau.
historical_travel_time table
Vous trouverez ci-dessous 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 l'itinéraire |
| record_time | NULLABLE | TIMESTAMP | Code temporel de calcul des données de l'itinéraire |
| duration_in_seconds | NULLABLE | FLOAT | Durée de l'itinéraire en tenant compte du trafic |
| static_duration_in_seconds | NULLABLE | FLOAT | Durée de l'itinéraire sans tenir compte du trafic |
| route_geometry | NULLABLE | GEOGRAPHY | Géométrie de la polyligne de l'itinéraire tenant compte du trafic |
Comportements et faits concernant les tables
- La table est partitionnée par jour et un délai d'expiration de 10 ans est défini pour chaque partition.
- Le tableau est mis à jour toutes les heures avec les dernières données sur le trafic écrites par lot.
- Une fois qu'un itinéraire est créé dans l'API Roads Selection, vous devez attendre jusqu'à une heure pour que les données soient disponibles dans ce tableau.
- 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 restent disponibles jusqu'à l'expiration.
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 données SpeedReadingInterval. 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 l'itinéraire |
| record_time | NULLABLE | TIMESTAMP | Code temporel de calcul des données de l'itinéraire |
| duration_in_seconds | NULLABLE | FLOAT | Durée de l'itinéraire en tenant compte du trafic |
| static_duration_in_seconds | NULLABLE | FLOAT | Durée de l'itinéraire sans tenir compte du trafic |
| route_geometry | NULLABLE | GEOGRAPHY | Géométrie de la polyligne de l'itinéraire tenant compte du trafic |
| speed_reading_intervals | REPEATED | ENREGISTREMENT | Intervalles représentant la densité du trafic sur l'itinéraire. Consultez la définition d'origine dans l'API Routes. |
| speed_reading_intervals.interval_coordinates | REPEATED | GEOGRAPHY | Géométrie de cet intervalle |
| speed_reading_intervals.speed | NULLABLE | STRING | Classification de la vitesse pour cet intervalle. Valeurs possibles : NORMAL, SLOW, TRAFFIC_JAM |
Comportements et faits concernant les tables
- La table est partitionnée par jour et chaque partition a une date d'expiration de 60 jours.
- Le tableau est mis à jour toutes les heures avec les dernières données sur le trafic écrites par lot.
- Une fois qu'un itinéraire est créé dans l'API Roads Selection, vous devez attendre jusqu'à une heure pour que les données soient disponibles dans ce tableau.
- Une fois une route supprimée de l'API Roads Selection, aucune nouvelle donnée ne sera écrite dans cette table pour la route. Toutefois, les données historiques restent disponibles jusqu'à l'expiration.
routes_status table
Le tableau contient les métadonnées et les informations sur l'état des itinéraires sélectionnés. Il vise à faciliter la consultation de tous les itinéraires 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 l'itinéraire |
| état | 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 avec une faible utilisation lors de la revalidation. Elle est associée à VALIDATION_ERROR_LOW_ROAD_USAGE. |
| route_attributes | NULLABLE | STRING | Attributs personnalisés pour la route sélectionnée |
Comportements et faits concernant les tables
- Seules les routes dont l'état est STATE_RUNNING ou STATE_INVALID sont incluses dans ce tableau.
- Les métadonnées et l'état des itinéraires sont mis à jour toutes les heures, en continu.
- Une fois qu'un itinéraire est créé dans l'API Roads Selection, vous devez attendre jusqu'à une heure pour qu'il soit disponible dans ce tableau.
- Une fois qu'un itinéraire est supprimé de l'API Roads Selection, vous devez attendre jusqu'à une heure pour que l'itinéraire sélectionné soit supprimé de ce tableau.