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. Par exemple, la BLS utilise le code de produit 84004 pour Berne – Zweisimmen.
  • 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.
  • Le calcul du demi-prix était jusqu’à présent fixé. Maintenant, c’est différent. Un Traveler correspondant avec l’EntitalementProduct est maintenant nécessaire.

Problèmes connus

  • Pour le moment, les données sont obtenues à partir de l’environnement d’intégration de NOVA.
    Les messages d’erreur ne sont pas optimaux.
  • Pour l’instant, le prix à demi-tarif (HTA comme EntitlementProduct) est encodé de manière fixe dans le service. Nous envisageons d’abroger cette disposition. Mais dans ce cas, il faut absolument insérer l’EntitlementProduct. L’âge est repris. Mais sinon, le prix est réglé sur “personne”.
  • Dans certains cas, on passe à un pass journalier. Par exemple, parce qu’il n’existe pas de billet de première classe. Il se peut alors qu’une carte journalière à prix réduit apparaisse sous le code 2361. Cela doit être filtré.
  • Aucun prix n’est indiqué pour les arrêts à l’étranger (p. ex. pas non plus pour Léman Express).

Informations supplémentaires