Skip to content

Beta: Preisauskunft mit OJP Fares

Eine Abfrage von Preisen des öffentlichen Verkehrs über NOVA wird über diese Schnittstelle zur Verfügung gestellt.

Es handelt sich um ein erstes Testsystem und die Daten stammen aus der Integration und nicht von der Produktion.

(Timetable)

Fachliche Beschreibung

Der OJP fare service erlaubt die Preisberechnung von Trips. Mit dem Dienst können Abfragen im OJP Format gegenüber der NOVA durchgeführt werden. Die Antworten beinhalten auch Discountfahrten. Die Abfrage muss in der Zukunft erfolgen. Die Fahrten müssen als TripResult mitgegeben werden.

Es sind nur Preisabfragen in der Schweiz möglich. Preisabfragen mit Halbtax (“HTA”) sind möglich.

Die Preisauskunft ist nicht verbindlich. Der effektive Preis wird erst bei der Bestellung definiert.

Die Anzahl Anfragen ist ebenfalls limitiert.

Technische Aspekte

Im Moment steht nur das Integrationssystem zur Verfügung.

URL: https://api.opentransportdata.swiss/ojpfare/

Der Zugang erfolgt nur mit Hilfe des API-Keys. Siehe: Developer Dashboard | Open-Data-Plattform Mobilität Schweiz (opentransportdata.swiss)

Der Dienst erlaubt es auch, OJPTripRequests abzusetzen und dann daraus die notwendigen TripResults zu gewinnen für die Abfrage.

Beispiel: OJPTripRequest innerhalb von Bern

 

Ein TripResult in der Antwort:

Der effektive OJPFareRequest sieht dann wie folgt aus (wobei wir nur die Position des Trips zeigen und nicht ausfüllen):

 

Parameter

Trips sind in OJPTripRequest erläutert. Deshalb wird hier primär auf die Parameter eingegangen

Parameter Erläuterung Beispiel
oFareAuthorityfilter Im Moment auf NOVA eingestellt. Wird im Service ignoriert. ojp:FareAuthorityFilter>ch:1:NOVA</ojp:FareAuthorityFilter>
PassengerCategory Auswahlliste. Wird im Moment ignoriert. <ojp:PassengerCategory>Adult</ojp:PassengerCategory>
Traveller Mehr Information zum Reisenden. Wird im Moment ignoriert.
Age Das Alter des Reisenden. Wird im Moment ignoriert.
EntitlementProduct Im Moment wird ausschliesslich das EntitlementProductRef HTA (Halbpreisabo) unterstützt.

Ist dieses gesetzt, so werden Halbtax-Preise angegeben, ansonsten der volle Preis.

Das Resultat sieht dann wie folgt aus.

 

Wichtige Punkte

  • Die Preisberechnung funktioniert nur für die Zukunft.
  • Es können nur öV Legs bewertet werden.
  • Die Preisauskunft bezieht auch Spartickets mit ein, wenn sie existieren. Normalpreis-Tickets haben den Code 125
  • Wenn On Demand, Sharing etc auf dem Trip aufgeführt ist, so ist das Verhalten im Moment nicht vollständig definiert. Grundsätzlich wird darüber informiert, dass nicht alle Legs bepreist werden konnten.

Bekannte Probleme

  • Die Fehlermeldungen sind nicht optimal.

Weiterführende Angaben