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. Bsp verwendet die BLS für Bern – Zweisimmen den Produktcode 84004.
  • 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.
  • Die Halbpreisberechnung war bis jetzt fix hinterlegt. Jetzt ist dies anders. Ein entsprechender Traveler mit dem EntitalementProduct ist jetzt notwendig.

Bekannte Probleme

  • Im Moment werden die Daten ab der Integrationsumgebung von NOVA bezogen.
  • Die Fehlermeldungen sind nicht optimal.
  • Im Moment ist der Halbtaxpreis (HTA als EntitlementProduct) fix im Service reinkodiert. Wir überlegen, dies aufzuheben. Dann muss aber das EntitlementProduct unbedingt eingefügt werden. Das Alter wird übernommen. Aber auch sonst wird der Preis auf “Person” eingestellt.
  • In gewissen Fällen wird auf einen Tagespass gewechselt. Z.B. weil es gar kein Erstklassticket gibt. Dann kann es sein, dass unter Code 2361 eine vergünstigte Tageskarte kommt. Dies muss gefiltert werden.
  • Mit Haltestellen im Ausland werden keine Preise angegeben (z.B. auch Léman Express nicht)

Weiterführende Angaben