Skip to content

Bêta : renseignements sur les prix avec OJP Fares

Une consultation des prix des transports publics via NOVA est mise à disposition via cette interface.

Il s’agit d’un premier système de test et les données proviennent de l’intégration et non de la production.

(Timetable)

Description spécifique

Le service OJP fare permet de calculer le prix des trajets. Ce service permet d’effectuer des requêtes au format OJP par rapport à NOVA. Les réponses incluent également les trajets à prix réduit. La consultation doit se faire dans le futur. Les trajets doivent être transmis sous forme de TripResult.

Seules les demandes de prix en Suisse sont possibles. Les demandes de prix avec demi-tarif (“HTA”) sont possibles.

L’information sur les prix n’est pas contraignante. Le prix effectif n’est défini qu’au moment de la commande.

Le nombre de demandes est également limité.

Aspects techniques

Pour l’instant, seul le système d’intégration est disponible.

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

L’accès se fait uniquement à l’aide de la clé API. Voir : Developer Dashboard | Plate-forme Open-Data Mobilité Suisse (opentransportdata.swiss)

Le service permet également d’envoyer des OJPTripRequests et d’en extraire ensuite les TripResults nécessaires à la consultation.

Exemple : OJPTripRequest à l’intérieur de Berne

 

Un TripResult en réponse :

 

 

La OJPFareRequest effective se présente alors comme suit (où nous ne montrons que la position du trip et ne la remplissons pas) :

 

Paramètre

Les trips sont expliqués dans OJPTripRequest. C‘est pourquoi nous nous concentrerons ici sur les paramètres

Paramètre Explication Exemple
oFareAuthorityfilter Actuellement réglé sur NOVAEst ignoré dans le service. ojp:FareAuthorityFilter>ch:1:NOVA</ojp:FareAuthorityFilter>
PassengerCategory Liste de sélection PassengerCategory. Ignoré pour le moment. <ojp:PassengerCategory>Adult</ojp:PassengerCategory>
Traveller Traveller Plus d’informations sur le voyageur. Ignoré pour le moment.
Age Age L‘âge du voyageur. Ignoré pour le moment.
EntitlementProduct Pour le moment, seul l’EntitlementProductRef HTA (abonnement demi-tarif) est pris en charge.
Si cette case est cochée, le prix du demi-tarif est indiqué, sinon le plein tarif est indiqué.

Le résultat se présente alors comme suit. Request se présente alors comme suit (où nous ne montrons que la position du trip et ne le remplissons pas) :

 

Points importants

  • Le calcul des prix ne fonctionne que pour l’avenir.
  • Seuls les TP Legs peuvent être évalués.
  • Les informations sur les prix incluent également les billets dégriffés, s’ils existent. Les billets à prix normal ont le code 125
  • Si On Demand, Sharing etc est mentionné sur le trip, le comportement n’est pas complètement défini pour le moment. En principe, il est informé que tous les legs n’ont pas pu être tarifés.

Problèmes connus

Les messages d’erreur ne sont pas optimaux.

Informations supplémentaires