Temps réel¶
Le temps réel a une seule source — l'appareil du conducteur — et deux débouchés : la supervision côté exploitant, et l'information voyageurs côté public.
La chaîne, du véhicule au voyageur¶
- L'appareil du conducteur remonte sa position et l'avancement de la course qu'il assure.
- L'API en déduit l'avancement réel : arrêts desservis, avance-retard, position sur le tracé.
- Ces éléments alimentent les flux normalisés que consomment les calculateurs d'itinéraire et les écrans.
Chaque étape se lit dans l'API, mais pas au même endroit ni avec la même fraîcheur : la position d'un véhicule s'interroge à l'instant, tandis que la trace de ce qui s'est produit se consulte dans l'historique.
Sans appareil, pas de temps réel¶
C'est la dépendance à retenir : une course dont l'appareil n'est pas en service n'est pas suivie. Elle reste prévue au référentiel, mais aucune donnée réalisée ne la concerne — ni position, ni avance-retard, ni passage aux arrêts.
L'appareil connaît la course qu'il assure à un instant donné, désignée par le triplet décrit page précédente. Il porte aussi son état de connexion, ce qui permet de distinguer un véhicule à l'arrêt d'un véhicule qui ne remonte plus.
| Endpoint | Rôle |
|---|---|
GET /api/v4/groups/<group_id>/devices |
Liste les appareils et leur état courant |
GET /api/v4/groups/<group_id>/devices/online |
Liste les appareils actuellement connectés |
GET /api/v4/groups/<group_id>/vehicle_movements |
Donne les déplacements, y compris hors course commerciale |
Ce qui ressort vers les voyageurs¶
Deux formats normalisés diffusent le même état du réseau, avec deux formalismes différents. Le choix dépend de ce que le consommateur attend, pas de ce que Pysae préfère.
| Format | Employé par | Voir |
|---|---|---|
| GTFS-RT | Calculateurs d'itinéraire, applications voyageurs | gtfs-rt |
| SIRI | Systèmes d'information voyageurs européens, autorités organisatrices | siri |
| Endpoint | Rôle |
|---|---|
GET /api/v4/groups/<group_id>/gtfs-rt |
Donne le flux GTFS-RT du groupe |
GET /api/v4/groups/<group_id>/siri |
Donne le flux SIRI du groupe |
Ces flux sont un produit, pas une source : ils agrègent le référentiel, les positions des appareils, les alertes et les modifications de course. Un écart constaté dans un flux se diagnostique donc en remontant à celle de ces entrées qui le porte.
Les perturbations¶
Deux objets distincts alimentent la partie « perturbation » des flux, et il ne faut pas les confondre :
- une alerte est un message destiné aux voyageurs — travaux, événement, arrêt non desservi ;
- une modification de course est un changement du service lui-même — arrêt supprimé, course déviée.
Une même perturbation réelle donne souvent lieu aux deux : le service change, et on l'annonce.
Et ensuite¶
Le temps réel dit ce que font les véhicules. Reste à savoir qui les conduit et selon quelle organisation — c'est l'objet de la page Exploitation.