I dati stradali accumulati si riferiscono ai dati che puoi creare nel tempo per le route selezionate. Inizi a ricevere i dati dopo aver creato una route con l'API Roads Selection. Questi dati possono essere utilizzati per analisi approfondite, pianificazione strategica e comprensione del comportamento a lungo termine delle route.
I dati stradali accumulati vengono forniti come dati di serie temporali, che includono la durata del viaggio, gli intervalli di lettura della velocità (SRI) e la geometria della route per ogni route. Questi dati vengono archiviati e accessibili tramite BigQuery.
Configurare BigQuery
Prima di poter accedere ai dati stradali in BigQuery, devi configurare il progetto Google Cloud e abbonarti allo scambio di dati.
Prerequisiti
Assicurati che il progetto cloud e l'account Google Cloud abbiano le seguenti configurazioni:
- Abilita l'API BigQuery. Per istruzioni, consulta Eseguire una query su un set di dati pubblico con la console Google Cloud.
- Abilita l'API Analytics Hub. Consulta API Analytics Hub.
- Concedi i ruoli IAM necessari. Assicurati che il tuo account disponga dei seguenti ruoli per eseguire le attività degli abbonati e creare set di dati:
- Abbonato Analytics Hub (
roles/analyticshub.subscriber) - Utente BigQuery (
roles/bigquery.user)
- Abbonato Analytics Hub (
Abbonarsi allo scambio di dati
I dati stradali vengono condivisi con te tramite uno scambio di dati privato in BigQuery (Analytics Hub). Riceverai un link di abbonamento specifico da un partner Google per accedere ai tuoi dati. Questo set di dati rispetta la seguente convenzione di denominazione:
historical_roads_data_PROJECT_NUMBER.
Per abbonarti ai tuoi dati:
- Fai clic sul link di abbonamento fornito dal tuo partner Google. Questo link ti porterà direttamente allo scambio di dati nella console Google Cloud.
- Nella console Google Cloud, esamina i dettagli dello scambio di dati.
- Fai clic sul pulsante Abbonati nella finestra di dialogo.
- Al termine dell'abbonamento, il set di dati collegato viene visualizzato nel riquadro Explorer di BigQuery nella console Google Cloud. Ora puoi utilizzare i nomi delle tabelle visualizzati nel riquadro Explorer per accedere ai dati nelle query SQL.
Tabelle BigQuery
I dati stradali accumulati delle route selezionate sono ospitati in un set di dati BigQuery isolato di un progetto cloud di proprietà di Google. Vengono condivisi con te tramite uno scambio di dati privato creato esclusivamente per te in BigQuery sharing (Analytics Hub). Per accedere ai dati, devi abbonarti allo scambio di dati e creare un set di dati collegato nel tuo progetto Google Cloud.
Il set di dati BigQuery condiviso include alcune tabelle BigQuery definite e create da Google. Di seguito sono riportati i dettagli di ogni tabella.
Tabella historical_travel_time
Di seguito è riportato lo schema della tabella BigQuery historical_travel_time:
| Nome | Modalità | Tipo | Descrizione |
|---|---|---|---|
| selected_route_id | NULLABLE | STRING | selected_route_id della route |
| display_name | NULLABLE | STRING | Nome visualizzato della route |
| record_time | NULLABLE | TIMESTAMP | Il timestamp in cui vengono calcolati i dati della route |
| duration_in_seconds | NULLABLE | FLOAT | La durata della route in base al traffico |
| static_duration_in_seconds | NULLABLE | FLOAT | La durata della route senza traffico |
| route_geometry | NULLABLE | GEOGRAPHY | La geometria della polilinea della route in base al traffico |
Comportamenti e fatti della tabella
- La tabella è partizionata per giorno e per ogni partizione è impostata una scadenza di 10 anni.
- La tabella viene aggiornata ogni ora con i dati sul traffico più recenti scritti in batch.
- Dopo aver creato una nuova route nell'API Roads Selection, attendi fino a 1 ora prima di visualizzare i dati disponibili in questa tabella.
- Una volta eliminata una route dall'API Roads Selection, non vengono scritti nuovi dati in questa tabella per la route. Tuttavia, i dati storici rimangono fino alla scadenza.
Tabella recent_roads_data
Nota: questa tabella è disponibile solo se il contratto include i dati stradali in tempo reale.
A differenza di historical_travel_time, questa tabella contiene anche i dati SpeedReadingInterval. Ecco lo schema in BigQuery:
| Nome | Modalità | Tipo | Descrizione |
|---|---|---|---|
| selected_route_id | NULLABLE | STRING | selected_route_id della route |
| display_name | NULLABLE | STRING | Nome visualizzato della route |
| record_time | NULLABLE | TIMESTAMP | Il timestamp in cui vengono calcolati i dati della route |
| duration_in_seconds | NULLABLE | FLOAT | La durata della route in base al traffico |
| static_duration_in_seconds | NULLABLE | FLOAT | La durata della route senza traffico |
| route_geometry | NULLABLE | GEOGRAPHY | La geometria della polilinea della route in base al traffico |
| speed_reading_intervals | REPEATED | RECORD | Intervalli che rappresentano la densità del traffico lungo la route. Consulta la definizione originale nell'API Routes |
| speed_reading_intervals.interval_coordinates | REPEATED | GEOGRAPHY | La geometria per questo intervallo |
| speed_reading_intervals.speed | NULLABLE | STRING | La classificazione della velocità per questo intervallo. Valori possibili: NORMAL, SLOW, TRAFFIC_JAM |
Comportamenti e fatti della tabella
- La tabella è partizionata per giorno e per ogni partizione è impostata una scadenza di 60 giorni.
- La tabella viene aggiornata ogni ora con i dati sul traffico più recenti scritti in batch.
- Dopo aver creato una nuova route nell'API Roads Selection, attendi fino a 1 ora prima di visualizzare i dati disponibili in questa tabella.
- Una volta eliminata una route dall'API Roads Selection, non vengono scritti nuovi dati in questa tabella per la route. Tuttavia, i dati storici rimangono fino alla scadenza.
Tabella routes_status
La tabella contiene i metadati e le informazioni sullo stato delle route selezionate. Ha lo scopo di fornire un modo più semplice per visualizzare tutte le route e il relativo stato. Può essere unita alle altre due tabelle per il filtraggio dei dati. Ecco lo schema in BigQuery:
| Nome | Modalità | Tipo | Descrizione |
|---|---|---|---|
| selected_route_id | NULLABLE | STRING | selected_route_id della route |
| display_name | NULLABLE | STRING | Nome visualizzato della route |
| status* | NULLABLE | STRING | Stato della route |
| validation_error | NULLABLE | STRING | Errore di convalida della route |
| low_road_usage_start_time | NULLABLE | TIMESTAMP | L'ora in cui la route ha osservato per la prima volta un basso utilizzo della strada durante la riconvalida. È associato a VALIDATION_ERROR_LOW_ROAD_USAGE. |
| route_attributes | NULLABLE | STRING | Attributi personalizzati per la route selezionata |
*Lo stato della route in questa tabella inizia con STATUS_ anziché STATE_. Per il resto, è coerente con l'API Roads Selection.
Comportamenti e fatti della tabella
- In questa tabella sono incluse solo le route con stato STATUS_RUNNING o STATUS_INVALID.
- I metadati e lo stato delle route vengono aggiornati ogni ora, senza interruzioni.
- Dopo aver creato una nuova route nell'API Roads Selection, attendi fino a 1 ora prima di visualizzare la route disponibile in questa tabella.
- Una volta eliminata una route dall'API Roads Selection, attendi fino a 1 ora prima che la route selezionata venga rimossa da questa tabella.