Diese Methode bietet allgemeine Ticketgruppen für eine bestimmte Fahrt. Diese enthalten Gruppen von Segmenten mit ausgewählten Serviceklassen, die mit demselben Ticket gebucht werden können, sowie Tarif- und Verfügbarkeitsinformationen für das Ticket als Ganzes. Hinweis:
- Alle ticketing_.*_id (Teil von SegmentKey) verweisen auf die in der Google Transit-Fahrkartenerweiterung angegebenen IDs.
- Die Kennzeichnungen müssen stabil sein und alle Änderungen daran müssen abwärtskompatibel sein, wie in den Anforderungen für die GTFS-Integration beschrieben.
GetTripOptionsRequest
Proto-Definition
// Request sent to partners. message GetTripOptionsRequest { // All segments together should form a single trip for which a ticket can be // booked. repeated ext.travel.transport.partner.SegmentKey segment_keys = 1; }
JSON-Beispiel
{ "segment_keys": [ { "ticketing_trip_id": "123456", "from_ticketing_stop_time_id": "ZRH-1234", "to_ticketing_stop_time_id": "LUZ-1235", "service_date": { "year": 2022, "month": 4, "day": 6 }, "boarding_time": { "year": 2022, "month": 4, "day": 6, "hours": 14, "minutes": 25, "seconds": 0, "nanos": 0, "utc_offset": "0s" }, "arrival_time": { "year": 2022, "month": 4, "day": 6, "hours": 16, "minutes": 25, "seconds": 0, "nanos": 0, "utc_offset": "0s" } }, { "ticketing_trip_id": "234567", "from_ticketing_stop_time_id": "LUZ-2759", "to_ticketing_stop_time_id": "WOL-2455", "service_date": { "year": 2022, "month": 4, "day": 6 }, "boarding_time": { "year": 2022, "month": 4, "day": 6, "hours": 18, "minutes": 13, "seconds": 0, "nanos": 0, "utc_offset": "0s" }, "arrival_time": { "year": 2022, "month": 4, "day": 6, "hours": 20, "minutes": 13, "seconds": 0, "nanos": 0, "utc_offset": "0s" } } ] }
GetTripOptionsResponse
Proto-Definition
// Response received from partners. message GetTripOptionsResponse { oneof response { TripOptionsResult trip_options_result = 1; TripOptionsError trip_options_error = 2; } } // A successful partner response. message TripOptionsResult { // Note: // - A TripOption represents the fare for a combination of available service // classes for the segments in the request. // - If the seats within a service class are sold at different fares of // limited availability, a different TripOption instance with the same // sequence of segments can be returned for each fare. // Partners should also include options that are unavailable because they are // fully booked, using the appropriate Unavailable message below. repeated TripOption trip_options = 1; } // A travel option for users covering the whole end-to-end journey with the // partner. message TripOption { // A series of Segments that cover the whole trip option, one for each // SegmentKey in the request. repeated Segment segments = 1; // This is the lowest standard fare of all seats with the specified segments. // This field is optional if the series of segments is unavailable. // This "standard fare" should be the lowest seat price where no age or other // booking restrictions apply. The currency should be the local currency of // the origin of the first segment. Fare lowest_standard_fare = 2; // The availability status for bookings of this trip option at the // lowest_standard_fare. Availability availability = 3; // This is used to receive optional extra data via the Travel Transport API // and pass it into the ticketing deep link. // Booking links should still work without the booking token, but the token // can be used to ensure price consistency between Google Search results and // the partner booking page. string booking_token = 4 [features.field_presence = EXPLICIT]; } // A segment traveled on a single vehicle in a given Service Class. message Segment { SegmentKey segment_key = 1; // The service class used on this segment. ServiceClass service_class = 2; }
JSON-Beispiel
{ "trip_options_result": { "trip_options": [ { "segments": [ { "segment_key": { "ticketing_trip_id": "123456", "from_ticketing_stop_time_id": "ZRH-1234", "to_ticketing_stop_time_id": "LUZ-1235", "service_date": { "year": 2022, "month": 4, "day": 6 }, "boarding_time": { "year": 2022, "month": 4, "day": 6, "hours": 14, "minutes": 25, "seconds": 0, "utc_offset": "0s" }, "arrival_time": { "year": 2022, "month": 4, "day": 6, "hours": 16, "minutes": 25, "seconds": 0, "utc_offset": "0s" } }, "service_class": { "type": "FIRST_CLASS" } }, { "segment_key": { "ticketing_trip_id": "234567", "from_ticketing_stop_time_id": "LUZ-2759", "to_ticketing_stop_time_id": "WOL-2455", "service_date": { "year": 2022, "month": 4, "day": 6 }, "boarding_time": { "year": 2022, "month": 4, "day": 6, "hours": 18, "minutes": 13, "seconds": 0, "utc_offset": "0s" }, "arrival_time": { "year": 2022, "month": 4, "day": 6, "hours": 20, "minutes": 13, "seconds": 0, "utc_offset": "0s" } }, "service_class": { "type": "FIRST_CLASS" } } ], "lowest_standard_fare": { "total_amount": { "units": 15, "nanos": 0, "currency_code": "CHF" }, "line_items": [ { "line_item_type": "BASE_FARE", "amount": { "units": 13, "nanos": 950000000, "currency_code": "CHF" } }, { "line_item_type": "SERVICE_CHARGE", "amount": { "units": 1, "nanos": 50000000, "currency_code": "CHF" } } ] }, "availability": { "available": { "available_seat_count": 10, "total_seat_count": 30 } } }, { "segments": [ { "segment_key": { "ticketing_trip_id": "123456", "from_ticketing_stop_time_id": "ZRH-1234", "to_ticketing_stop_time_id": "LUZ-1235", "service_date": { "year": 2022, "month": 4, "day": 6 }, "boarding_time": { "year": 2022, "month": 4, "day": 6, "hours": 14, "minutes": 25, "seconds": 0, "utc_offset": "0s" }, "arrival_time": { "year": 2022, "month": 4, "day": 6, "hours": 16, "minutes": 25, "seconds": 0, "utc_offset": "0s" } }, "service_class": { "type": "SECOND_CLASS" } }, { "segment_key": { "ticketing_trip_id": "234567", "from_ticketing_stop_time_id": "LUZ-2759", "to_ticketing_stop_time_id": "WOL-2455", "service_date": { "year": 2022, "month": 4, "day": 6 }, "boarding_time": { "year": 2022, "month": 4, "day": 6, "hours": 18, "minutes": 13, "seconds": 0, "utc_offset": "0s" }, "arrival_time": { "year": 2022, "month": 4, "day": 6, "hours": 20, "minutes": 13, "seconds": 0, "utc_offset": "0s" } }, "service_class": { "type": "SECOND_CLASS" } } ], "lowest_standard_fare": { "total_amount": { "units": 10, "nanos": 0, "currency_code": "CHF" }, "line_items": [ { "line_item_type": "BASE_FARE", "amount": { "units": 9, "nanos": 750000000, "currency_code": "CHF" } }, { "line_item_type": "SERVICE_CHARGE", "amount": { "units": 0, "nanos": 250000000, "currency_code": "CHF" } } ] }, "availability": { "available": { "available_seat_count": 44, "total_seat_count": 200 } } } ] } }
JSON-Fehlerbeispiel
{ "trip_options_error": { "error_type": "SEGMENT_KEY_NOT_FOUND", "error_message": "No matching segments found, no departures at 14:25" } }
Hinweis zur API-Implementierung:
Um die Vorwärtskompatibilität mit potenziellen Änderungen zu gewährleisten, sollten Sie zusätzliche Parameter, die in Segmentierungsschlüsseln gefunden werden, immer in der Antwort zurückgeben. Andernfalls ignorieren Sie die Parameter und behandeln Sie die Anfrage so, als wären sie nicht vorhanden, bis Sie eine spezifische Unterstützung für die Parameter implementieren.
Fehlerantworten
In der folgenden Tabelle werden die Erwartungen an die Fehlerberichterstattung für diese Methode beschrieben:
| Fehlertyp | Wiederholbar | HTTP-Statuscode | Beschreibung |
|---|---|---|---|
SEGMENT_KEY_NOT_FOUND |
Nein | 404 | Das Segment für eine der angegebenen SegmentKeys wurde nicht gefunden. |
TRIP_OPTION_CACHE_STALE |
Ja | 404 | Die Daten für die angeforderte Fahrtoption sind beim Partner nicht aktuell und müssen aktualisiert werden, bevor sie an Google weitergegeben werden können. |
INTERNAL_ERROR |
Ja | 500 | Beim Abrufen dieser Fahrt ist ein unerwarteter Fehler aufgetreten. Dies weist auf einen Fehler hin, der vom Partner behoben werden muss. |
SUBOPTIMAL_ITINERARY |
Nein | 404 | Die Reise wurde gefunden, der Partner hält sie jedoch für nicht optimal und verkauft keine Tickets dafür. |
TICKETING_PROHIBITED |
Nein | 404 | Die Fahrt wurde gefunden, aber der Partner darf aufgrund allgemeiner Einschränkungen für den Ticketverkauf, die vom Betreiber oder der Eisenbahnbehörde auferlegt wurden, keine Tickets dafür verkaufen. |
BOOKING_WINDOW_NOT_SUPPORTED |
Nein | 404 | Der Partner unterstützt keine Preisangaben für Reisepläne für das angeforderte Datum. |
Weitere Informationen finden Sie unter TripOptionsErrorType.
Informationen zum Zurückgeben von Statuscodes in HTTP-Antworten finden Sie unter Statuscodes und Fehlerbehandlung.