Übersicht
Wenn Sie nicht der Anbieter der GTFS-Feeds für Google Maps sind, ist Ihre Integration nur für Haltestellen. Für diese Integration müssen wir wissen, wie Sie die verschiedenen Bahn- oder Bushaltestellen identifizieren.
Allgemeine Feedspezifikationen
Beim Start der Integration wird für jede Integration eine eindeutige Kennung erstellt, z. B. ch_google_test (Ländercode, Partnername, Integration) oder eu_google (Regionscode, Partnername).
Partner stellen eine Datei mit Textdateien im CSV-Format bereit, die pro Integration angewendet werden. Jede CSV-Datei muss eine Kopfzeile mit Spaltennamen enthalten, die mit dem in der entsprechenden Feed-Spezifikationstabelle angegebenen „Feldname“ übereinstimmen.
Damit Partner neue Versionen der Dateien für Haltestellen und Märkte hochladen können, stellt unser Team während des Onboardings SFTP-Dropbox-Details für jeden Dateityp zur Verfügung.
Feedspezifikation für Stopp (erforderlich)
Die Stoppdatei sollte die folgenden Spalten enthalten:
| Feldname | Typ (siehe GTFS) | Beschreibung |
|---|---|---|
stop_id |
ID (erforderlich) | Die eindeutige Kennung für eine Haltestelle oder einen Bahnhof. Größere Sender sollten nur einen Eintrag enthalten. Dies wird bei Aufrufen Ihrer Partner Server API und in den Ticket-Deeplinks verwendet. |
stop_name |
Text (erforderlich) | Ein für Menschen lesbarer Name zum Debuggen von Daten zu Stoppzuordnung, Cache-Füllung und Preisgenauigkeit. |
stop_lat |
Breitengrad (erforderlich) | Breitengrad der Haltestelle. |
stop_lon |
Längengrad (erforderlich) | Längengrad der Haltestelle. |
Wir verwenden einen automatisierten Aufnahmeprozess, bei dem Partner kontinuierlich aktualisierte ZIP-Dateien bereitstellen können, wenn sich die darin enthaltenen Informationen ändern. Ein Partner kann das bereitgestellte Inventar beispielsweise erweitern, indem er die Liste der Haltestellen verlängert. Ähnlich wie bei GTFS sollten die stop_ids jedoch stabil sein.
Feedspezifikation für Marktsets (optional)
Anhand der zugeordneten Haltestellen wird die Marktgruppe für diese Integration generiert. Sie enthält eine Liste mit beliebten Start- und Zielorten. Dort haben Sie die Möglichkeit, diese Gruppe von Märkten zu reduzieren, indem Sie einen Feed mit Märkten angeben.
Das Marktset dient als Zulassungsliste für unseren Cache-Fill-Dienst. Wenn standardmäßig kein Marktset angegeben ist, sind alle Märkte aktiviert. Wenn Sie eine Gruppe von Märkten angeben, werden nur die in der Liste enthaltenen Märkte abgefragt. Wenn Nutzer Märkte außerhalb dieser Zulassungsliste abfragen, senden unsere Systeme weiterhin eine Live-Anfrage für den jeweiligen Markt und das angeforderte Datum, aber wir versuchen nicht, die Daten proaktiv zu cachen.
Die Datei mit den Marktsets sollte die folgenden Spalten enthalten:
| Feldname | Typ (siehe GTFS) | Beschreibung |
|---|---|---|
origin_stop_id |
ID (erforderlich) | Der Ursprung stop_id des Marktes. |
destination_stop_id |
ID (erforderlich) | Das Ziel stop_id des Marktes. |
Partnerkonfiguration
Bei der Integration mit „Nur Stopp“ sind zusätzliche Informationen für die statische Partnerkonfiguration erforderlich, wie im Abschnitt zur Partnerkonfiguration beschrieben.
Spezifikation von Empfehlungslinks
Das Format und die Parameter des Buchungslinks (auch Ticketing link genannt) sind in Ticketing-Links definiert.
Partner-API-Parameter
Die SegmentKeys-Parameter für die Partner API (GetBulkTripOptionsRequest) basieren auf der Deep-Link-Spezifikation. Wir verwenden SegmentKeys, einschließlich nur from_ticketing_stop_time_id, to_ticketing_stop_time_id, service_date, boarding_time und arrival_time, sodass ticketing_trip_id leer bleibt. Wir geben die Route vollständig an, einschließlich aller Umstiege, indem wir mehrere SegmentKeys angeben, einen pro Segment.