/
Collecter des données temps réel avec ARA via une interface SIRI

Collecter des données temps réel avec ARA via une interface SIRI

 

Ce guide décrit la configuration d'un Partenaire d'échange permettant à Ara de collecter des données temps réel depuis un SAE via SIRI. Pour le rôle d'Ara et les concepts communs (sens des échanges, identifiants RequestorRef / ProducerRef), voir la page Guides Ara.

Principe d’une collecte en SIRI 

Ara SaaS peut collecter les données temps-réel de multiples manières. 

La configuration la plus appropriée est d’utiliser le protocole SIRI afin de collecter en continu l’état des arrêts et des passages qui y sont prévus.

 

La configuration la plus simple consiste à associer les trois services SIRI standards suivants:

  • CheckStatus : pour connaître en permanence l’état du serveur SIRI du SAE ;

  • StopPointsDiscovery : pour connaître en permanence l’ensemble des arrêts qui peuvent être collectés en temps-réel ;

  • StopMonitoring (en mode abonnement) : pour collecter en continu l’état des arrêts et des passages qui y sont prévus.

 

Pour configurer ce Partenaire d'échanges, trois paramètres sont nécessaires :

  • l'URL publique du service SIRI du SAE (remote_url) ;

  • l'identité d'Ara, transmise comme RequestorRef dans les requêtes (remote_credential) ;

  • l'identité du partenaire, attendue comme ProducerRef dans ses notifications (local_credential).

La signification de RequestorRef / ProducerRef selon le sens de l'échange est détaillée dans Guides Ara › Les identifiants en SIRI.

 

Les notifications SIRI seront envoyées par le serveur SIRI du SAE à Ara sur l’URL publique : https://ara-api.enroute.mobi/<referential>/siri. 

Cette URL est transmise dans chaque requête de demande d’abonnement SIRI effectuée par Ara (donc ne nécessite pas forcément un paramétrage).

Exemple de configuration du partenaire d'échange Ara

 

image-20241212-103845.png

 

Les informations suivantes correspondent à une configuration par défaut d'un nouveau Partenaire d'échanges collectant en SIRI StopMonitoring:

Connecteurs

  • SIRI CheckStatus Client

  • SIRI CheckStatus Server

  • SIRI StopMonitoring Subscription Collector

  • SIRI StopPointsDiscovery Request Collector

Paramètres

  • local_credential: ProducerRef utilisé par le serveur SIRI du SAE dans ses notifications/réponses à Ara (identité du partenaire, sert à l'identifier)

  • remote_credential: RequestorRef utilisé par Ara pour interroger le serveur SIRI distant (identité d'Ara)

  • remote_url: l'URL publique du serveur SIRI distant

  • remote_code_space: le type d’identifiant à utiliser pour les données collectées (en lien avec les autres partenaires d'échange définis dans Ara)

  • collect_use_discovered_stop_areas: true (pour collecter uniquement les arrêts découverts via SIRI StopPointsDiscovery)

 

Pour la description complète de tous les paramètres, voir Paramètres d'un Partenaire d'Échange.