Zebrane dane o drogach

Skumulowane dane o drogach to dane, które możesz gromadzić z czasem w przypadku wybranych tras. Dane zaczniesz otrzymywać po utworzeniu trasy za pomocą interfejsu Roads Selection API. Te dane można następnie wykorzystać do szczegółowej analizy, planowania strategicznego i poznawania długoterminowych zachowań tras.

Skumulowane dane drogowe są udostępniane w formie danych szeregów czasowych, które obejmują czas trwania podróży, interwały odczytu prędkości (SRI) i geometrię trasy dla każdej trasy. Dane te są przechowywane i dostępne w BigQuery.

Konfigurowanie BigQuery

Zanim uzyskasz dostęp do danych o drogach w BigQuery, musisz skonfigurować projekt Google Cloud i zasubskrybować wymianę danych.

Wymagania wstępne

Sprawdź, czy projekt i konto Google Cloud mają te konfiguracje:

  1. Włącz interfejs BigQuery API. Instrukcje znajdziesz w artykule Tworzenie zapytania dotyczącego publicznego zbioru danych za pomocą konsoli Google Cloud.
  2. Włącz interfejs Analytics Hub API. Zobacz interfejs Analytics Hub API.
  3. Przyznaj niezbędne role uprawnień. Aby wykonywać zadania subskrybenta i tworzyć zbiory danych, Twoje konto musi mieć te role:

Subskrybowanie wymiany danych

Dane o drogach są udostępniane w ramach prywatnej wymiany danych w BigQuery (Analytics Hub). Od partnera Google otrzymasz specjalny link do subskrypcji, który umożliwi Ci dostęp do danych. Ten zbiór danych jest zgodny z tą konwencją nazewnictwa:

historical_roads_data_PROJECT_NUMBER.

Aby zasubskrybować dane:

  1. Kliknij link do subskrypcji podany przez partnera Google. Kliknięcie tego linku spowoduje przejście bezpośrednio do wymiany danych w konsoli Google Cloud.
  2. W konsoli Google Cloud sprawdź szczegóły wymiany danych.
  3. W oknie dialogowym kliknij przycisk Subskrybuj.
  4. Po zakończeniu subskrypcji połączony zbiór danych pojawi się w panelu Eksplorator BigQuery w konsoli Google Cloud. Możesz teraz używać nazw tabel widocznych w panelu Eksplorator, aby uzyskiwać dostęp do danych w zapytaniach SQL.

tabele BigQuery

Zebrane dane drogowe dotyczące wybranych tras są przechowywane w izolowanym zbiorze danych BigQuery w projekcie w chmurze należącym do Google. Są one udostępniane w ramach prywatnej wymiany danych utworzonej specjalnie dla Ciebie w BigQuery sharing (Analytics Hub). Aby uzyskać dostęp do danych, musisz zasubskrybować wymianę danych i utworzyć połączony zbiór danych w swoim projekcie Google Cloud.

Udostępniony zbiór danych BigQuery zawiera kilka tabel BigQuery zdefiniowanych i utworzonych przez Google. Poniżej znajdziesz szczegółowe informacje o poszczególnych tabelach.

historical_travel_time tabela

Poniżej znajduje się schemat tabeli BigQuery historical_travel_time:

Nazwa Tryb Typ Opis
selected_route_id NULLABLE CIĄG ZNAKÓW selected_route_id trasy
display_name NULLABLE CIĄG ZNAKÓW Wyświetlana nazwa trasy
record_time NULLABLE SYGNATURA CZASOWA Sygnatura czasowa obliczenia danych trasy.
duration_in_seconds NULLABLE LICZBA ZMIENNOPRZECINKOWA Czas przejazdu uwzględniający natężenie ruchu
static_duration_in_seconds NULLABLE LICZBA ZMIENNOPRZECINKOWA czas przejazdu bez uwzględnienia natężenia ruchu;
route_geometry NULLABLE GEOGRAPHY Geometria linii łamanej trasy uwzględniająca ruch

