Rozkład jazdy GTFS Google i różnice

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

  • Ignorowane oficjalne specyfikacje: te pola są częścią oficjalnych GTFS. Transport publiczny Google przetwarza te dane bez błędów, ale nie wykorzystuje aktywnie dane.

  • Inna interpretacja: te pola obejmują fragmenty kodu GTFS, który Google Transport publiczny interpretuje inaczej niż definicja GTFS te części.

  • Pomoc eksperymentalna: te pola mają charakter eksperymentalny w funkcji Transport publiczny implementacji. Jeśli chcesz wdrożyć nowe pole eksperymentalne, skontaktuj się z Zespół Transportu publicznego Google

  • Rozszerzenie obsługiwane przez Transport publiczny Google: to rozszerzenie nie jest częścią oficjalnego dokumentu GTFS. Rozszerzenie obsługiwane przez transport publiczny zawiera oba rozszerzenia publiczne i rozszerzenia dotyczące Transportu publicznego Google. Każdy partner może wysłać te informacje do Transport publiczny w pliku danych.

Statyczny transport publiczny

W sekcjach poniżej opisujemy główne różnice między oficjalną wersją GTFS i wdrożenie statycznego pliku danych przez Transport publiczny Google.

Ignorowanie oficjalnych specyfikacji w statycznych plikach danych

Niektóre oficjalne specyfikacje, które są ignorowane przez funkcję transportu publicznego, mają charakter eksperymentalny. Do 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 w pliku GTFS, które są ignorowane przez funkcję Transport publiczny w statycznych plików danych.

Tabela 2. Ignorowanie pól GTFS w statycznych plikach danych
Nazwa pliku Zignorowane pole zdefiniowane w pliku GTFS Typ pola
fare_attributes.txt payment_method Typ wyliczeniowy
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 Typ wyliczeniowy
routes.txt continuous_pickup Typ wyliczeniowy
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
trips.txt bikes_allowed Typ wyliczeniowy

Inna interpretacja statycznych plików danych

Chociaż usługa Transport publiczny akceptuje określone pola zdefiniowane przez GTFS, usługa Transport publiczny je interpretuje inaczej niż GTFS.

Tabela 3 przedstawia pola w statycznych plikach danych, w przypadku których Transport publiczny jest implementowany w inny sposób niż opisano w GTFS.

Tabela 3. Inaczej zaimplementowane pola statycznego pliku danych
Nazwa pliku Pole zdefiniowane w GTFS Typ pola Wymagana przez Transport publiczny Google? Szczegóły implementacji Transportu publicznego Google
fare_attributes.txt transfers Typ wyliczeniowy Wymagane

Rozszerzenie Transport publiczny Google.

Publiczny plik GTFS ogranicza wartości do zakresu od 0 do 2 Transport publiczny Google akceptuje wartości od 0 do 5

Użyj tego pola, by ustawić maksymalną liczbę dozwolonych transferów z koszt. Nie obejmuje to transferów blokowych (na stanowiskach). transfery danych. Jeśli nie chcesz ustawiać limitów liczby transferów podaj cenę, pozostaw pole transfers puste.
pathways.txt pathway_mode Typ wyliczeniowy Opcjonalnie Jeśli pole pathway_mode jest określone, jeśli zostało wypełnione pusty, oznacza to, że funkcja Transport publiczny Google akceptuje go i traktuje jako nieznane.
stop_times.txt arrival_time Godzina Wymagane warunkowo Godziny są ograniczone do wartości od 00 do 99, co jest wystarczające na trzydniowe podróże.
transfers.txt transfer_type Typ wyliczeniowy 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 Blokowanie przenoszenia danych.

Eksperymentalna obsługa statycznych plików danych

Jeśli potrzebujesz pomocy przy zintegrowaniu 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 Transport publiczny Google. Te pola nie należą do oficjalnego GTFS.

Tabela 4. Obsługiwane rozszerzenia statycznego 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 następujących krajach: Japan;

Pole ic_price reprezentuje obniżoną kwotę którą trzeba zapłacić za te ceny za pomocą karty inteligentnej. Jeśli nie ma rabatów lub karta inteligentna nie jest obsługiwana, Pole ic_price musi zawierać wartość -1.
fare_rules.txt contains_route_id Identyfikator Opcjonalnie

Rozszerzenie Transport publiczny Google.

Ta cena dotyczy tylko podróży obejmujących dokładny zestaw tras identyfikowane przez wartość route_id we wszystkich wierszach dla tego elementu kombinacji funkcji fare_id, origin_id i Kolumny: destination_id.

