Transport publiczny – odniesienie do GTFS w czasie rzeczywistym i różnice

Na tej stronie opisujemy główne różnice między oficjalną implementacją specyfikacji GTFS w czasie rzeczywistym a wdrażaniem 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.

Transport publiczny w czasie rzeczywistym

W kolejnych sekcjach opisujemy główne różnice między oficjalną wersją GTFS a implementacją pliku danych Transportu publicznego Google w czasie rzeczywistym.

Ignorowane oficjalne specyfikacje w kanałach w czasie rzeczywistym

Niektóre ignorowane specyfikacje mają charakter eksperymentalny. Więcej informacji znajdziesz na gtfs.org.

Tabela 1 zawiera pola zdefiniowane przez GTFS, które są ignorowane przez Transport publiczny w plikach danych w czasie rzeczywistym.

Tabela 1. Ignorowane pola oficjalne w kanałach czasu rzeczywistego
przekaz, Ignorowane pole zdefiniowane w GTFS Typ pola
wiadomość Alert image TranslatedImage
wiadomość Alert image_alternative_text TranslatedString
wiadomość Alert severity_level Enum
wiadomość Alert tts_description_text Proto
wiadomość Alert tts_header_text Proto
wiadomość CarriageDetails id Ciąg znaków
wiadomość CarriageDetails occupancy_percentage int32
wiadomość Position bearing Liczba zmiennoprzecinkowa
wiadomość Position odometer Double
wiadomość Position speed Liczba zmiennoprzecinkowa
wiadomość Shape encoded_polyline Ciąg znaków
wiadomość Shape shape_id Ciąg znaków
wiadomość StopTimeUpdate (w TripUpdate) arrival.uncertainty int32
wiadomość StopTimeUpdate (w TripUpdate) stop_time_properties Proto
wiadomość TripUpdate trip_properties Proto
wiadomość TripUpdate vehicle VehicleDescriptor
wiadomość VehicleDescriptor license_plate Ciąg znaków
wiadomość VehicleDescriptor wheelchair_accessible WheelchairAccessible
wiadomość VehiclePosition congestion_level Enum
wiadomość VehiclePosition current_status VehicleStopStatus
wiadomość VehiclePosition current_stop_sequence uint32
wiadomość VehiclePosition multi_carriage_details.id Ciąg znaków
wiadomość VehiclePosition occupancy_percentage uint32
wiadomość VehiclePosition stop_id Ciąg znaków

Różne interpretacje źródeł w czasie rzeczywistym

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

Tabela 2 zawiera listę pól zdefiniowanych przez GTFS w plikach danych w czasie rzeczywistym, które są opcjonalne lub wymagane warunkowo w przypadku transportu publicznego. W przypadku pól opcjonalnych tabela pokazuje, czy wartości wyliczeniowe są obsługiwane przez Transport publiczny.

Tabela 2. Różnie interpretowane pola kanału w czasie rzeczywistym
Nazwa pliku Pole zdefiniowane w GTFS Typ pola Wymagana przez Transport publiczny Google? Szczegóły implementacji Transportu publicznego Google
wiadomość StopTimeUpdate (w TripUpdate) stop_id Ciąg znaków Wymagane warunkowo

Podany ciąg znaków stop_id musi spełniać jeden z tych warunków:

  • Ciąg stop_id musi być taki sam jak w pliku stops.txt w odpowiednim pliku danych GTFS.
  • Jeśli używany jest inny ciąg stop_id, podany ciąg stop_id musi być ciągiem równorzędnym lub podrzędnym oryginalnego ciągu stop_id zawartego w statycznej GTFS. Musisz też podać odpowiednie pole stop_sequence.
wiadomość StopTimeUpdate schedule_relationship Enum Opcjonalnie

Transport publiczny Google obsługuje następujące wartości wyliczeniowe:

  • SCHEDULED
  • SKIPPED
  • NO_DATA
wiadomość TripDescriptor schedule_relationship Enum Opcjonalnie

Transport publiczny Google nie obsługuje tych wartości wyliczeniowych:

  • DUPLICATED
  • CANCELED – gdy nie jest przeznaczony dla rekordów TripUpdate

Google obsługuje te wartości wyliczeniowe:

  • SCHEDULED
  • UNSCHEDULED
  • ADDED
  • CANCELED – obsługiwana tylko w przypadku rekordów TripUpdate.

Eksperymentalna obsługa plików danych w czasie rzeczywistym

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

Rozszerzenia obsługiwane przez Transport publiczny Google w plikach danych w czasie rzeczywistym

W chwili publikacji tego artykułu do tej kategorii nie należą żadne pola. Jeśli potrzebujesz pomocy, skontaktuj się z Transportem publicznym Google.