Unterschiede zwischen der GTFS Schedule- und der Google Transit-Implementierung

Auf dieser Seite werden die Hauptunterschiede zwischen der offiziellen GTFS Schedule- und der Google Transit-Implementierung der Spezifikation in den folgenden Bereichen beschrieben:

  • Ignorierte offizielle Spezifikationen: Diese Felder sind Teil der offiziellen GTFS-Version. In Google Transit werden diese Daten fehlerfrei aufgenommen, aber nicht proaktiv verwendet.

  • Abweichende Interpretation: Diese Felder enthalten die Teile der offiziellen GTFS-Version, die in Google Transit anders als in der ursprünglichen Definition interpretiert werden.

  • Experimentelle Unterstützung: Diese Felder befinden sich in der Google Transit-Implementierung in der Testphase. Wenn Sie ein neues experimentelles Feld einbinden möchten, wenden Sie sich an das Google Transit-Team.

  • Von Google Transit unterstützte Erweiterung: Dieser Teil ist nicht in der offiziellen GTFS-Version enthalten. Die von Google Transit unterstützte Erweiterung umfasst sowohl öffentliche als auch spezifische Google Transit-Erweiterungen. Jeder Partner kann diese Informationen in seinem Feed an Transit senden.

Static Transit

In den folgenden Abschnitten werden die Hauptunterschiede zwischen der offiziellen GTFS-Version des Static-Feeds und der Google Transit-Implementierung beschrieben.

Ignorierte offizielle Spezifikationen in Static-Feeds

Einige der offiziellen Spezifikationen, die in Google Transit ignoriert werden, befinden sich in der Testphase. Weitere Informationen finden Sie unter gtfs.org.

In Tabelle 1 sind GTFS-Dateien aufgeführt, die in Static-Feeds nicht von Google Transit unterstützt werden. Auch die in diesen Dateien definierten Felder sind nicht zulässig.

Tabelle 1 Nicht unterstützte GTFS-Dateien in Static-Feeds
areas.txt
fare_leg_rules.txt
fare_products.txt
fare_transfer_rules.txt
levels.txt
stop_areas.txt

In Tabelle 2 sind alle gemäß GTFS definierten Felder aufgeführt, die von Google Transit in den Static-Feeds ignoriert werden.

Tabelle 2 Ignorierte GTFS-Felder in Static-Feeds
Dateiname In GTFS definiertes, ignoriertes Feld Feldtyp
fare_attributes.txt payment_method Enum
feed_info.txt default_lang Sprachcode
feed_info.txt feed_publisher_name Text
pathways.txt max_slope Gleitkommazahl
routes.txt continuous_drop_off Enum
routes.txt continuous_pickup Enum
routes.txt network_id ID
routes.txt route_desc Text
routes.txt route_sort_order Nicht negative Ganzzahl
stops.txt level_id ID
stops.txt stop_desc Text
stops.txt stop_url URL
stops.txt tts_stop_name Text
stops.txt bikes_allowed Enum

Abweichende Interpretation in Static-Feeds

Bestimmte gemäß GTFS definierte Felder werden in Google Transit akzeptiert, aber anders interpretiert.

In Tabelle 3 sind die Felder in Static-Feeds aufgeführt, die von Google Transit anders implementiert werden als in GTFS beschrieben.

Table 3 Anders implementierte Felder im Static-Feed
Dateiname In GTFS definiertes Feld Feldtyp Für Google Transit erforderlich? Google Transit-Implementierungsdetails
fare_attributes.txt transfers Enum Erforderlich

Google Transit-Erweiterung.

In der öffentlichen GTFS-Version sind nur Werte von 0 bis 2 zulässig. Google Transit unterstützt Werte von 0 bis 5.

Verwenden Sie dieses Feld, um die maximale Anzahl von Umstiegen festzulegen, die bei dem Fahrpreis zulässig sind. Nicht enthalten sind Umstiege innerhalb eines Blocks (sogenannte Blockfahrten). Wenn Sie keine Beschränkungen bei der Anzahl der Umstiege für einen bestimmten Preis festlegen möchten, lassen Sie das Feld transfers leer.

