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 poi essere utilizzati per analisi approfondite, pianificazione strategica e comprensione del comportamento a lungo termine degli itinerari.

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 del percorso per ogni percorso. 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 tuo progetto 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:

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 iscrizione 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:

  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 mostrati nel riquadro Esplora per accedere ai dati nelle query SQL.

Tabelle BigQuery

I dati stradali accumulati degli itinerari 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 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.

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 dell'itinerario
record_time NULLABLE TIMESTAMP Il timestamp 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

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 gli ultimi dati sul traffico scritti in batch.
  • Una volta creata una nuova route nell'API Roads Selection, prevedi di attendere 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.

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 dati SpeedReadingInterval. 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 dell'itinerario
record_time NULLABLE TIMESTAMP Il timestamp 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 che rappresentano la densità del traffico lungo il percorso. 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 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 gli ultimi dati sul traffico scritti in batch.
  • Una volta creata una nuova route nell'API Roads Selection, prevedi di attendere fino a 1 ora prima di visualizzare i dati disponibili in questa tabella.
  • Una volta eliminata una route dall'API Roads Selection, non verranno scritti nuovi dati in questa tabella per la route. Tuttavia, i dati storici rimangono fino alla scadenza.

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 lo 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 dell'itinerario
stato NULLABLE STRING Stato dell'itinerario
validation_error NULLABLE STRING Errore di convalida dell'itinerario
low_road_usage_start_time NULLABLE TIMESTAMP Il momento in cui è stato osservato per la prima volta un basso utilizzo della strada durante la nuova convalida. È associato a VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes NULLABLE STRING Attributi personalizzati per l'itinerario selezionato

Comportamenti e fatti delle tabelle

  • In questa tabella sono incluse solo le route con stato STATE_RUNNING o STATE_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 che il percorso sia disponibile 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.