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.

Zebrane dane o drogach są udostępniane w formie danych szeregów czasowych, które obejmują:

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 w chmurze 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 API Analytics Hub.
  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 w ramach 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ć swoje 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. W zapytaniach SQL możesz teraz używać nazw tabel widocznych w panelu Eksploratora, aby uzyskiwać dostęp do danych.

Tabele BigQuery

Zebrane dane drogowe z wybranych tras są hostowane 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ć giełdę 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 każdej tabeli.

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 trwania trasy z uwzględnieniem natężenia ruchu.
static_duration_in_seconds NULLABLE LICZBA ZMIENNOPRZECINKOWA Czas trwania trasy bez uwzględnienia ruchu
route_geometry NULLABLE GEOGRAPHY geometrii linii łamanej trasy uwzględniającej ruch,
road_segment_ids REPEATED CIĄG ZNAKÓW odcinki dróg wzdłuż trasy, reprezentowane jako identyfikatory miejsc;

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 musisz poczekać do godziny, zanim 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 są jednak przechowywane do momentu wygaśnięcia.
  • Odcinki dróg na trasie są ułożone w kolejności topologicznej i zawsze są połączone.

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ż przedziały szybkiego czytania oparte na przesunięciu (speed_reading_offsets) i starsze przedziały szybkiego czytania oparte na współrzędnych (speed_reading_intervals). 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 trwania trasy z uwzględnieniem natężenia ruchu.
static_duration_in_seconds NULLABLE LICZBA ZMIENNOPRZECINKOWA Czas trwania trasy bez uwzględnienia ruchu
route_geometry NULLABLE GEOGRAPHY geometrii linii łamanej trasy uwzględniającej ruch,
speed_reading_intervals REPEATED REKORD Starsze interwały szybkiego czytania oparte na współrzędnych. Może przestać być wypełniane 9 listopada 2026 r. lub później. Zamiast niej używaj zasady speed_reading_offsets. Patrz Przedziały szybkiego czytania.
speed_reading_intervals.interval_coordinates REPEATED GEOGRAPHY Starsza wersja. Może przestać być wypełniane 9 listopada 2026 r. lub później. Zamiast niej używaj zasady speed_reading_offsets. Geometria tego przedziału
speed_reading_intervals.speed NULLABLE CIĄG ZNAKÓW Starsza wersja. Może przestać być wypełniane 9 listopada 2026 r. lub później. Zamiast niej używaj zasady speed_reading_offsets. Klasyfikacja prędkości w tym przedziale. Możliwe wartości: NORMAL, SLOW, TRAFFIC_JAM. W tym starszym polu duże korki (ciemnoczerwone) są też zgłaszane jako TRAFFIC_JAM, a wartość TRAFFIC_JAM_HEAVY nigdy nie jest używana.
road_segment_ids REPEATED CIĄG ZNAKÓW odcinki dróg wzdłuż trasy, reprezentowane jako identyfikatory miejsc;
speed_reading_offsets REPEATED REKORD Przedziały odczytu prędkości oparte na przesunięciu, które reprezentują natężenie ruchu na trasie. Każdy przedział jest wyznaczony przez przesunięcie odległości od początku trasy. Zobacz interwały szybkiego czytania.
speed_reading_offsets.start_offset NULLABLE LICZBA CAŁKOWITA Przesunięcie od początku trasy w metrach dla początku przedziału (włącznie).
speed_reading_offsets.end_offset NULLABLE LICZBA CAŁKOWITA Odległość od początku trasy w metrach do końca przedziału (wyłącznie; równa start_offset następnego przedziału).
speed_reading_offsets.speed NULLABLE CIĄG ZNAKÓW Klasyfikacja prędkości w tym przedziale, zgodna z kolorami na warstwie ruchu w Mapach Google. Możliwe wartości: NORMAL (zielony), SLOW (żółty), TRAFFIC_JAM (czerwony), TRAFFIC_JAM_HEAVY (ciemnoczerwony, dostępny od 8 października 2026 r.)

Zachowania i fakty dotyczące tabel

  • Tabela jest podzielona na partycje według dnia, a każda partycja ma ustawioną datę ważności wynoszącą 60 dni.
  • Tabela jest aktualizowana co godzinę najnowszymi danymi o ruchu zapisanymi w partiach.
  • Po utworzeniu nowej trasy w interfejsie Roads Selection API musisz poczekać do godziny, zanim 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 są jednak przechowywane do momentu wygaśnięcia.
  • Odcinki dróg na trasie są ułożone w kolejności topologicznej i zawsze są połączone.
  • Kolumna speed_reading_offsets jest wypełniana w przypadku wierszy zarejestrowanych 8 października 2026 r. lub później. Wcześniejsze wiersze zawierają puste tablice.
  • Wypełnianie starszej kolumny speed_reading_intervals może zostać wstrzymane 9 listopada 2026 r. lub później. Zamiast niej użyj zasady speed_reading_offsets.

routes_status tabela

Tabela zawiera metadane wybranych tras i informacje o ich stanie. Ma on na celu ułatwienie wyświetlania 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

*Stan trasy w tej tabeli zaczyna się od STATUS_ zamiast STATE_. Jest on w innych aspektach zgodny z interfejsem Roads Selection API.

Zachowania i fakty dotyczące tabel

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