pathways.txt pathway_mode Enum Optional Wenn das Feld pathway_mode angegeben wurde, aber leer ist, wird es von Google Transit akzeptiert und als „Unbekannt“ behandelt.
stop_times.txt arrival_time Zeit Bedingt erforderlich Stunden sind auf Werte von 00 bis 99 beschränkt, was für dreitägige Reisen mehr als ausreichend ist.
transfers.txt transfer_type Enum Erforderlich

Die Werte 4 und 5 werden nicht unterstützt und deshalb ignoriert.

In Google Transit werden die Werte 0, 1, 2 und 3 unterstützt.

trips.txt block_id ID Optional Weitere Informationen finden Sie unter Beispiel für eine Blockfahrt.

Experimentelle Unterstützung in Static-Feeds

Wenn Sie Unterstützung beim Einbinden neuer experimenteller Felder in dieser Kategorie benötigen, wenden Sie sich an das Google Transit-Team.

Von Google Transit unterstützte Erweiterungen in Static-Feeds

In Tabelle 4 finden Sie Informationen zu Google Transit-Erweiterungen. Diese Felder sind in der offiziellen GTFS-Version nicht enthalten.

Tabelle 4 Unterstützte Erweiterungen des Static-Feeds
Dateiname Feld Feldtyp Für Google Transit erforderlich? Google Transit-Implementierungsdetails
fare_attributes.txt ic_price Gleitkommazahl Optional

Diese Google Transit-Erweiterung ist nur für Partner in Japan verfügbar.

Das Feld ic_price steht für den ermäßigten Betrag, der für die Fahrt mit einer Smartcard zu bezahlen ist. Wenn für diesen Preis keine Ermäßigungen angegeben werden oder die Smartcard nicht unterstützt wird, muss das Feld ic_price den Wert -1 enthalten.

fare_rules.txt contains_route_id ID Optional

Google Transit-Erweiterung.

Dieser Preis gilt nur für Fahrten auf ganz bestimmten Routen. Diese werden durch den Wert route_id bestimmt, und zwar in allen Zeilen für die Kombination der Spalten fare_id, origin_id und destination_id.

Wenn die Spalte contains_route_id fehlt oder bei allen Werten für diesen Preis null angegeben ist, ist der Preis in diesem Parameter nicht beschränkt. Falls das Feld contains_route_id für einen Preis angegeben ist, muss das Feld route_id leer sein.

routes.txt checkin_duration Ganzzahl Optional

Google Transit-Erweiterung.

Im Feld checkin_duration ist angegeben, wie viele Sekunden eine Person vor der geplanten Abfahrt ankommen sollte, um Zeit für das Vorzeigen des Tickets und das Einsteigen zu haben.

Wenn der Fahrgast umsteigen muss, um den Zielort zu erreichen, wird der Wert checkin_duration mit der definierten Umsteigezeit überschrieben.

Der Wert checkin_duration ist nur eine Empfehlung, die normalerweise vom Betreiber kommt. Er entspricht möglicherweise nicht dem absolut letzten Zeitpunkt, in dem ein Fahrgast noch ankommen und einsteigen kann.

routes.txt route_type Enum Erforderlich

Google Transit-Erweiterung.

Informationen dazu, wie in Google Transit die GTFS-konformen Optionen für den Wert route_type erweitert werden, finden Sie unter Erweiterte GTFS-Routentypen.

stop_times.txt stop_direction_name Text Optional

Google Transit-Erweiterung.

Im Feld stop_direction_name wird die Fahrtrichtung für die Fahrgäste angegeben. Die Richtung wird als direction_name-Wert der Abfahrt von dieser Haltestelle gespeichert.

