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 données 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 à l'aide de la console Google Cloud.
- Activez l'API Analytics Hub. Consultez 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 d'abonné 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 d'attribution de noms 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 redirige 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é s'affiche dans le volet Explorateur de BigQuery dans la console Google Cloud. Vous pouvez désormais utiliser les noms de table affichés dans le volet Explorateur pour accéder aux données dans 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. Elles sont partagées avec vous via un échange de données privé créé exclusivement pour vous dans le partage BigQuery (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 les détails de chaque table.
Table historical_travel_time
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 |
| display_name | NULLABLE | STRING | Nom affiché de l'itinéraire |
| record_time | NULLABLE | TIMESTAMP | Timestamp lorsque les données d'itinéraire sont calculées |
| 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 en tenant compte du trafic |
Comportements et faits de la table
- La table est partitionnée par jour et chaque partition a une date d'expiration 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, vous devez attendre jusqu'à une heure pour que les données soient 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.
Table recent_roads_data
Remarque : Cette table 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 |
| display_name | NULLABLE | STRING | Nom affiché de l'itinéraire |
| record_time | NULLABLE | TIMESTAMP | Timestamp lorsque les données d'itinéraire sont calculées |
| 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 en 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 de la table
- La table est partitionnée par jour et chaque partition a une date d'expiration de 60 jours.
- 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, vous devez attendre jusqu'à une heure pour que les données soient 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.
Table routes_status
La table contient les métadonnées et les informations d'état des itinéraires sélectionnés. Elle vise à faciliter l'affichage 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 |
| display_name | NULLABLE | STRING | Nom affiché de l'itinéraire |
| état* | NULLABLE | STRING | État de l'itinéraire |
| validation_error | NULLABLE | STRING | Erreur de validation de l'itinéraire |
| low_road_usage_start_time | NULLABLE | TIMESTAMP | Heure à laquelle l'itinéraire a été observé pour la première fois avec une faible utilisation de la route lors de la revalidation. Elle est associée à VALIDATION_ERROR_LOW_ROAD_USAGE. |
| route_attributes | NULLABLE | STRING | Attributs personnalisés pour l'itinéraire sélectionné |
*L'état de l'itinéraire dans cette table commence par STATUS_ au lieu de STATE_. Sinon, il est cohérent avec l'API Roads Selection.
Comportements et faits de la table
- Seuls les itinéraires dont l'état est STATUS_RUNNING ou STATUS_INVALID sont inclus dans cette table.
- Les métadonnées et l'état des itinéraires sont mis à jour toutes les heures, sans interruption.
- Une fois qu'un nouvel itinéraire est créé dans l'API Roads Selection, vous devez attendre jusqu'à une heure pour que l'itinéraire soit disponible dans cette table.
- 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 cette table.