Google Transit / GTFS Realtime – Referenz und Unterschiede

Auf dieser Seite werden die Hauptunterschiede zwischen der offiziellen GTFS Realtime- 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.

Realtime Transit

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

Ignorierte offizielle Spezifikationen in Realtime-Feeds

Einige der ignorierten Spezifikationen befinden sich in der Testphase. Weitere Informationen finden Sie unter gtfs.org.

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

Tabelle 1 Ignorierte offizielle Felder in Realtime-Feeds
Meldung In GTFS definiertes, ignoriertes Feld Feldtyp
message Alert image TranslatedImage
message Alert image_alternative_text TranslatedString
message Alert severity_level Enum
message Alert tts_description_text Proto
message Alert tts_header_text Proto
message CarriageDetails id String
message CarriageDetails occupancy_percentage int32
message Position bearing Gleitkommazahl
message Position odometer Doppelwert
message Position speed Gleitkommazahl
message Shape encoded_polyline String
message Shape shape_id String
message StopTimeUpdate (in TripUpdate) arrival.uncertainty int32
message StopTimeUpdate (in TripUpdate) stop_time_properties Proto
message TripUpdate trip_properties Proto
message TripUpdate vehicle VehicleDescriptor
message VehicleDescriptor license_plate String
message VehicleDescriptor wheelchair_accessible WheelchairAccessible
message VehiclePosition congestion_level Enum
message VehiclePosition current_status VehicleStopStatus
message VehiclePosition current_stop_sequence uint32
message VehiclePosition multi_carriage_details.id String
message VehiclePosition occupancy_percentage uint32
message VehiclePosition stop_id String

Abweichende Interpretation in Realtime-Feeds

In Google Transit werden bestimmte GTFS-Felder akzeptiert, aber anders interpretiert.

In Tabelle 2 sind gemäß GTFS definierte Felder in Realtime-Feeds aufgeführt, die für Google Transit optional oder bedingt erforderlich sind. Für optionale Felder wird in der Tabelle angezeigt, ob die enum-Werte in Google Transit unterstützt werden.

Tabelle 2 Anders interpretierte Felder in Realtime-Feeds
Dateiname In GTFS definiertes Feld Feldtyp Für Google Transit erforderlich? Google Transit-Implementierungsdetails
message StopTimeUpdate (in TripUpdate) stop_id String Bedingt erforderlich

Wenn ein String vom Typ stop_id angegeben wird, muss er eine der folgenden Bedingungen erfüllen:

  • Der String stop_id muss mit dem in der Datei stops.txt im entsprechenden GTFS-Feed übereinstimmen.
  • Wenn ein anderer String vom Typ stop_id verwendet wird, muss der angegebene String vom Typ stop_id ein gleichgeordneter oder untergeordneter String des ursprünglichen Strings vom Typ stop_id sein, der im GTFS Static-Feed aufgeführt ist. Das entsprechende Feld vom Typ stop_sequence muss ebenfalls angegeben werden.
message StopTimeUpdate schedule_relationship Enum Optional

In Google Transit werden die folgenden enum-Werte unterstützt:

  • SCHEDULED
  • SKIPPED
  • NO_DATA
message TripDescriptor schedule_relationship Enum Optional

Die folgenden enum-Werte werden in Google Transit nicht unterstützt:

  • DUPLICATED
  • CANCELED – wenn nicht für Datensätze vom Typ TripUpdate bestimmt

In Google Transit werden die folgenden enum-Werte unterstützt:

  • SCHEDULED
  • UNSCHEDULED
  • ADDED
  • CANCELED – nur für Datensätze vom Typ TripUpdate

Experimentelle Unterstützung in Realtime-Feeds

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

Von Google Transit unterstützte Erweiterungen in Realtime-Feeds

Bei der Veröffentlichung dieses Artikels waren keine Felder in dieser Kategorie enthalten. Falls Sie Hilfe benötigen, wenden Sie sich an das Google Transit-Team.