Wenn das Feld stop_direction_name leer ist, wird stattdessen das Google Transit-Feld trip_direction_name verwendet. Sind die Felder trip_direction_name und stop_direction_name leer, werden sie auch vom Google Transit-Importprogramm leer gelassen. In diesem Fall können Partner stattdessen den Wert stop_headsign oder trip_headsign verwenden. Bei den Werten des Felds stop_direction_name wird die Groß-/Kleinschreibung normalisiert.

stops.txt signposted_as Text Optional

Google Transit-Erweiterung.

Im Feld signposted_as steht der Text genau so, wie er auf der Anzeige am Bus-/Bahnsteig zu sehen ist. Beispiele: „Richtung Hauptbahnhof“, „Garching-Hochbrück“.

Das GTFS-Feld platform_code und das von Google Transit unterstützte Feld signposted_as können gleichzeitig festgelegt werden.

Die Felder platform_code und signposted_as unterscheiden sich unter anderem in folgenden Punkten:

  • Länge: Das Feld platform_code enthält normalerweise eine Zahl oder einen Buchstaben wie 2 oder C.
  • Sprache: Für das Feld platform_code ist keine Sprache definiert, aber signposted_as-Werte können übersetzt werden.
  • Beständigkeit: Das Feld platform_code ändert sich viel seltener als das Feld signposted_as.
stops.txt vehicle_type Ganzzahl Optional

Google Transit-Erweiterung.

Mit dem Feld vehicle_type wird der Fahrzeugtyp angegeben, der an einer Haltestelle verwendet wird. Es werden HVT-Codes (Hierarchical Vehicle Type, hierarchischer Fahrzeugtyp) akzeptiert. Die HVT-Werte werden vom europäischen TPEG-Standard (Transport Protocol Experts Group) abgeleitet.

agency.txt ticketing_deep_link_id ID Optional

Google Transit-Fahrkartenerweiterung.

In der Datei agency.txt steht das Feld ticketing_deep_link_id für den Deeplink, über den die Fahrten dieses Betreibers gebucht werden.

routes.txt ticketing_deep_link_id ID Optional

Google Transit-Fahrkartenerweiterung.

In der Datei routes.txt steht das Feld ticketing_deep_link_id für den Deeplink, über den die Fahrten für diese Route gebucht werden.

stop_times.txt ticketing_stop_time_id ID Optional

Google Transit-Fahrkartenerweiterung.

Ist das Feld ticketing_stop_time_id in der Datei stop_times.txt vorhanden, wird damit die Kennung überschrieben, die der Haltestellenzeit für die Fahrkartenausgabe über Deeplinks entspricht.

stop_times.txt ticketing_type Enum Optional

Google Transit-Fahrkartenerweiterung.

Mit dem Feld ticketing_type wird die für diese Haltestellenzeit geltende Art der Fahrkartenausgabe angegeben.

In Google Transit werden die folgenden Werte akzeptiert:

  • Empty: Standardeinstellung gemäß Definition für die Fahrt.
  • 0: Nur verfügbar, wenn es für den Betreiber oder die Route einen aktivierten Deeplink für die Fahrkartenausgabe gibt.
  • 1: Nicht verfügbar.
ticketing_deep_links.txt android_intent_uri URI Optional

Google Transit-Fahrkartenerweiterung.

Das Feld android_intent_uri steht für den Intent-URI, der für Deeplinks unter Android verwendet wird.

ticketing_deep_links.txt ios_universal_link_url URL Optional

Google Transit-Fahrkartenerweiterung.

Das Feld ios_universal_link_url steht für die universelle Link-URL, die für Deeplinks unter iOS verwendet wird.

ticketing_deep_links.txt ticketing_deep_link_id ID Erforderlich

Google Transit-Fahrkartenerweiterung.

Das Feld ticketing_deep_link_id steht für die Kennung des Deeplinks.

ticketing_deep_links.txt web_url URL Optional

Google Transit-Fahrkartenerweiterung.

