Diffusion des données temps réel avec SIRI

Les données temps réel collectées par ARA peuvent être récupérées à travers différents protocoles, en particulier les protocoles SIRI et SIRI Lite, ainsi que l’extension GTFS-RT.

Le système distant doit utiliser un client SIRI pour récupérer les données temps réel. En fonction des capacités du client, l’API SIRI d’Ara peut être utilisée de différentes façons :

• en utilisant les services StopMonitoring ou EstimatedTimetable

• en utilisant le mode requêtes ou abonnement

Ce choix dépend des capacités réelles du système distant et de sa compatibilité avec SIRI. Avec Ara, vous pouvez sélectionner dans l’interface utilisateur quels types de services et de protocoles seront disponibles pour un partenaire donné.

Configurer un partenaire

La plupart du temps, vous devez créer un partenaire dédié à ce nouvel échange SIRI.

Open

Vous devrez configurer les connecteurs nécessaires en fonction de l'échange SIRI voulu : 

Autoriser les requêtes SIRI-StopMonitoring

Ajouter les 3 connecteurs suivants au partenaire d’échange :

• Serveur CheckStatus (CheckStatus)

• Diffuseur StopPointsDiscovery (StopPointDiscovery Request Broadcaster)

• Diffuseur de requête StopMonitoring (StopMonitoring Request Broadcaster)

Ces connecteurs ne nécessitent que 2 paramètres : 

• l’identifiant local choisi pour identifier le partenaire : local_credential

• le type de code à utiliser pour interagir avec ce partenaire : remote_objectid_kind

A travers ces connecteurs, le serveur distant SIRI sera capable de : 

• vérifier le statut de notre référentiel temps réel Ara (via le service SIRI CheckStatus)

• récupérer la liste des points d’arrêt (via le service SIRI StopPointsDiscovery)

• les dessertes suivantes de chaque point d’arrêt (via le service SIRI StopMonitoring)

Le fournisseur de serveur distant SIRI vous demandera : 

• le point d’accès de notre référentiel Ara SIRI : https://ara-api.enroute.mobi/<short-name>/siri

• l’identifiant local Ara que vous avez choisi pour identifier ce partenaire 

Autoriser les abonnements SIRI-StopMonitoring

Ajouter les 4 connecteurs suivants au partenaire d’échange :

• Serveur CheckStatus

• Client CheckStatus

• StopPoint discovery request broadcaster

• StopMonitoring subscription broadcaster

Ces connecteurs ne nécessitent que 4 paramètres : 

• le point d’accès SIRI du système distant (une URL HTTPS publique) : local_url

• l’identifiant local choisi pour identifier ce partenaire : local_credential

• l’identifiant distant choisi par le système distant pour identifier Ara : remote_credential

• le type de code à utiliser pour interagir avec ce partenaire : remote_objectid_kind

A travers ces connecteurs, le serveur distant SIRI sera capable de :

• vérifier le statut de notre référentiel temps réel Ara (via le service SIRI CheckStatus)

• récupérer la liste des points d’arrêt (via le service SIRI StopPointsDiscovery)

• s’abonner à chaque point d’arrêt (via le service SIRI StopMonitoring) et de recevoir des notifications StopMonitoring de la part de son point d’accès distant SIRI

Le système distant doit être compatible avec : 

• le service SIRI CheckStatus

• le service de notification StopMonitoring

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).

Documentation technique

La documentation complète avec des exemples de tous les échanges SIRI sont disponibles dans le document Ara Broadcast API - SIRI interfaces.

Open