Zebrane dane o drogach

Zgromadzone dane o drogach to dane, które możesz gromadzić w miarę upływu czasu na wybranych trasach. 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

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

  1. Włącz BigQuery API. Instrukcje znajdziesz w artykule Tworzenie zapytania do 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ń. Upewnij się, że Twoje konto ma te role, aby wykonywać zadania subskrybenta i tworzyć zbiory danych:
  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). Otrzymasz od partnera Google 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. 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. Możesz teraz używać nazw tabel widocznych w panelu Eksploratora, aby uzyskiwać dostęp do danych w zapytaniach SQL.

Tabele BigQuery

Zgromadzone dane o wybranych trasach są przechowywane w odizolowanym zbiorze danych BigQuery w projekcie w chmurze należącym do Google. Są one udostępniane za pomocą prywatnej wymiany danych utworzonej wyłącznie 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 projekcie Google Cloud.

Udostępniony zbiór danych BigQuery zawiera kilka tabel BigQuery, które są zdefiniowane i utworzone 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. Pominięto (NULL), gdy has_road_closure to true.
static_duration_in_seconds NULLABLE LICZBA ZMIENNOPRZECINKOWA Czas trwania trasy bez uwzględnienia ruchu drogowego.
route_geometry NULLABLE GEOGRAPHY Geometria linii łamanej trasy uwzględniająca natężenie ruchu.
road_segment_ids REPEATED CIĄG ZNAKÓW odcinki dróg na trasie, reprezentowane jako identyfikatory miejsc;
has_road_closure NULLABLE WARTOŚĆ LOGICZNA Czy na trasie jest całkowicie zamknięta droga. Gdy true, duration_in_seconds jest pomijany (NULL), ponieważ trasa jest nieprzejezdna. Wartość NULL oznacza, że informacje o zamknięciu drogi są nieokreślone.

Zachowania i fakty dotyczące tabel

  • 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ę, a najnowsze dane o ruchu są zapisywane zbiorczo.
  • Po utworzeniu nowej trasy w interfejsie Roads Selection API dane w tej tabeli powinny być dostępne w ciągu godziny.
  • 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.
  • Flaga has_road_closure jest zgodna ze stanem całkowitego zamknięcia drogi w Mapach Google.

recent_roads_data tabela

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

W odróżnieniu od tabeli historical_travel_time ta tabela zawiera też interwały szybkiego odczytu oparte na przesunięciu (speed_reading_offsets) oraz starsze interwały szybkiego odczytu 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. Pominięto (NULL), gdy has_road_closure to true.
static_duration_in_seconds NULLABLE LICZBA ZMIENNOPRZECINKOWA Czas trwania trasy bez uwzględnienia ruchu drogowego.
route_geometry NULLABLE GEOGRAPHY Geometria linii łamanej trasy uwzględniająca natężenie ruchu.
speed_reading_intervals REPEATED REKORD Starsze interwały odczytu prędkości na podstawie współrzędnych. Mogą przestać być wypełniane 9 listopada 2026 r. lub później. Użyj w zamian zasady speed_reading_offsets. Patrz Interwały odczytu prędkości.
speed_reading_intervals.interval_coordinates REPEATED GEOGRAPHY Starsza wersja. Mogą przestać być wypełniane 9 listopada 2026 r. lub później. Użyj w zamian zasady speed_reading_offsets. Geometria dla tego interwał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 w tym interwale. Możliwe wartości: NORMAL (normalny), SLOW (wolny), TRAFFIC_JAM (korek). W tym starszym polu duże korki (ciemnoczerwone) są również zgłaszane jako TRAFFIC_JAM; wartość TRAFFIC_JAM_HEAVY nigdy nie jest używana.
road_segment_ids REPEATED CIĄG ZNAKÓW odcinki dróg na trasie, 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 przesunięcie odległości od początku trasy. Pomijane, gdy has_road_closure ma wartość true. Patrz Interwały odczytu prędkości.
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 się start_offset kolejnego przedziału)
speed_reading_offsets.speed NULLABLE CIĄG ZNAKÓW Klasyfikacja prędkości dla tego interwału, zgodna z kolorami w warstwie natężenia 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.)
has_road_closure NULLABLE WARTOŚĆ LOGICZNA Czy na trasie jest całkowicie zamknięta droga. Gdy true, duration_in_seconds i speed_reading_offsets są pomijane, ponieważ trasa jest nieprzejezdna. Wartość NULL wskazuje, że informacje o zamknięciu drogi są nieokreślone.

Zachowania i fakty dotyczące tabel

  • 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ę, a najnowsze dane o ruchu są zapisywane zbiorczo.
  • Po utworzeniu nowej trasy w interfejsie Roads Selection API dane w tej tabeli powinny być dostępne w ciągu godziny.
  • Po usunięciu trasy z interfejsu Roads Selection API nie będą do niej zapisywane żadne nowe dane. 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.
  • 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.
  • 9 listopada 2026 r. lub później możemy przestać wypełniać starszą kolumnę speed_reading_intervals. Użyj w zamian zasady speed_reading_offsets.
  • Flaga has_road_closure jest zgodna ze stanem całkowitego zamknięcia drogi w Mapach Google.

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ą połączyć z pozostałymi 2 tabelami, aby filtrować dane. 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 powiązany z błędem VALIDATION_ERROR_LOW_ROAD_USAGE.
route_attributes NULLABLE CIĄG ZNAKÓW Atrybuty niestandardowe wybranej trasy
dynamic_routing NULLABLE WARTOŚĆ LOGICZNA Wskazuje, czy trasa jest dynamiczna (true) czy stała (false). Zobacz dynamicRouting.
pochodzenie NULLABLE GEOGRAPHY Punkt orientacyjny miejsca wyjazdu na trasie.
usługa docelowa | konto usługi docelowej NULLABLE GEOGRAPHY Docelowy punkt na trasie
półprodukty REPEATED GEOGRAPHY Punkty pośrednie trasy
static_route_geometry NULLABLE GEOGRAPHY Geometria linii łamanej trasy statycznej obliczona bez uwzględnienia natężenia ruchu w czasie rzeczywistym z punktów pośrednich
road_segment_ids REPEATED CIĄG ZNAKÓW Odcinki drogi na trasie statycznej obliczonej bez uwzględnienia ruchu na żywo, reprezentowane jako identyfikatory miejsc.

Zachowania i fakty dotyczące tabel

  • W tej tabeli uwzględniane są tylko trasy o stanie STATUS_RUNNING lub STATUS_INVALID.
  • Metadane i stan tras są aktualizowane co godzinę, przez całą dobę.
  • Po utworzeniu nowej trasy w interfejsie Roads Selection API może minąć do godziny, zanim pojawi się ona 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.
  • W przypadku stałych tras (dynamic_routing: false) identyfikatory miejsc w road_segment_ids są automatycznie aktualizowane, aby odzwierciedlać zmiany w sieci dróg Google, ale nadal reprezentują tę samą trasę. W przypadku tras dynamicznych (dynamic_routing: true) wartość road_segment_ids nie jest aktualizowana.