In diesem Leitfaden wird beschrieben, wie Sie Google integrieren, um Nutzern auf verschiedenen Google-Oberflächen, darunter Google Maps und die Google Suche, eine nahtlose Suche nach Transportmöglichkeiten zu ermöglichen. Auf übergeordneter Ebene umfassen die Hauptintegrationsspezifikationen Folgendes:
- Es gibt zwei Möglichkeiten, statische Daten bereitzustellen:
- GTFS-basierte Integration: Sie stellen einen GTFS-Feed mit Fahrkartenerweiterungen bereit, wenn Sie der Anbieter der Fahrplandaten sind. Für die GTFS-basierte Integration gelten einige zusätzliche Anforderungen.
- Integration nur mit Haltestellen: Hier wird nur eine Liste von Haltestellen angegeben, wenn Google die Fahrplandaten bereits aus einer anderen Quelle hat.
- Eine Partner-API-Spezifikation für die Bereitstellung dynamischer Daten:
- Partnerkonfiguration: Angabe von Partnerinformationen wie Branding und Kontaktdaten.
- Partnerserver: Implementierung von Servern, die die Partner Server APIs unterstützen.
Schritte zur Integration in Travel Transport
Im Folgenden finden Sie eine Übersicht über die Schritte, die zum Erstellen und Testen eines End-to-End-Systems zur Unterstützung der Transportfunktionen von Google erforderlich sind. Die Integration umfasst drei Hauptschritte:
- Teilnahmevoraussetzungen prüfen
- Google einen Feed mit statischen Daten zur Verfügung stellen.
- Unterstützung der Travel Transport API, um dynamische Abfragen von sich schnell ändernden Daten wie Preisen und Verfügbarkeit zu ermöglichen. Die API verwendet Kennzeichnungen aus dem statischen Datenfeed aus Schritt 1, z. B. die
ticketing_stop_id, um Haltestellen zu identifizieren.
1. Teilnahmevoraussetzungen
In der Einheit für Mobilitätsoptionen von Google werden Reisepläne und Buchungsoptionen mit Preisen angezeigt. Damit Ihr Angebot in der Liste angezeigt wird, sind ein Link von guter Qualität und ein passender Endpreis erforderlich. Weitere Informationen finden Sie in unseren Teilnahmebedingungen.
2. Feed mit statischen Daten bereitstellen
Es gibt zwei Optionen für die Bereitstellung statischer Daten, die jeweils unter bestimmten Umständen anwendbar sind. Das Hauptkriterium für die Entscheidung, welche Option verwendet werden soll, ist, ob Sie der Anbieter der Fahrplandaten für die Transitverbindungen sind, für die Sie Buchungsfunktionen anbieten möchten. Am einfachsten lässt sich prüfen, ob Google bereits Fahrplandaten hat, indem Sie in Google Maps nach Verbindungen für einen bestimmten Betreiber suchen.
| Funktion | GTFS-basierte Integration | Nur Haltestellenintegration |
|---|---|---|
| Anwendungsbeispiel | Sie stellen bereits GTFS-Daten mit Fahrplan- und Ticketinformationen zur Verfügung. | Google hat die Fahrplandaten für den Betreiber bereits aus einer anderen Quelle. |
| Erforderliche Daten | Die GTFS-IDs. | Eine Liste Ihrer Haltestellen-IDs mit den zugehörigen geografischen Koordinaten. |
| Aufwand | Niedrig | Mittel |
Option 1 gilt, wenn Sie der Anbieter des GTFS-Feeds für einen Betreiber sind. In diesem Fall müssen Sie auch einen GTFS-Feed eingerichtet haben, um Google zuerst die Fahrplaninformationen zur Verfügung zu stellen. Folgen Sie dann der Anleitung im Abschnitt zur GTFS-basierten Integration.
Option 2 gilt, wenn Google bereits Fahrplandaten für den Betreiber aus einer anderen Quelle erhält. In diesem Fall benötigen wir nicht die vollständigen Fahrplaninformationen, aber weiterhin eine Liste Ihrer Haltestellen-IDs, die wir in der Travel Transport API verwenden können (siehe unten). Folgen Sie der Anleitung im Abschnitt zur reinen Haltestellenintegration, um die Liste der Haltestellen anzugeben.
3. Unterstützung der Travel Transport API
Damit Sie als Buchungspartner mit Preisen in der Transporteinheit aufgeführt werden, muss Google die aktuellen Preis- und Verfügbarkeitsinformationen von Partnern abrufen können. Dazu müssen Partner einen Dienst bereitstellen, der die Partner Server APIs implementiert.
3.1. Partner Server API implementieren
Details zur Implementierung der Partner Server API finden Sie in der API-Referenz und im Leitfaden für Partner Server. Über die API kann Google die aktuellsten Preis- und Verfügbarkeitsinformationen von Partnern abrufen. Sie wird von Google aufgerufen, um:
- Einen Cache erstellen, um Preise schnell zurückzugeben.
- Aktuelle Preise abrufen, wenn ein Nutzer auf einen bestimmten Reiseplan klickt.
Die Implementierung der Partner Server API ist erforderlich, wenn der Partner möchte, dass Preise von Google angezeigt werden.
3.2 API-Validierung und ‑Tests
Sobald die API-Implementierung fast abgeschlossen ist und der Dienst, der sie implementiert, ausgeführt wird, wenden Sie sich mit den Serverinformationen an transport-help@google.com, damit wir mit der Validierung Ihrer Implementierung beginnen können.
Wir planen, in Zukunft automatisierte Tools zur Validierung Ihrer API-Implementierung anzubieten. Diese sind jedoch noch nicht verfügbar.