Ara est une application permettant de faire transiter les flux décrivant l’offre de transport en temps-réel sur un ou plusieurs réseaux.

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’Echange.

D'un point de vue fonctionnel, chaque Partenaire d'Échange nécessite une configuration personnalisée des connecteurs sur la plateforme Ara SaaS.

Référentiel

Le Client dispose d’un ou plusieurs Référentiels dont il est propriétaire.

Chaque Référentiel Ara permet de :

• configurer les Partenaires d'Échange souhaités par le Client, et ainsi contrôler les flux d’information qui seront collectés et diffusés par Ara

• réunir les données temps-réel (arrêts, lignes, courses) collectées auprès des différents Partenaires d'Échange

• isoler les données des autres Référentiels

• prédéfinir les informations (arrêts, lignes, courses) gérées par Ara quotidiennement

Open

Référentiels Ara

Chaque référentiel offre un ensemble d'informations :

• Le nom du référentiel.

• Le nom court du référentiel, nécessaire pour l'utilisation des différentes API d'Ara.

• L'URL des API.

Open

Partenaires d'échanges

Chaque Partenaire d'Échange regroupe :

• Une sélection de connecteurs définissant les protocoles (SIRI, GTFS-RT, SIRI Lite, etc) et les types d'échanges (abonnement, requête, etc) :

• Un paramétrage spécifique de ces connecteurs tels que

  • Les URL distantes, les types d'identifiants,

  • Les tokens utilisés pour l'authentification des requêtes

  • L'état courant des échanges en cours, tels que les abonnements, les derniers états transmis, les caches de données, etc

  • Le suivi des requêtes : le comptage et la limitation des requêtes associées à ce partenaire d'échange.

Configuration d’un Partenaire d’Échange SIRI en collecte

La configuration d’un partenaire d’échange SIRI nécessite seulement quatre paramètres : 

1. Les connecteurs auxquels souscrire pour le partenaire d’échange

2. L’URL publique du serveur d’échange SIRI du SAE pour transmettre les requêtes 

3. L’identifiant utilisé par Ara dans ses requêtes de données transmises au serveur du SAE

4. L’identifiant utilisé par le serveur du SAE en tant que producteur de données dans les notifications transmises à Ara

Le pas-à-pas ci-dessous détaille les différentes étapes de configuration d’un partenaire d’échange.

• Une fois connecté à votre interface Ara, accédez au menu de configuration d’un Partenaire d’Échange de votre Référentiel (menu à gauche)

• En cliquant sur la section Partenaires d'échange, la liste des partenaires d’échange déjà configurés apparaît dans la section centrale de l'interface.

• Cliquez sur le bouton “Ajouter un nouveau partenaire” dans le menu supérieur, à droite.

Une fois dans le menu de configuration d’un partenaire, renseignez les informations de paramétrage énumérées ci-dessous dans les champs prévus :

En plus du nom, votre Partenaire d’Échange comprend les paramètres suivants :

• Les ‘Connecteurs’ 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’).

• Le champ “local_url' qui est l’URL du serveur Ara, cette URL est disponible sur la page Référentiel

• L'identifiant, renseigné dans la section ‘local_credential’ qui autorise les requêtes Ara 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 ‘remote_code_space” est le type d’identifiant qu'Ara doit utiliser pour concorder les données temps réel avec les données théoriques.

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.

Configuration d’un Partenaire d’Échange GTFS-RT en collecte

La configuration d’un partenaire d’échange GTFS-RT nécessite les paramètres suivants :

1. Les connecteurs auxquels souscrire pour le partenaire d’échange, ici le connecteur GTFS-RT Collector

2. Le ‘remote_url' qui est l’URL du serveur SAE

3. Le champ ‘remote_code_space” qui est le type d’identifiant qu'Ara doit utiliser pour concorder les données temps réel avec les données théoriques.

Statut

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.