Zebrane dane o drogach

Dane zbiorcze o drogach to dane, które możesz gromadzić z biegiem czasu na potrzeby wybranych tras. Dane zaczniesz otrzymywać, gdy utworzysz trasę za pomocą interfejsu Roads Selection API. Te dane można wykorzystać do szczegółowej analizy, planowania strategicznego i zrozumienia długoterminowego zachowania tras.

Dane zbiorcze o drogach są udostępniane jako dane szeregów czasowych, które obejmują:

  • czas trwania podróży,
  • interwały szybkości czytania (SRI),
  • geometrię trasy,

Konfigurowanie BigQuery

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

Wymagania wstępne

Upewnij się, że projekt w chmurze i konto Google Cloud mają te konfiguracje:

  1. Włącz interfejs BigQuery API. Instrukcje znajdziesz w artykule Tworzenie zapytania do publicznego zbioru danych za pomocą konsoli Google Cloud Console.
  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:
  4. Subskrybent Analytics Hub (roles/analyticshub.subscriber)

Subskrybowanie wymiany danych

Dane o drogach są udostępniane za pomocą prywatnej wymiany danych w BigQuery (Analytics Hub). Aby uzyskać dostęp do danych, otrzymasz od partnera Google specjalny link do subskrypcji. 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. Ten link przekieruje Cię 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

Dane zbiorcze o drogach wybranych tras są przechowywane w izolowanym zbiorze danych BigQuery w projekcie w chmurze należącym do Google. Są one udostępniane za pomocą 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 w chmurze Google.

Udostępniony zbiór danych BigQuery zawiera kilka tabel BigQuery zdefiniowanych i utworzonych przez Google. Poniżej znajdziesz szczegóły każdej tabeli.

Tabela historical_travel_time

Oto schemat tabeli BigQuery historical_travel_time:

Nazwa Tryb Typ Opis
selected_route_id NULLABLE STRING selected_route_id trasy
display_name NULLABLE STRING Wyświetlana nazwa trasy
record_time NULLABLE TIMESTAMP Sygnatura czasowa obliczenia danych trasy
duration_in_seconds NULLABLE LICZBA ZMIENNOPRZECINKOWA Czas trwania trasy uwzględniający natężenie ruchu
static_duration_in_seconds NULLABLE LICZBA ZMIENNOPRZECINKOWA Czas trwania trasy nieuwzględniający natężenia ruchu
route_geometry NULLABLE GEOGRAPHY Geometria linii łamanej trasy uwzględniająca natężenie ruchu

Zachowanie tabeli i fakty

  • Tabela jest podzielona na partycje według dni, a każda partycja ma ustawiony 10-letni okres ważności.
  • Tabela jest aktualizowana co godzinę najnowszymi danymi o natężeniu ruchu zapisanymi w pakietach.
  • Po utworzeniu nowej trasy w interfejsie Roads Selection API musisz poczekać do 1 godziny, 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 pozostaną jednak dostępne do momentu wygaśnięcia.

Tabela recent_roads_data

Uwaga: ta tabela jest dostępna tylko wtedy, gdy umowa obejmuje dane o drogach 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 STRING selected_route_id trasy
display_name NULLABLE STRING Wyświetlana nazwa trasy
record_time NULLABLE TIMESTAMP Sygnatura czasowa obliczenia danych trasy
duration_in_seconds NULLABLE LICZBA ZMIENNOPRZECINKOWA Czas trwania trasy uwzględniający natężenie ruchu
static_duration_in_seconds NULLABLE LICZBA ZMIENNOPRZECINKOWA Czas trwania trasy nieuwzględniający natężenia ruchu
route_geometry NULLABLE GEOGRAPHY Geometria linii łamanej trasy uwzględniająca natężenie ruchu
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 STRING Klasyfikacja prędkości w tym przedziale. Możliwe wartości: NORMAL (NORMALNA), SLOW (WOLNA), TRAFFIC_JAM (KOREK)

Zachowanie tabeli i fakty

  • Tabela jest podzielona na partycje według dni, a każda partycja ma ustawiony 60-dniowy okres ważności.
  • Tabela jest aktualizowana co godzinę najnowszymi danymi o natężeniu ruchu zapisanymi w pakietach.
  • Po utworzeniu nowej trasy w interfejsie Roads Selection API musisz poczekać do 1 godziny, 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 pozostaną jednak dostępne do momentu wygaśnięcia.

Tabela routes_status

Tabela zawiera metadane wybranych tras i informacje o ich stanie. Ułatwia ona wyświetlanie wszystkich tras i ich stanu. Można ją połączyć z pozostałymi 2 tabelami w celu filtrowania danych. Oto schemat w BigQuery:

Nazwa Tryb Typ Opis
selected_route_id NULLABLE STRING selected_route_id trasy
display_name NULLABLE STRING Wyświetlana nazwa trasy
status* NULLABLE STRING Stan trasy
validation_error NULLABLE STRING Błąd weryfikacji trasy
low_road_usage_start_time NULLABLE TIMESTAMP Czas, w którym podczas ponownej weryfikacji po raz pierwszy zaobserwowano niskie wykorzystanie drogi. Jest on powiązany z błędem VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes NULLABLE STRING Atrybuty niestandardowe wybranej trasy

*Stan trasy w tej tabeli zaczyna się od STATUS_ zamiast STATE_. W przeciwnym razie jest on zgodny z interfejsem Roads Selection API.

Zachowanie tabeli i fakty

  • Ta tabela zawiera tylko trasy w stanie STATUS_RUNNING lub STATUS_INVALID.
  • Metadane i stan tras są aktualizowane co godzinę.
  • Po utworzeniu nowej trasy w interfejsie Roads Selection API musisz poczekać do 1 godziny, aż trasa będzie dostępna w tej tabeli.
  • Po usunięciu trasy z interfejsu Roads Selection API musisz poczekać do 1 godziny, aż wybrana trasa zostanie usunięta z tej tabeli.