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 sont remontés par l'appareil au fil du service.

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

Ces événements ne sont pas exposés en lecture. Le déroulé réel d'une course se consulte par le suivi de course, les passages observés par l'historique, et l'écart aux horaires par la ponctualité.

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