| Adapps lango switcher macro |
|---|
| Table of Contents | ||||
|---|---|---|---|---|
|
Ara est une application permettant de collecter et faire transiter les flux de données temps réel décrivant votre offre de transport sur un ou plusieurs réseaux.
Il est en mesure de collecter les données issues de vos SAE via les protocoles standards : GTFS-RT, SIRI.
...
Ara assure ensuite la diffusion de ces données auprès des différents réutilisateurs (application voyageur, Open Data, etc.) dans les protocoles requis : GTFS-RT, SIRI, SIRI-Lite.
...
Les entités auprès desquelles sont collectées les données temps réel ou vers lesquelles sont diffusées les données temps réel sont appelées des
...
Partenaires d’échanges explicités dans le manuel utilisateur. La collecte de données pour Ara s’effectue à travers la configuration de connecteurs pour ces
...
Partenaires d’échange, qui permettent d’alimenter Ara en données temps réel une fois configurés.
...
Du point de vue fonctionnel, à chaque Partenaire
...
d’échanges correspond un paramétrage spécifique des connecteurs de la plateforme
...
...
Vous pouvez configurer un partenaire d’échange par le biais de l’interface utilisateur d’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:
Check Status : pour connaître en permanence l’état du serveur SIRI du SAE ;
Stop Point Discovery : pour connaître en permanence l’ensemble des arrêts qui peuvent être collectés en temps-réel ;
Stop Monitoring (en mode abonnement) : pour collecter en continu l’état des arrêts et des passages qui y sont prévus.
Pour configurer le Partenaire d'
...
échanges qui permet d’alimenter Ara SaaS dans cette configuration, seuls trois paramètres sont nécessaires:
l’URL publique du service SIRI du SAE pour transmettre les requêtes. par ex: https://<ip publique>:<port>/SiriServices
L’identifiant utilisé par Ara en tant que RequestorRef dans les requêtes SIRI transmises au serveur SIRI du SAE
L’identifiant utilisé par le serveur SIRI du SAE en tant que ProducerRef dans les notifications SIRI transmises à Ara
...
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
...
Configuration d’un partenaire d’échange
La configuration d’un partenaire d’échange nécessite seulement quatre paramètres :
L’URL publique du serveur d’échange SIRI du SAE pour transmettre les requêtes
L’identifiant utilisé par Ara dans ses requêtes de données transmises au serveur du SAE
L’identifiant utilisé par le serveur du SAE en tant que producteur de données dans les notifications transmises à Ara
Les services auxquels souscrire pour le partenaire d’échange
...
Pour accéder au menu de configuration d’un partenaire d’échange, une fois connecté à votre interface Ara, cliquez sur votre espace de travail dans le tableau de bord (menu à gauche).
...
En cliquant sur la section Partenaires, la liste des partenaires d’échange déjà configurés apparaît dans la section centrale de l‘interface.
...
un
...
paramétrage
...
)
...
Le champ ‘local_url’ correspond à l’URL du service SIRI d’Ara qui vous est attribuée en amont.
ex : https://ara-api.enroute.mobi/client/siriIl est complété par un identifiant, renseigné dans la section ‘local_credential’ qui autorise les requêtes SIRI transmises au serveur SIRI du SAE.
Le champ ‘remote_url’ désigne l’URL publique du service SIRI de votre SAE pour transmettre les requêtes à Ara.
Le champ ‘remote_credential’ est l’identifiant qui autorise la transmission des notifications du serveur SIRI du SAE à Ara.
Le champ ‘Connecteurs’ désigne l’ensemble des services auxquels vous souhaitez souscrire pour le partenaire d’échange. ll permet la sélection de plusieurs services en cochant ou décochant indépendamment chaque service dans le menu déroulant (icône ‘check’).
...
Une fois les champs renseignés, cliquez sur ‘Créer un Partenaire’ afin d’enregistrer votre sélection et de confirmer la création de votre partenaire d’échange.
Les informations liées à votre partenaire d’échange sont consultables dans la section Partenaires de votre espace de travail. Cliquez sur le nom du partenaire d’échange que vous venez de créer dans la liste.
...
Les détails de votre Partenaire d’Échange indiquent les paramètres renseignés lors de sa configuration dans la rubrique ‘Settings’ ainsi que la liste des services souscrits pour ce partenaire dans la rubrique ‘Connectors’.
Il est possible de modifier les paramètres de configuration du Partenaire d’Échange (ajouter un connecteur / service SIRI par exemple) en cliquant sur ‘Modifier ce Partenaire’ dans le menu supérieur, à droite.
Statut des Partenaires d’Échange
Dans l’interface principale pour chaque référentiel temps réel, vous pouvez visualiser l’ensemble des partenaires d’échange.
Parmi les informations affichées, l’interface indique le statut des partenaires d'échange, leurs noms, leurs noms courts et les informations de configuration des partenaires d’échange (types de service souscrits et paramètres de configuration).
...
L’information de statut du partenaire d’échange consiste en 3 états distincts :
Disponible
Indisponible
Inconnu
L’état est modifié uniquement si le partenaire d’échange utilise une requête CheckStatus ou une sonde Scops.
.png?version=1&modificationDate=1632216028830&cacheVersion=1&api=v2)
L’état Disponible indique que le partenaire d’échange a répondu positivement à la vérification d’activité qui lui a été envoyée par Ara. En conséquence, il est en état de fonctionnement et prêt à répondre à toute requête.
L’état Indisponible indique que le partenaire d’échange n’a pas répondu favorablement à la vérification d’activité qui lui a été envoyé par Ara. Ara est donc en mesure de communiquer avec ce partenaire d’échange, mais celui-ci n’est pas disponible ou n’est pas en état de fonctionnement. Cette indisponibilité du partenaire d'échange peut être le signe de problèmes dans le fonctionnement ou le paramétrage du côté du partenaire d’échange.
.png?version=1&modificationDate=1632216264784&cacheVersion=1&api=v2)
L’état Inconnu indique soit qu’Ara est incapable de procéder à la vérification d’activité du partenaire d’échange (problème de réseau, etc.), soit encore que les services souscrit ne permettent pas la mise à jour du statut (il s’agit alors d’une situation normale).
...
.
Echanges sécurisés
Pour que ces échanges SIRI soient possibles, les échanges réseau doivent être possibles entre le serveur HTTP SIRI du SAE et les serveurs d’Ara SaaS.
L’interface HTTP SIRI du SAE doit être accessible depuis Internet sur une IP publique. Nous recommandons que les échanges soient possibles en HTTPS.
Les requêtes SIRI vers Ara seront uniquement possibles en HTTPS (vers https://ara-api.enroute.mobi).