Dati stradali accumulati

I dati stradali accumulati si riferiscono ai dati che puoi creare nel tempo per i percorsi selezionati. Inizi a ricevere i dati dopo aver creato un percorso con l'API Roads Selection. Questi dati possono essere utilizzati per analisi approfondite, pianificazione strategica e comprensione del comportamento a lungo termine degli itinerari.

I dati stradali accumulati vengono forniti come dati delle serie temporali, che includono:

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 tuo progetto cloud e il tuo account Google Cloud abbiano le seguenti configurazioni:

  1. Abilita l'API BigQuery. Per istruzioni, consulta Esegui una query su un set di dati pubblico con la console Google Cloud.
  2. Abilita l'API Analytics Hub. Consulta l'API Analytics Hub.
  3. 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:
  4. Abbonato ad Analytics Hub (roles/analyticshub.subscriber)

Iscriversi allo scambio di dati

I tuoi 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 di 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:

  1. Fai clic sul link di abbonamento fornito dal tuo partner Google. Questo link ti indirizzerà direttamente allo scambio di dati nella console Google Cloud.
  2. Nella console Google Cloud, esamina i dettagli dello scambio di dati.
  3. Fai clic sul pulsante Abbonati nella finestra di dialogo.
  4. 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 dei percorsi selezionati sono ospitati in un set di dati BigQuery isolato di un progetto cloud di proprietà di Google. Viene condiviso con te tramite uno scambio di dati privato creato esclusivamente per te in BigQuery sharing (Analytics Hub). Per accedere ai dati, devi abbonarti all'exchange 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.

historical_travel_time tabella

Di seguito è riportato lo schema per la tabella BigQuery historical_travel_time:

Nome Modalità Tipo Descrizione
selected_route_id NULLABLE STRING selected_route_id del percorso
display_name NULLABLE STRING Nome visualizzato della route
record_time NULLABLE TIMESTAMP Il timestamp del momento in cui vengono calcolati i dati del percorso
duration_in_seconds NULLABLE FLOAT La durata del percorso in base al traffico
static_duration_in_seconds NULLABLE FLOAT La durata del percorso senza traffico
route_geometry NULLABLE GEOGRAPHY La geometria della polilinea in base al traffico dell'itinerario
road_segment_ids REPEATED STRING I tratti di strada lungo il percorso, rappresentati come ID luogo

Comportamenti e fatti delle tabelle

  • La tabella è partizionata per giorno e ha una scadenza di 10 anni impostata per ogni partizione.
  • La tabella viene aggiornata ogni ora con i dati sul traffico più recenti scritti in batch.
  • Una volta creata una nuova rotta nell'API Roads Selection, attendi fino a 1 ora prima di visualizzare i dati disponibili in questa tabella.
  • Una volta eliminato un percorso dall'API Roads Selection, non vengono scritti nuovi dati in questa tabella per il percorso. Tuttavia, i dati storici rimangono fino alla scadenza.
  • I segmenti stradali lungo il percorso seguono l'ordine topologico e sono sempre collegati.

recent_roads_data tabella

Nota: questa tabella è disponibile solo quando il contratto include dati stradali in tempo reale.

A differenza di historical_travel_time, questa tabella contiene anche intervalli di lettura veloce basati sull'offset (speed_reading_offsets) e intervalli di lettura veloce legacy basati sulle coordinate (speed_reading_intervals). Ecco lo schema in BigQuery:

Nome Modalità Tipo Descrizione
selected_route_id NULLABLE STRING selected_route_id del percorso
display_name NULLABLE STRING Nome visualizzato della route
record_time NULLABLE TIMESTAMP Il timestamp del momento in cui vengono calcolati i dati del percorso
duration_in_seconds NULLABLE FLOAT La durata del percorso in base al traffico
static_duration_in_seconds NULLABLE FLOAT La durata del percorso senza traffico
route_geometry NULLABLE GEOGRAPHY La geometria della polilinea in base al traffico dell'itinerario
speed_reading_intervals REPEATED RECORD Intervalli di lettura rapida basati sulle coordinate precedenti. Potrebbe non essere più compilato a partire dal 9 novembre 2026. Utilizza speed_reading_offsets. Vedi Intervalli di lettura veloce.
speed_reading_intervals.interval_coordinates REPEATED GEOGRAPHY Legacy. Potrebbe non essere più compilato a partire dal 9 novembre 2026. Utilizza speed_reading_offsets. La geometria per questo intervallo
speed_reading_intervals.speed NULLABLE STRING Legacy. Potrebbe non essere più compilato a partire dal 9 novembre 2026. Utilizza speed_reading_offsets. La classificazione della velocità per questo intervallo. Valori possibili: NORMAL, SLOW, TRAFFIC_JAM. In questo campo legacy, anche gli ingorghi (rosso scuro) vengono segnalati come TRAFFIC_JAM; TRAFFIC_JAM_HEAVY non viene mai utilizzato.
road_segment_ids REPEATED STRING I tratti di strada lungo il percorso, rappresentati come ID luogo
speed_reading_offsets REPEATED RECORD Intervalli di lettura della velocità basati sull'offset che rappresentano la densità del traffico lungo il percorso; ogni intervallo è delimitato dall'offset di distanza dall'inizio del percorso. Vedi Intervalli di lettura veloce.
speed_reading_offsets.start_offset NULLABLE NUMERO INTERO L'offset della distanza dall'inizio del percorso in metri per l'inizio dell'intervallo (incluso)
speed_reading_offsets.end_offset NULLABLE NUMERO INTERO L'offset della distanza dall'inizio del percorso in metri per la fine dell'intervallo (esclusivo; uguale a start_offset dell'intervallo successivo)
speed_reading_offsets.speed NULLABLE STRING La classificazione della velocità per questo intervallo, in linea con i colori nel livello del traffico di Google Maps. Valori possibili: NORMAL (verde), SLOW (giallo), TRAFFIC_JAM (rosso), TRAFFIC_JAM_HEAVY (rosso scuro, disponibile a partire dall'8 ottobre 2026)

Comportamenti e fatti delle tabelle

  • La tabella è partizionata per giorno e ha una scadenza di 60 giorni impostata per ogni partizione.
  • La tabella viene aggiornata ogni ora con i dati sul traffico più recenti scritti in batch.
  • Una volta creata una nuova rotta nell'API Roads Selection, attendi fino a 1 ora prima di visualizzare i dati disponibili in questa tabella.
  • Una volta eliminato un percorso dall'API Roads Selection, non verranno scritti nuovi dati in questa tabella per il percorso. Tuttavia, i dati storici rimangono fino alla scadenza.
  • I segmenti stradali lungo il percorso seguono l'ordine topologico e sono sempre collegati.
  • La colonna speed_reading_offsets viene compilata per le righe registrate a partire dall'8 ottobre 2026. Le righe precedenti contengono array vuoti.
  • La colonna legacy speed_reading_intervals potrebbe non essere più compilata a partire dal 9 novembre 2026. Utilizza invece speed_reading_offsets.

routes_status tabella

La tabella contiene i metadati e le informazioni sullo stato delle route selezionate. Il suo scopo è 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 del percorso
display_name NULLABLE STRING Nome visualizzato della route
stato* NULLABLE STRING Stato dell'itinerario
validation_error NULLABLE STRING Errore di convalida dell'itinerario
low_road_usage_start_time NULLABLE TIMESTAMP L'ora in cui è stato osservato per la prima volta un basso utilizzo della strada durante la rivalidazione. È associato a VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes NULLABLE STRING Attributi personalizzati per la route selezionata

*Lo stato dell'itinerario in questa tabella inizia con STATUS_ anziché STATE_. Altrimenti, è coerente con l'API Roads Selection.

Comportamenti e fatti delle tabelle

  • 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.
  • Una volta creato un nuovo percorso nell'API Roads Selection, attendi fino a 1 ora prima di visualizzarlo in questa tabella.
  • Una volta eliminato un percorso dall'API Roads Selection, potrebbero essere necessarie fino a 1 ora prima che il percorso selezionato venga rimosso da questa tabella.