Rozkład jazdy GTFS Google i różnice

Na tej stronie opisujemy główne różnice między oficjalnym harmonogramem GTFS a wdrożeniem specyfikacji przez Transport publiczny Google w tych obszarach:

  • Ignorowane oficjalne specyfikacje: te pola są częścią oficjalnej specyfikacji GTFS. Transport publiczny Google pozyskuje te dane bez błędów, ale nie z nich korzysta aktywnie.

  • Różna interpretacja: te pola obejmują części oficjalnej wersji GTFS, które Transport publiczny Google interpretuje inaczej niż definicja tych części podana przez GTFS.

  • Pomoc eksperymentalna: te pola są w fazie eksperymentalnej w ramach implementacji Transportu publicznego Google. Jeśli chcesz wdrożyć nowe eksperymentalne pole, skontaktuj się z zespołem Transportu publicznego Google.

  • Rozszerzenie obsługiwane przez Transport publiczny Google: to rozszerzenie nie jest częścią oficjalnej wersji GTFS. Rozszerzenie obsługujące transport publiczny obejmuje zarówno rozszerzenia publiczne, jak i te związane z Transportem publicznym Google. Każdy partner może wysłać te informacje do Transportu publicznego w swoim pliku danych.

Statyczny transport publiczny

W kolejnych sekcjach opisano główne różnice między oficjalną wersją GTFS a implementacją statycznego pliku danych w Transportie publicznym Google.

Ignorowane oficjalne specyfikacje w statycznych plikach danych

Niektóre oficjalne specyfikacje, które są ignorowane przez transport publiczny, mają charakter eksperymentalny. Więcej informacji znajdziesz na gtfs.org.

Tabela 1 zawiera listę plików GTFS, które nie są obsługiwane przez Transport publiczny w statycznych plikach danych. Żadne z pól zdefiniowanych w tych plikach nie jest obsługiwane przez transport publiczny.

Tabela 1. Nieobsługiwane pliki GTFS w statycznych plikach danych
areas.txt
fare_leg_rules.txt
fare_products.txt
fare_transfer_rules.txt
levels.txt
stop_areas.txt

Tabela 2 zawiera wszystkie pola zdefiniowane przez GTFS, które są ignorowane przez transport w statycznych plikach danych.

Tabela 2. Ignorowane pola GTFS w statycznych plikach danych
Nazwa pliku Ignorowane pole zdefiniowane w GTFS Typ pola
fare_attributes.txt payment_method Enum
feed_info.txt default_lang Kod języka
feed_info.txt feed_publisher_name Tekst
pathways.txt max_slope Liczba zmiennoprzecinkowa
routes.txt continuous_drop_off Enum
routes.txt continuous_pickup Enum
routes.txt network_id Identyfikator
routes.txt route_desc Tekst
routes.txt route_sort_order Nieujemna liczba całkowita
stops.txt level_id Identyfikator
stops.txt stop_desc Tekst
stops.txt stop_url URL
stops.txt tts_stop_name Tekst
stops.txt bikes_allowed Enum

Różna interpretacja statycznych plików danych

Chociaż funkcja Transport publiczny akceptuje niektóre pola zdefiniowane w GTFS, interpretuje je inaczej niż GTFS.

Tabela 3 przedstawia pola w statycznych plikach danych, które Transport publiczny implementuje inaczej niż w raporcie GTFS.

Tabela 3. Różne statyczne pola kanału danych
Nazwa pliku Pole zdefiniowane w GTFS Typ pola Wymagana przez Transport publiczny Google? Szczegóły implementacji Transportu publicznego Google
fare_attributes.txt transfers Enum Wymagane

Rozszerzenie Transport publiczny Google.

Publiczna tabela GTFS ogranicza wartości do zakresu od 0 do 2. Transport publiczny Google akceptuje wartości od 0 do 5.

