Auf dieser Seite wird die Teilmenge der GTFS-Ticketspezifikation definiert, die sich beim Erstellen dieses Dokuments in der Entwurfsphase befindet. Auf dieser Seite findest du außerdem einige zusätzliche Einschränkungen von Google.
Voraussetzungen
Das Feld departure_time
in stop_times.txt
ist ein Pflichtfeld.
Zusätzliche Feldtypen
In diesem Abschnitt werden die zusätzlichen Feldtypen sowie die mit Erweiterungen von Google beschrieben.
- URI: Ein voll qualifizierter URI (Uniform Resource Identifier), der das Schema enthält. Für alle Sonderzeichen im URI müssen die korrekten Escapezeichen verwendet werden. Eine Beschreibung zum Erstellen voll qualifizierter URI-Werte findest du unter RFC 3986 Uniform Resource Identifier (URI): Generic Syntax.
Dateierweiterungen oder -hinzufügungen
Dateiname | Status | Definition |
---|---|---|
agency.txt |
Erweiterung | Fügt agency.ticketing_deep_link_id hinzu |
routes.txt |
Erweiterung | Fügt routes.ticketing_deep_link_id hinzu |
trips.txt |
Erweiterung | Fügt trips.trip_ticketing_id , trips.ticketing_type hinzu |
stop_times.txt |
Erweiterung | Fügt stop_times.ticketing_type hinzu |
ticketing_identifiers.txt |
Hinzufügung | |
ticketing_deep_links.txt |
Hinzufügung |
Tabellendefinitionen
agency.txt
(Datei erweitert)
Feldname | Präsenz | Details |
---|---|---|
ticketing_deep_link_id |
Optional | (ID aus ticketing_deep_links.txt ) Definiert den Deeplink, der für diesen Betreiber verwendet werden soll. Kann in routes.txt überschrieben werden. |
routes.txt
(Datei erweitert)
Feldname | Präsenz | Details |
---|---|---|
ticketing_deep_link_id |
Optional | (ID aus ticketing_deep_links.txt ) Definiert den Deeplink, der für diese Route verwendet werden soll. Falls vorhanden, wird der Wert in agency.txt überschrieben. |
trips.txt
(Datei erweitert)
Feldname | Präsenz | Details |
---|---|---|
ticketing_trip_id |
Optional |
(ID) Kennung, die im Deeplink übergeben werden soll. Muss nicht eindeutig sein. Ein Fallback auf |
ticketing_type |
Optional |
(Enum) Lege fest, ob Tickets über Deeplinks für diese Fahrt verfügbar sind:
|
stop_times.txt
(Datei erweitert)
Feldname | Präsenz | Details |
---|---|---|
ticketing_type |
Optional |
(Enum) Gib an, ob Tickets über Deeplinks für diese Fahrt verfügbar sind. Falls definiert, überschreibe den in
|
ticketing_identifiers.txt
(Datei hinzugefügt)
In einem Ticketsystem ist es meistens so, dass jede Haltestelle eine Kennung für die Verarbeitung der Abrechnung hat. Unterschiedliche Betreiber verwenden unter Umständen dieselbe Kennung für eine bestimmte Haltestelle. Wenn mehrere Betreiber dieselbe Haltestelle bedienen, wiederhole diese Zuordnung für jeden Betreiber.
Feldname | Präsenz | Details |
---|---|---|
ticketing_stop_id |
Erforderlich | (ID) Lege eine standardmäßige Ticket-ID für diese Haltestelle dieses Betreibers fest. |
stop_id |
Erforderlich | (ID aus stops.txt ) Die Haltestelle, für die der Standardwert vonticketing_stop_id definiert wird. |
agency_id |
Erforderlich | (ID aus agency.txt ) Der Betreiber der Haltestelle, für den der Standardwert von ticketing_stop_id definiert wird. |
ticketing_deep_links.txt
(Datei hinzugefügt)
Feldname | Präsenz | Details |
---|---|---|
ticketing_deep_link_id |
Erforderlich | (ID) Gib eine ID für den Deeplink an. |
web_url |
Optional |
(URL) Die URL, die für Deeplinks aufgerufen werden soll. Übersetzungen können über |
android_intent_uri |
Optional |
(URI) Der URI, der an eine native Android-App mit dem Intent „android.intent.action.VIEW“ übergeben werden soll. Ein leerer URI bedeutet, dass keine Deeplinks zu einer nativen Android-App vorhanden sind. Weitere Informationen zu Deeplinks unter Android findest du unter Create Deep Links to App Content. Dieses Feld kann nicht über |
ios_universal_link_url |
Optional |
(URL) Die universelle Link-URL, die unter iOS aufgerufen wird. Wenn das Feld leer ist, wird der Deeplink unter iOS nicht angezeigt. Weitere Informationen zu universellen Links unter iOS Dieses Feld kann nicht über |
Feldplatzhalter im API-Aufruf
Google ruft die vorherigen URLs mit den folgenden Parametern auf:
Feldname | Präsenz | Details |
---|---|---|
service_date |
Erforderlich |
(Datum, wiederholbar) Betriebstag der Fahrt. Dieses Feld wird als JSON-Array formatiert. |
ticketing_trip_id |
Erforderlich |
(ID aus Dieses Feld wird als JSON-Array formatiert. |
from_ticketing_stop_time_id |
Erforderlich |
(Wiederholbar) Kennung von Für eine bestimmte Haltestellenzeit ist der Wert:
Dieses Feld wird als JSON-Array formatiert. |
|
Erforderlich |
(Wiederholbar) Kennung von Eine Erläuterung zur Ableitung des Werts findest du unter Dieses Feld wird als JSON-Array formatiert. |
boarding_time |
Erforderlich |
(ISO 8601, wiederholbar) Die Abfahrtszeit ( Der Zeitwert dieses Felds entspricht ISO 8601 mit folgendem Formatstring:
Alle unten angegebenen Zeiten sind in verschiedenen Zeitzonen gleich:
Dieses Feld wird als JSON-Array formatiert. |
Beispiele
Wenn das die Streckenabschnitte sind:
- Am Betriebstag 20190716 Fahrtticket-ID ti1 von Haltestellenzeit-Ticket-ID 11 bis Haltestellenzeit-Ticket-ID 12, Einstieg um 14:00 Uhr UTC
- Am Betriebstag 20190716 Fahrtticket-ID ti2 von Haltestellenzeit-Ticket-ID 21 bis Haltestellenzeit-Ticket-ID 22, Einstieg um 15:00 Uhr UTC
Und web_url
ist: http://meinebuchungswebsite.de
Die Werte der Parameter sind:
Feldname | Details |
---|---|
service_date |
["20190716" , "20190716"] |
ticketing_trip_id |
["ti1" , "ti2"] |
from_ticketing_stop_time_id |
["11" , "21"] |
to_ticketing_stop_time_id |
["12" , "22"] |
boarding_time |
["2019-07-16T14:00:00+00:00" , "2019-07-16T15:00:00+00:00"] |
Der endgültige URI (nach der Codierung) ist:
http://myawesomebookingwebsite.com?service_date=%5B%2220190716%22,%22%2019071622%5D
&ticketing_trip_id=%5B%22ti1%22,%22ti2%22%5D&from_ticketing_stop_time_id=%5B%2211%22,%2221%22%5D
&to_ticketing_stop_time_id=%5B%2212%22,%2222%22%5D&boarding_time=%5B%222019-07-16T14:00:00%2B00:00
%22,%222019-07-16T15:00:00%2B00:00%22%5D
Beispiele für verschiedene ticketing_stop_id
-Werte
Haltestellen können unterschiedliche IDs haben, um über das Feld ticketing_identifiers.txt
Tickets zu erstellen. Die fett formatierten Werte sind die im Webaufruf nach den Dateien beschriebenen Werte.
stop.txt |
---|
|
routes.txt |
---|
|
trips.txt |
---|
ti1,everyday,ri1,"TGV INOUI 6603",FR_SNCF_6603 ti2,everyday,ri1,"TGV INOUI 6681",FR_SNCF_6681 ti3,everyday,ri1,"TGV INOUI 6607",FR_SNCF_6607 |
stop_times.txt |
---|
ti1,1,si1,06:59:00,06:59:00 ti1,2,si2,08:56:00,08:56:00 ti2,1,si1,07:53:00,07:53:00 ti2,2,si2,10:00:00,10:00:00 ti3,1,si1,08:59:00,08:59:00 ti3,2,si2,10:56:00,10:56:00 |
ticketing_identifiers.txt |
---|
si1,agency1,4924 si2,agency1,4676 |
ticketing_deep_links.txt |
---|
ticketing_deep_link_id , web_url , android_intent_url ,
ios_universal_url tdl1, https://www.thetrainline.com/api/gtfs/web,
https://www.thetrainline.com/api/gtfs/android, https://www.thetrainline.com/api/gtfs/ios |
Der Aufruf für das Web lautet so, wenn die Anfrage am 19. Juli 2019 initiiert wurde und die GTFS-Zeiten in der Zeitzone UTC+1 angegeben sind:
http://www.thetrainline.com/api/gtfs/web?service_date=%5B%2220190719%22%5D&ticketing_trip_id=
%5B%22FR_SNCF_6603%22%5D&from_ticketing_stop_time_id=%5B%224924%22%5D&to_ticketing_stop_time_id=
%5B%224676%22%5D&boarding_time=%5B%222019-07-19T07:59:00%2B00:00%22%5D