Jeśli brakuje kolumny contains_route_id lub wszystkie jej kolumny ta cena ma wartość null, cena nie jest ograniczona w tym . Jeśli pole contains_route_id jest określone 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 liczbę sekund pasażer powinien przybyć wcześniej przed planowanym odlotem aby zameldować się i wejść na pokład.

Jeśli pasażer połączy się z odlotem przez przesiadkę, wtedy: określony czas przesyłania zastępuje wartość checkin_duration.

Wartość checkin_duration to tylko rekomendacja, która jest zwykle dostarczane przez operatora transportu publicznego. Może nie odzwierciedlać wartości bezwzględnej ostatni moment, w którym pasażer może przyjechać i wsiąść na pokład pojazdu.
routes.txt route_type Typ wyliczeniowy Wymagane

Rozszerzenie Transport publiczny Google.

Aby dowiedzieć się, jak Transport publiczny Google rozszerza zakres route_type zaakceptowany przez GTFS opcji wartości, patrz Rozszerzone typy tras GTFS.
stop_times.txt stop_direction_name Tekst Opcjonalnie

Rozszerzenie Transport publiczny Google.

Pole stop_direction_name określa kierować je do pasażerów. Kierunek jest zapisywany jako direction_name jaka jest wartość odjazdu z tego przystanku.

Jeśli pole stop_direction_name jest puste, Zamiast niego używane jest pole trip_direction_name obsługiwane przez transport publiczny. Jeśli trip_direction_name i stop_direction_name oba pola są puste, wówczas importer transportu publicznego pozostawia je puste. W w takim przypadku partnerzy mogą korzystać z stop_headsign lub trip_headsign. Wartości parametru W polach stop_direction_name wielkość liter jest znormalizowana.
stops.txt signposted_as Tekst Opcjonalnie

Rozszerzenie Transport publiczny Google.

Pole signposted_as zawiera dosłowny tekst na tablicy informacyjnej. Przykłady: „W kierunku centrum”. oraz "Wschodnia część Brooklyn”.

Pole GTFS platform_code i typ transportu publicznego Pole signposted_as można ustawić jednocześnie.

Różnice między wartościami platform_code a Pola signposted_as obejmują te elementy:

  • Długość. W polu platform_code zwykle zawiera cyfrę lub literę, np. 2 lub C.
  • Język: Pole platform_code nie zawiera język, ale wartości signposted_as mogą mieć tłumaczenie.
  • Stabilność. Pole platform_code zmieni się znacznie rzadziej niż w przypadku pola signposted_as.
stops.txt vehicle_type Liczba całkowita Opcjonalnie

Rozszerzenie Transport publiczny Google.

Pole vehicle_type określa typ pojazdów, które są używane w danym momencie. To pole akceptuje hierarchiczny typ pojazdu (HVT) różnych typów tras. Wartości HVT pochodzą z Europejskiego Obszaru Gospodarczego, standardu TPEG.
agency.txt ticketing_deep_link_id Identyfikator Opcjonalnie

Rozszerzenie dotyczące sprzedaży biletów w transporcie publicznym Google.

W agency.txt, ticketing_deep_link_id zawiera precyzyjny link używany do rezerwacji biletów na przejazd agencjami.
routes.txt ticketing_deep_link_id Identyfikator Opcjonalnie

Rozszerzenie dotyczące sprzedaży biletów w transporcie publicznym Google.

W routes.txt, ticketing_deep_link_id zawiera precyzyjny link używany do rezerwacji biletów na przejazd .
stop_times.txt ticketing_stop_time_id Identyfikator Opcjonalnie

Rozszerzenie dotyczące sprzedaży biletów w transporcie publicznym Google.

Jeśli znajduje się w stop_times.txt, ticketing_stop_time_id zastępuje identyfikator, który reprezentuje czas zakończenia sprzedaży biletów. dzięki precyzyjnym linkom.
stop_times.txt ticketing_type Typ wyliczeniowy Opcjonalnie

Rozszerzenie dotyczące sprzedaży biletów w transporcie publicznym Google.

Pole ticketing_type określa typ biletu która ma zastosowanie do tego czasu zakończenia.

Transport publiczny Google akceptuje te wartości:

  • Empty. Wartość domyślna – zdefiniowana w podróży.
  • 0. Dostępne tylko wtedy, gdy agencja lub trasa mają precyzyjny link do sprzedaży biletów.
  • 1. Niedostępne.