Użyj tego pola, aby ustawić maksymalną liczbę dozwolonych transferów w ramach ceny. Nie obejmuje to transferów blokowych (nazywanych też transferami na stanowisko). Jeśli nie chcesz ustawiać limitów liczby przesiadek w danej cenie, pozostaw pole transfers puste.
pathways.txt pathway_mode Enum Opcjonalnie Gdy pole pathway_mode zostanie określone, a pozostanie ono puste, Transport publiczny Google będzie je akceptować i traktować jako nieznane.
stop_times.txt arrival_time Godzina Wymagane warunkowo Godziny są ograniczone do wartości z zakresu od 00 do 99, co jest wystarczające w przypadku 3-dniowych podróży.
transfers.txt transfer_type Enum Wymagane

Wartości 4 i 5 nie są obsługiwane i są ignorowane.

Transport publiczny Google obsługuje wartości 0, 1, 2 i 3.
trips.txt block_id Identyfikator Opcjonalnie Więcej informacji znajdziesz w artykule Przykład blokowania przenoszenia.

Eksperymentalna obsługa statycznych plików danych

Jeśli potrzebujesz pomocy przy integracji nowych eksperymentalnych pól w tej kategorii, skontaktuj się z Transportem publicznym Google.

Rozszerzenia obsługiwane przez Transport publiczny Google w statycznych plikach danych

Tabela 4 zawiera informacje o rozszerzeniach Google Transport publiczny. Te pola nie są częścią oficjalnej wersji pliku danych GTFS.

Tabela 4. Obsługiwane statyczne rozszerzenia pliku danych
Nazwa pliku Pole Typ pola Wymagana przez Transport publiczny Google? Szczegóły implementacji Transportu publicznego Google
fare_attributes.txt ic_price Liczba zmiennoprzecinkowa Opcjonalnie

To rozszerzenie Transport publiczny Google jest dostępne tylko dla partnerów w Japonii.

Pole ic_price podaje obniżoną kwotę, którą należy zapłacić za tę cenę za pomocą karty inteligentnej. Jeśli w przypadku tej ceny nie ma rabatów lub karta inteligentna nie jest obsługiwana, pole ic_price musi mieć wartość -1.
fare_rules.txt contains_route_id Identyfikator Opcjonalnie

Rozszerzenie Transport publiczny Google.

Ta opłata dotyczy tylko podróży, które odwiedzają dokładny zestaw tras określonych przez wartość route_id we wszystkich wierszach tej kombinacji kolumn fare_id, origin_id i destination_id.

Jeśli brakuje kolumny contains_route_id lub wszystkie wartości dotyczące tej opłaty mają wartość null, cena nie jest ograniczona w tym parametrze. Jeśli pole contains_route_id jest podane dla ceny, pole route_id musi być puste.
routes.txt checkin_duration Liczba całkowita Opcjonalnie

Rozszerzenie Transport publiczny Google.

Pole checkin_duration określa, o ile sekund pasażer powinien dotrzeć wcześniej przed planowanym odjazdem, aby odprawić się i wsiąść do pociągu.

Jeśli pasażer dojeżdża do odlotu środkami transportu, czas przewozu ma pierwszeństwo przed wartością checkin_duration.

Wartość checkin_duration to tylko zalecenie, które zwykle podaje operator transportu publicznego. Nie musi to być ostatni możliwy moment, w którym pasażer może wejść na pokład i wsiąść do niego.
routes.txt route_type Enum Wymagane

Rozszerzenie Transport publiczny Google.

Aby dowiedzieć się, jak Transport publiczny Google rozszerza opcje wartości route_type akceptowane przez GTFS, zapoznaj się z informacjami o rozszerzonych typach tras GTFS.
stop_times.txt stop_direction_name Tekst Opcjonalnie

Rozszerzenie Transport publiczny Google.

Pole stop_direction_name określa trasę podróży dla pasażerów. Kierunek jest przechowywany jako wartość direction_name przejazdu z tego przystanku.

Jeśli pole stop_direction_name jest puste, zamiast niego używane jest pole trip_direction_name obsługiwane za pomocą transportu publicznego. Jeśli pola trip_direction_name i stop_direction_name są puste, importer transportu publicznego pozostawi je puste. W takich przypadkach partnerzy mogą używać wartości stop_headsign lub trip_headsign. W wartościach pola stop_direction_name wielkość liter jest znormalizowana.
stops.txt signposted_as Tekst Opcjonalnie