Zachowania i fakty dotyczące tabel

  • Tabela jest podzielona na partycje według dnia, a każda partycja ma ustawiony 10-letni okres ważności.
  • Tabela jest aktualizowana co godzinę najnowszymi danymi o ruchu zapisanymi w partiach.
  • Po utworzeniu nowej trasy w interfejsie Roads Selection API poczekaj maksymalnie godzinę, aż dane będą dostępne w tej tabeli.
  • Po usunięciu trasy z interfejsu Roads Selection API do tej tabeli nie są zapisywane żadne nowe dane dotyczące tej trasy. Dane historyczne pozostaną jednak dostępne do momentu wygaśnięcia.

recent_roads_data tabela

Uwaga: ta tabela jest dostępna tylko wtedy, gdy Twoja umowa obejmuje dane drogowe w czasie rzeczywistym.

W przeciwieństwie do tabeli historical_travel_time ta tabela zawiera też dane SpeedReadingInterval. Oto schemat w BigQuery:

Nazwa Tryb Typ Opis
selected_route_id NULLABLE CIĄG ZNAKÓW selected_route_id trasy
display_name NULLABLE CIĄG ZNAKÓW Wyświetlana nazwa trasy
record_time NULLABLE SYGNATURA CZASOWA Sygnatura czasowa obliczenia danych trasy.
duration_in_seconds NULLABLE LICZBA ZMIENNOPRZECINKOWA Czas przejazdu uwzględniający natężenie ruchu
static_duration_in_seconds NULLABLE LICZBA ZMIENNOPRZECINKOWA czas przejazdu bez uwzględnienia natężenia ruchu;
route_geometry NULLABLE GEOGRAPHY Geometria linii łamanej trasy uwzględniająca ruch
speed_reading_intervals REPEATED REKORD Przedziały reprezentujące natężenie ruchu na trasie. Zobacz oryginalną definicję w interfejsie Routes API
speed_reading_intervals.interval_coordinates REPEATED GEOGRAPHY Geometria tego przedziału
speed_reading_intervals.speed NULLABLE CIĄG ZNAKÓW Klasyfikacja prędkości w tym przedziale. Możliwe wartości: NORMAL, SLOW, TRAFFIC_JAM

Zachowania i fakty dotyczące tabel

  • Tabela jest podzielona na partycje według dnia, a każda partycja ma ustawiony 60-dniowy okres ważności.
  • Tabela jest aktualizowana co godzinę najnowszymi danymi o ruchu zapisanymi w partiach.
  • Po utworzeniu nowej trasy w interfejsie Roads Selection API poczekaj maksymalnie godzinę, aż dane będą dostępne w tej tabeli.
  • Po usunięciu trasy z interfejsu Roads Selection API do tej tabeli nie będą zapisywane żadne nowe dane dotyczące tej trasy. Dane historyczne pozostają jednak dostępne do momentu wygaśnięcia.

routes_status tabela

Tabela zawiera metadane wybranych tras i informacje o ich stanie. Ma to na celu ułatwienie przeglądania wszystkich tras i ich stanu. Można ją łączyć z pozostałymi 2 tabelami w celu filtrowania danych. Oto schemat w BigQuery:

Nazwa Tryb Typ Opis
selected_route_id NULLABLE CIĄG ZNAKÓW selected_route_id trasy
display_name NULLABLE CIĄG ZNAKÓW Wyświetlana nazwa trasy
status NULLABLE CIĄG ZNAKÓW Stan trasy
validation_error NULLABLE CIĄG ZNAKÓW Błąd weryfikacji trasy
low_road_usage_start_time NULLABLE SYGNATURA CZASOWA Czas, w którym podczas ponownej weryfikacji po raz pierwszy zaobserwowano małe natężenie ruchu na trasie. Jest on powiązany z błędem VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes NULLABLE CIĄG ZNAKÓW Atrybuty niestandardowe wybranej trasy

Zachowania i fakty dotyczące tabel

  • W tej tabeli uwzględniane są tylko trasy w stanie STATE_RUNNING lub STATE_INVALID.
  • Metadane i stan tras są aktualizowane co godzinę, bez przerwy.
  • Po utworzeniu nowej trasy w interfejsie Roads Selection API odczekaj do godziny, zanim trasa pojawi się w tej tabeli.
  • Po usunięciu trasy z interfejsu Roads Selection API może minąć nawet godzina, zanim wybrana trasa zostanie usunięta z tej tabeli.