ticketing_deep_links.txt android_intent_uri Identyfikator URI Opcjonalnie

Rozszerzenie dotyczące sprzedaży biletów w transporcie publicznym Google.

Pole android_intent_uri reprezentuje identyfikator URI intencji który służy do tworzenia precyzyjnych linków na Androidzie.
ticketing_deep_links.txt ios_universal_link_url URL Opcjonalnie

Rozszerzenie dotyczące sprzedaży biletów w transporcie publicznym Google.

Pole ios_universal_link_url reprezentuje wartość uniwersalną URL linku, który jest używany w przypadku precyzyjnych linków w iOS.
ticketing_deep_links.txt ticketing_deep_link_id Identyfikator Wymagane

Rozszerzenie dotyczące sprzedaży biletów w transporcie publicznym Google.

Identyfikator zawiera pole ticketing_deep_link_id precyzyjnego linku.
ticketing_deep_links.txt web_url URL Opcjonalnie

Rozszerzenie dotyczące sprzedaży biletów w transporcie publicznym Google.

Pole web_url reprezentuje adres URL używany w przypadku precyzyjnych danych w sieci.
ticketing_identifiers.txt agency_id Identyfikator Wymagane

Rozszerzenie dotyczące sprzedaży biletów w transporcie publicznym Google.

Aby określić agencję przystanku, z którym domyślnie korzysta ticketing_stop_id pole agency_id zawiera identyfikator od GTFS agency.txt.
ticketing_identifiers.txt stop_id Identyfikator Wymagane

Rozszerzenie dotyczące sprzedaży biletów w transporcie publicznym Google.

Aby określić przystanek, z którego korzysta domyślny ticketing_stop_id dla pola stop_id zawiera identyfikator z ogólna specyfikacja pliku danych transportu publicznego stops.txt.
ticketing_identifiers.txt ticketing_stop_id Identyfikator Wymagane

Rozszerzenie dotyczące sprzedaży biletów w transporcie publicznym Google.

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

To pole pokazuje wyjątkowe podróże. Działają one poza obowiązujący w regularnych odstępach czasu lub zostali skierowani na zwykłą trasę ze względu na specjalne wydarzenia lub planowane zakłócenia (np. trackwork itp.).

Google akceptuje te wartości:

  • 0. Standardowe usługi
  • 1. Wyjątek od usługi. Na przykład usługi dodawanych w związku ze specjalnymi wydarzeniami lub usługami nieobsługiwanymi trasą standardową ze względu na planowane utrudnienia.
trips.txt ticketing_trip_id Identyfikator Opcjonalnie

Rozszerzenie dotyczące sprzedaży biletów w transporcie publicznym Google.

Jeśli pole ticketing_trip_id jest obecne, jego wartość zastępuje pole trip_id w celu zidentyfikowania podróży za pomocą precyzyjnych linków.
trips.txt ticketing_type Typ wyliczeniowy Opcjonalnie

Rozszerzenie dotyczące sprzedaży biletów w transporcie publicznym Google.

ticketing_type określa rodzaj biletu związanego z daną podróżą.

Funkcja Transport publiczny Google akceptuje te wartości:

  • 0. Domyślne. Dostępne tylko wtedy, gdy agencja lub trasa ma 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 strony GTFS, ale Google Transport publiczny używa tej wartości, jeśli jest podana.

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

Rozszerzenie Transport publiczny Google.

Pole trans_id nie jest częścią oficjalnej strony GTFS, ale Transport publiczny Google używa tej wartości, jeśli występuje.

Aby określić token identyfikatora wyrażenia, które zostało dostarczone przez tłumaczenie użyj pola trans_id. Każdy wiersz w tabeli translations.txt oznacza, że w tabeli język lang, wyrażenie trans_id oznacza translation.
trips.txt original_trip_id Identyfikator Opcjonalnie

Rozszerzenie Transport publiczny Google.

Jeśli znajduje się w trips.txt, wartość original_trip_id zastępuje wartość trip_id do użytku przez inne systemy. An to dopasowywanie w czasie rzeczywistym.
trips.txt trip_direction_name Tekst Opcjonalnie

Rozszerzenie Transport publiczny Google.

Pole trip_direction_name określa kierować je do pasażerów. Wartość w tym polu jest przechowywana jako direction_name każdej podróży.

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

Wartości w polu trip_direction_name to wielkość liter znormalizowany.
trips.txt vehicle_category_id Identyfikator Opcjonalnie

Rozszerzenie Transport publiczny Google.

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