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 zrozumienia długoterminowego zachowania tras.

Zgromadzone dane o drogach są podawane jako dane serii czasowej, 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 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 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 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 nie są zapisywane w tej tabeli żadne nowe dane dotyczące tej trasy. Dane historyczne pozostają jednak do momentu wygaśnięcia.
  • Odcinki drogi na trasie są ułożone w porządku topologicznym i zawsze są połączone.

recent_roads_data tabela

Uwaga: ta tabela jest dostępna tylko wtedy, gdy Twoja umowa obejmuje dane o drogach 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. Mogą przestać być wypełniane 9 listopada 2026 r. lub później. Użyj w zamian 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. Użyj w zamian zasady speed_reading_offsets. Klasyfikacja prędkości dla tego interwału. Możliwe wartości: NORMAL (normalny), SLOW (wolny), TRAFFIC_JAM (korek). 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 prędkości oparte na przesunięciu, które reprezentują natężenie ruchu na trasie. Każdy przedział jest wyznaczany przez odległość od początku trasy. Patrz Przedziały szybkiego czytania.
speed_reading_offsets.start_offset NULLABLE LICZBA CAŁKOWITA Odległość od początku trasy w metrach dla początku interwał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łniona 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 i informacje o stanie wybranych tras. Ma on na celu ułatwienie wyświetlania wszystkich tras i stanów. 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 po raz pierwszy zaobserwowano niskie wykorzystanie drogi podczas ponownej weryfikacji. 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 zniknie z tej tabeli.