Rozszerzenie Transport publiczny Google.

Pole signposted_as zawiera tekst dosłowny napisany na szyldu platformy. Przykłady to „Towards Central” (Towards Central) oraz „East side & Brooklyn”.

Pole GTFS platform_code i pole signposted_as obsługiwane przez transport publiczny można ustawić jednocześnie.

Różnice między polami platform_code i signposted_as są takie:

  • Długość. Pole platform_code zwykle zawiera cyfrę lub literę, np. 2 lub C.
  • Język. Pole platform_code nie ma określonego języka, ale wartości signposted_as mogą mieć tłumaczenia.
  • Stabilność. Pole platform_code zmienia się znacznie rzadziej niż pole signposted_as.
stops.txt vehicle_type Liczba całkowita Opcjonalnie

Rozszerzenie Transport publiczny Google.

Pole vehicle_type określa typ pojazdów używanych na postoju. To pole akceptuje typy tras hierarchicznych typów pojazdów (HVT). Wartości HVT pochodzą z europejskiego standardu TPEG (European Transport Protocol Expert Group).
agency.txt ticketing_deep_link_id Identyfikator Opcjonalnie

Rozszerzenie sprzedaży biletów w Transportie publicznym Google.

W pliku agency.txt pole ticketing_deep_link_id wskazuje precyzyjny link, który służy do zgłaszania biletów na przejazdy tej agencji.
routes.txt ticketing_deep_link_id Identyfikator Opcjonalnie

Rozszerzenie sprzedaży biletów w Transportie publicznym Google.

W pliku routes.txt pole ticketing_deep_link_id odpowiada precyzyjnemu linkowi, który służy do zgłaszania biletów na przejazdy na tej trasie.
stop_times.txt ticketing_stop_time_id Identyfikator Opcjonalnie

Rozszerzenie sprzedaży biletów w Transportie publicznym Google.

Jeśli znajduje się w pliku stop_times.txt, pole ticketing_stop_time_id zastępuje identyfikator określający czas zakończenia sprzedaży biletów z precyzyjnymi linkami.
stop_times.txt ticketing_type Enum Opcjonalnie

Rozszerzenie sprzedaży biletów w Transportie publicznym Google.

Pole ticketing_type określa typ biletów, które mają zastosowanie do tego czasu zakończenia.

Transport publiczny Google akceptuje te wartości:

  • Empty. Domyślna – zgodnie z definicją podróży.
  • 0. Dostępne tylko wtedy, gdy agencja lub trasa ma włączony precyzyjny link do sprzedaży biletów.
  • 1. Niedostępne.
ticketing_deep_links.txt android_intent_uri Identyfikator URI Opcjonalnie

Rozszerzenie sprzedaży biletów w Transportie publicznym Google.

Pole android_intent_uri podaje identyfikator URI intencji, który jest używany na potrzeby precyzyjnych linków na Androidzie.
ticketing_deep_links.txt ios_universal_link_url URL Opcjonalnie

Rozszerzenie sprzedaży biletów w Transportie publicznym Google.

Pole ios_universal_link_url podaje uniwersalny adres URL linku, który jest używany do tworzenia precyzyjnych linków w iOS.
ticketing_deep_links.txt ticketing_deep_link_id Identyfikator Wymagane

Rozszerzenie sprzedaży biletów w Transportie publicznym Google.

Pole ticketing_deep_link_id podaje identyfikator precyzyjnego linku.
ticketing_deep_links.txt web_url URL Opcjonalnie

Rozszerzenie sprzedaży biletów w Transportie publicznym Google.

Pole web_url podaje adres URL używany do tworzenia precyzyjnych linków w internecie.
ticketing_identifiers.txt agency_id Identyfikator Wymagane

Rozszerzenie sprzedaży biletów w Transportie publicznym Google.

Aby określić agencję przystanku, dla którego zdefiniowane jest domyślne pole ticketing_stop_id, pole agency_id zawiera identyfikator z pliku GTFS agency.txt.
ticketing_identifiers.txt stop_id Identyfikator Wymagane

