Dati stradali accumulati

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

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

Configura BigQuery

Prima di poter accedere ai dati stradali in BigQuery, devi configurare il tuo progetto Google Cloud e iscriverti allo scambio di dati.

Prerequisiti

Assicurati che il progetto cloud e l'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à del sottoscrittore e creare set di dati:
  4. Sottoscrittore Analytics Hub (roles/analyticshub.subscriber)

Sottoscrivi un abbonamento al tuo scambio di dati

I dati stradali vengono condivisi con te tramite uno scambio di dati privato in BigQuery (Analytics Hub). Riceverai un link per l'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 iscriverti ai tuoi dati:

  1. Fai clic sul link per l'abbonamento fornito dal tuo partner di Google. Questo link ti porterà 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. Una volta completata la sottoscrizione, il set di dati collegato viene visualizzato nel riquadro Explorer di BigQuery nella console Google Cloud. Ora puoi utilizzare i nomi delle tabelle mostrati 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 sottoscrivere un abbonamento al data exchange 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 ciascuna tabella.

historical_travel_time tabella

Di seguito è riportato lo schema della 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. Ometti (NULL) quando has_road_closure è true.
static_duration_in_seconds NULLABLE FLOAT La durata del percorso senza considerare il traffico
route_geometry NULLABLE GEOGRAPHY La geometria della polilinea del percorso che tiene conto del traffico
road_segment_ids REPEATED STRING I tratti di strada lungo il percorso, rappresentati come ID luogo
has_road_closure NULLABLE BOOLEAN Se sul percorso è presente una chiusura stradale completa. Quando true, duration_in_seconds viene omesso (NULL) perché il percorso è impraticabile. Un valore NULL indica che le informazioni sulla chiusura della strada non sono determinate.

Comportamenti e fatti relativi alle 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 creato un nuovo percorso nell'API Roads Selection, attendi fino a 1 ora per 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.
  • Il flag has_road_closure è coerente con lo stato di chiusura stradale totale su Google Maps.

recent_roads_data tabella

Nota: questa tabella è disponibile solo se il tuo contratto include Dati stradali in tempo reale.

A differenza di historical_travel_time, questa tabella contiene anche intervalli di lettura della velocità basati su offset (speed_reading_offsets) e intervalli di lettura della velocità basati su coordinate legacy (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. Ometti (NULL) quando has_road_closure è true.
static_duration_in_seconds NULLABLE FLOAT La durata del percorso senza considerare il traffico
route_geometry NULLABLE GEOGRAPHY La geometria della polilinea del percorso che tiene conto del traffico
speed_reading_intervals REPEATED RECORD Intervalli di lettura della velocità basati su coordinate legacy. Potrebbe non essere più compilato a partire dal 9 novembre 2026. Utilizza invece speed_reading_offsets. Consulta Intervalli di lettura della velocità.
speed_reading_intervals.interval_coordinates REPEATED GEOGRAPHY Legacy. Potrebbe non essere più compilato a partire dal 9 novembre 2026. Utilizza invece 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 invece speed_reading_offsets. La classificazione della velocità per questo intervallo. Valori possibili: NORMAL, SLOW, TRAFFIC_JAM. In questo campo legacy, gli ingorghi stradali intensi (rosso scuro) vengono segnalati anche 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 della distanza dall'inizio del percorso. Omesso quando has_road_closure è true. Consulta Intervalli di lettura della velocità.
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; equivale 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 dall'8 ottobre 2026)
has_road_closure NULLABLE BOOLEAN Se sul percorso è presente una chiusura stradale completa. Quando true, duration_in_seconds e speed_reading_offsets vengono omessi perché il percorso è impraticabile. Un valore NULL indica che le informazioni sulla chiusura stradale non sono determinate.

Comportamenti e fatti della tabella

  • 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 creato un nuovo percorso nell'API Roads Selection, attendi fino a 1 ora per 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 l'8 ottobre 2026 o in una data successiva. Le righe precedenti contengono array vuoti.
  • La colonna speed_reading_intervals precedente potrebbe non essere più compilata a partire dal 9 novembre 2026. Utilizza invece speed_reading_offsets.
  • Il flag has_road_closure è coerente con lo stato di chiusura stradale totale su Google Maps.

routes_status tabella

La tabella contiene i metadati e le informazioni sullo stato delle route selezionate. L'obiettivo è fornire un modo più semplice per visualizzare tutte le route e lo stato. Può essere unita alle altre due tabelle per il filtro 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
status* NULLABLE STRING Stato della route
validation_error NULLABLE STRING Errore di convalida del percorso
low_road_usage_start_time NULLABLE TIMESTAMP L'ora in cui il percorso ha registrato per la prima volta un utilizzo ridotto della strada durante la nuova convalida. È associato a VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes NULLABLE STRING Attributi personalizzati per la route selezionata
dynamic_routing NULLABLE BOOLEAN Indica se il percorso è dinamico (true) o fisso (false). Consulta dynamicRouting.
origine NULLABLE GEOGRAPHY Waypoint di origine del percorso
destinazione NULLABLE GEOGRAPHY Waypoint di destinazione del percorso
intermedi REPEATED GEOGRAPHY Tappe intermedie del percorso
static_route_geometry NULLABLE GEOGRAPHY La geometria della polilinea del percorso statico calcolata senza traffico in tempo reale dai waypoint
road_segment_ids REPEATED STRING I segmenti stradali lungo il percorso statico calcolato senza traffico in tempo reale, rappresentati come ID luogo

Comportamenti e fatti relativi alle tabelle

  • In questa tabella sono incluse solo le route con stato STATUS_RUNNING o STATUS_INVALID.
  • I metadati e lo stato dei percorsi vengono aggiornati ogni ora, senza interruzioni.
  • Dopo aver creato un nuovo percorso nell'API Roads Selection, attendi fino a un'ora per visualizzarlo in questa tabella.
  • Una volta eliminato un percorso dall'API Roads Selection, attendi fino a 1 ora per vedere il percorso selezionato rimosso da questa tabella.
  • Per i percorsi fissi (dynamic_routing: false), gli ID luogo in road_segment_ids si aggiornano automaticamente per riflettere le modifiche alla rete stradale di Google, pur continuando a rappresentare lo stesso percorso. Per le route dinamiche (dynamic_routing: true), road_segment_ids non viene aggiornato.