Das Feld web_url steht für die URL, die für Deeplinks im Web verwendet wird.

ticketing_identifiers.txt agency_id ID Erforderlich

Google Transit-Fahrkartenerweiterung.

Zum Angeben des Betreibers der Haltestelle, für die das Standardfeld ticketing_stop_id definiert wurde, enthält das Feld agency_id die ID aus der GTFS-Datei agency.txt.

ticketing_identifiers.txt stop_id ID Erforderlich

Google Transit-Fahrkartenerweiterung.

Zum Angeben der Haltestelle, für die das Standardfeld ticketing_stop_id definiert wurde, enthält das Feld stop_id die ID aus der GTFS-Datei stops.txt.

ticketing_identifiers.txt ticketing_stop_id ID Erforderlich

Google Transit-Fahrkartenerweiterung.

Das Feld ticketing_stop_id enthält die ID für die Fahrkartenausgabe, die auf die Haltestelle angewendet wird. Optional wird die ID von einem Betreiber bestimmt.

trips.txt ticketing_trip_id ID Optional

Google Transit-Fahrkartenerweiterung.

Wenn das Feld ticketing_trip_id vorhanden ist, überschreibt sein Wert das Feld trip_id, um für die Fahrt die Fahrkartenausgabe über Deeplinks festzulegen.

trips.txt ticketing_type Enum Optional

Google Transit-Fahrkartenerweiterung.

Im Feld ticketing_type wird die Art der Fahrkartenausgabe für diese Fahrt angegeben.

In Google Transit werden die folgenden Werte akzeptiert:

  • 0: Standardeinstellung. Nur verfügbar, wenn es für den Betreiber oder die Route einen aktivierten Deeplink für die Fahrkartenausgabe gibt.
  • 1: Nicht verfügbar.
translations.txt lang Sprachcode Optional

Google Transit-Erweiterung.

Das Feld lang ist in der offiziellen GTFS-Version nicht enthalten. Ist der Wert jedoch vorhanden, wird er in Google Transit verwendet.

Wenn Sie die Übersetzung für eine Wortgruppe angeben möchten, verwenden Sie das Feld lang. Es darf nicht leer sein oder den Wert und (eine nicht definierte Sprache) enthalten.

translations.txt trans_id ID Optional

Google Transit-Erweiterung.

Das Feld trans_id ist in der offiziellen GTFS-Version nicht enthalten. Ist der Wert jedoch vorhanden, wird er in Google Transit verwendet.

Verwenden Sie das Feld trans_id, um das ID-Token der Wortgruppe anzugeben, für die die Übersetzung zur Verfügung gestellt wird. Jede Zeile der Tabelle translations.txt bedeutet, dass der Ausdruck trans_id in der Sprache lang mit translation übersetzt wird.

trips.txt original_trip_id ID Optional

Google Transit-Erweiterung.

Wenn der Wert in der Datei trips.txt vorhanden ist, überschreibt er original_trip_id den Wert trip_id zur Verwendung für andere Systeme. Ein Beispiel hierfür ist der Realtime-Abgleich.

trips.txt trip_direction_name Text Optional

Google Transit-Erweiterung.

Im Feld trip_direction_name wird die Fahrtrichtung für die Fahrgäste angegeben. Der Wert in diesem Feld wird als direction_name jeder Fahrt gespeichert.

Wenn sich der Wert stop_direction_name in der Tabelle stop_times im Lauf der Fahrt ändert, wird möglicherweise der Wert trip_direction_name überschrieben.

Bei den Werten des Felds trip_direction_name wird die Groß-/Kleinschreibung normalisiert.

trips.txt vehicle_category_id ID Optional

Google Transit-Erweiterung.

In der Datei trips.txt wird im Feld vehicle_category_id das Fahrzeug angegeben, das für diese Fahrt vorgesehen ist. Ist das Feld in der Datei trips.txt vorhanden, wird damit der Wert vehicle_category_id in der Datei routes.txt überschrieben.