Rozszerzenie sprzedaży biletów w Transportie publicznym Google.

Aby określić przystanek, dla którego zdefiniowano domyślne pole ticketing_stop_id, pole stop_id zawiera identyfikator z pliku GTFS stops.txt.
ticketing_identifiers.txt ticketing_stop_id Identyfikator Wymagane

Rozszerzenie sprzedaży biletów w Transportie publicznym Google.

Pole ticketing_stop_id zawiera identyfikator biletu, który jest stosowany do przystanku. Opcjonalnie agencja kwalifikuje identyfikator.
trips.txt exceptional Enum Opcjonalnie

To pole wskazuje wyjątkowe podróże. Działają one poza zwykłym harmonogramem lub zostały wyrzucone z trasy na zwykłej trasie z powodu specjalnych wydarzeń lub planowanych zakłóceń (np. prac nad trasami).

Google akceptuje te opcje wartości:

  • 0. Standardowe usługi
  • 1. Wyjątek związany z usługą. Dotyczy to na przykład usług dodanych w związku z wydarzeniami specjalnymi lub przerwami w korzystaniu ze zwykłej trasy.
trips.txt ticketing_trip_id Identyfikator Opcjonalnie

Rozszerzenie sprzedaży biletów w Transportie publicznym Google.

Jeśli pole ticketing_trip_id jest obecne, jego wartość zastępuje pole trip_id, aby zidentyfikować podróż na potrzeby sprzedaży biletów z precyzyjnymi linkami.
trips.txt ticketing_type Enum Opcjonalnie

Rozszerzenie sprzedaży biletów w Transportie publicznym Google.

Pole ticketing_type określa typ biletu, który ma zastosowanie do tej podróży.

Transport publiczny Google akceptuje te wartości:

  • 0. Domyślna. Dostępne tylko wtedy, gdy agencja lub trasa ma włączony precyzyjny link do sprzedaży biletów.
  • 1. Niedostępne.
translations.txt lang Kod języka Opcjonalnie

Rozszerzenie Transport publiczny Google.

Pole lang nie jest częścią oficjalnej danych GTFS, ale Transport publiczny Google korzysta z tej wartości, jeśli jest dostępna.

Aby określić tłumaczenie wyrażenia, użyj pola lang. Jego wartość nie może być pusta ani und (nieokreślony język).
translations.txt trans_id Identyfikator Opcjonalnie

Rozszerzenie Transport publiczny Google.

Pole trans_id nie jest częścią oficjalnej danych GTFS, ale Transport publiczny Google korzysta z tej wartości, jeśli jest dostępna.

Aby podać token identyfikatora wyrażenia, dla którego ma być tłumaczenie, użyj pola trans_id. Każdy wiersz tabeli translations.txt oznacza, że w języku lang wyrażenie trans_id oznacza język translation.
trips.txt original_trip_id Identyfikator Opcjonalnie

Rozszerzenie Transport publiczny Google.

Jeśli występuje w pliku trips.txt, wartość original_trip_id zastępuje wartość trip_id do użytku w innych systemach. Przykładem może być dopasowywanie w czasie rzeczywistym.
trips.txt trip_direction_name Tekst Opcjonalnie

Rozszerzenie Transport publiczny Google.

Pole trip_direction_name określa trasę podróży dla pasażerów. Wartość w tym polu jest przechowywana jako wartość direction_name każdej podróży.

Jeśli wartość stop_direction_name w tabeli stop_times zmieni się podczas podróży, może ona zastąpić wartość trip_direction_name.

Wielkość liter w wartościach w polu trip_direction_name jest znormalizowana.
trips.txt vehicle_category_id Identyfikator Opcjonalnie

Rozszerzenie Transport publiczny Google.

W pliku trips.txt pole vehicle_category_id wskazuje pojazd przypisany do tej podróży. Gdy to pole znajduje się w pliku trips.txt, jego wartość zastępuje wartość vehicle_category_id w pliku routes.txt.