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.
| Endpoint | Rôle |
|---|---|
GET /api/v4/groups/<group_id>/trip-updates/search |
Recherche les modifications en vigueur |
PUT /api/v4/groups/<group_id>/trip-updates |
Enregistre une modification |
GET /api/v4/groups/<group_id>/deviations |
Liste les déviations |
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 |