Aller au contenu

Exploitation

Ce qui se passe pendant le service : l'avancement réel des courses, les écarts au théorique, et la supervision en ligne.

trip_events

Événement de course — un fait daté survenu pendant une course : passage à un arrêt, départ, arrivée, changement d'état. Ces événements, remontés par l'appareil, constituent la trace de ce qui s'est réellement produit et alimentent le calcul de l'avance-retard.

Pas d'identifiant propre exposé : un événement se situe par sa course, sa date et son horodatage.

Endpoint Rôle
GET /api/v4/groups/<group_id>/trip-events Liste les événements survenus sur une période

trip-updates

Modification de course — un écart au théorique décidé par l'exploitant : arrêt supprimé, arrêt déplacé, arrêt ajouté, course déviée ou annulée. La modification ne réécrit pas le GTFS : elle se superpose au théorique pour une période donnée, et se répercute dans la diffusion voyageurs.

Identifiant <trip_update_id>. Une modification porte sur une course et une plage de dates ; les déviations en sont un cas particulier, identifié comme tel.

Ces modifications se saisissent depuis les applications Pysae et ne sont pas publiées dans le spec public. Leur effet, lui, est visible par les voyageurs à travers les flux GTFS-RT et SIRI.

trip-tracking

Suivi de course — la restitution de la façon dont une course s'est déroulée : à quelle heure le véhicule est passé où, avec quel écart sur l'horaire prévu. C'est la vue consolidée de l'exécution, celle qu'on exporte pour analyser le service rendu.

Pas d'identifiant propre : un suivi se rapporte à une course et à sa date.

Endpoint Rôle
GET /api/v4/groups/<group_id>/stats/trip-tracking Agrège le suivi sur une période
GET /api/v4/groups/<group_id>/export/trip-tracking Exporte le détail au format CSV

vehicle_movements

Mouvement de véhicule — un déplacement du véhicule rattaché à l'exploitation, y compris hors course commerciale : trajet vers le début de la course, retour au dépôt, haut-le-pied. Ces mouvements complètent les courses pour restituer l'usage complet du véhicule.

Identifiant <vehicle_movement_id>. Un mouvement peut se rattacher à un bloc, la suite de courses enchaînées par un même véhicule.

Endpoint Rôle
GET /api/v4/groups/<group_id>/vehicle_movements Liste les mouvements sur une période
GET /api/v4/groups/<group_id>/blocks/<block_id>/vehicle_movements Donne les mouvements d'un bloc

vehicle-exploitation

Exploitation du véhicule — la restitution de l'activité d'un véhicule sur une période : ce qu'il a assuré, quand, et sur quelles distances. Sert au suivi de parc et aux échanges avec les systèmes de gestion de flotte.

Pas d'identifiant propre : la donnée s'obtient par véhicule et par période.

Endpoint Rôle
GET /api/v4/groups/<group_id>/export/vehicle-exploitation Exporte l'activité des véhicules au format CSV

danger_zones

Zone dangereuse — un point du réseau signalé aux conducteurs comme demandant une vigilance particulière : passage étroit, sortie difficile, zone accidentogène. L'appareil alerte le conducteur à l'approche.

Identifiant <danger_zone_id>. Une zone est définie par un point géographique, un rayon et le message affiché.

Endpoint Rôle
GET /api/v4/groups/<group_id>/danger-zones Liste les zones déclarées sur le réseau