Aller au contenu

Flotte

Les moyens engagés pour assurer le service : qui conduit, avec quel véhicule, équipé de quel appareil, au départ de quel dépôt.

drivers

Conducteur — la personne qui assure les courses. Le conducteur n'est pas un utilisateur de l'interface d'exploitation : il s'identifie sur l'application Pysae Driver, au moment de sa prise de service.

Identifiant <driver_id>. Un conducteur porte un matricule, appartient à une ou plusieurs équipes, et peut être archivé lorsqu'il quitte le réseau — l'archivage le retire de l'exploitation courante sans effacer l'historique auquel il est lié.

Endpoint Rôle
GET /api/v4/groups/<group_id>/drivers Liste les conducteurs du groupe
GET /api/v4/groups/<group_id>/drivers/<driver_id> Décrit un conducteur
GET /api/v4/groups/<group_id>/export/drivers Exporte les conducteurs au format CSV

vehicles

Véhicule — l'autobus ou l'autocar engagé sur le réseau. Il porte son numéro de parc, sa plaque, son type et son énergie, sa capacité, et les équipements embarqués qui l'accompagnent.

Identifiant <vehicle_id>. Un véhicule appartient à une ou plusieurs équipes et porte un statut d'exploitation, qui distingue un véhicule en service d'un véhicule immobilisé.

Endpoint Rôle
GET /api/v4/groups/<group_id>/vehicles Liste les véhicules du groupe
GET /api/v4/groups/<group_id>/vehicles/<vehicle_id> Décrit un véhicule
GET /api/v4/groups/<group_id>/vehicles/public Donne les données diffusables aux voyageurs
GET /api/v4/groups/<group_id>/export/vehicles Exporte les véhicules au format CSV

devices

Appareil — le téléphone ou la tablette du conducteur, sur lequel tourne l'application Pysae Driver. C'est lui qui remonte la position du véhicule et l'avancement de la course, et donc la source de tout le temps réel : sans appareil en service, une course n'est pas suivie.

Identifiant <device_id>. Un appareil est rattaché au véhicule à bord duquel il circule, et connaît la course qu'il assure à un instant donné — désignée par le triplet identifiant de course, date de service et gtfs_id. Il porte aussi ses propres métadonnées : modèle, système d'exploitation, version installée de l'application.

Endpoint Rôle
GET /api/v4/groups/<group_id>/devices Liste les appareils du groupe
GET /api/v4/groups/<group_id>/devices/<device_id> Décrit un appareil et son état courant
GET /api/v4/groups/<group_id>/devices/online Liste les appareils actuellement connectés

depot

Dépôt — le site de remisage d'où partent et où reviennent les véhicules. Il sert de repère à l'exploitation : les trajets à vide entre le dépôt et le début de la course en sont décomptés.

Identifiant <depot_id>.

Endpoint Rôle
GET /api/v4/groups/<group_id>/depots Liste les dépôts du groupe

duties

Service de conduite — la période pendant laquelle un conducteur assure le service, de sa prise de service à sa fin de service. C'est l'objet qui relie effectivement un conducteur, un véhicule, un appareil et les courses réalisées.

Identifiant <duty_id>. Un service porte obligatoirement l'appareil utilisé, et référence le conducteur et le véhicule engagés. Il contient la liste des courses effectuées, les kilomètres à vide parcourus, et les informations de prise et de fin de service — dont les réponses au questionnaire de contrôle, le cas échéant.

Endpoint Rôle
GET /api/v4/groups/<group_id>/duties Liste les services sur une période
GET /api/v4/groups/<group_id>/duties/<duty_id> Décrit un service et ses courses

Là où la planification prévoit, le service de conduite constate.

duty-checklist

Questionnaire de service — la liste de contrôles que le conducteur renseigne à la prise ou à la fin de son service : état du véhicule, propreté, anomalies constatées. Sa composition se configure par groupe, et les réponses sont conservées dans le service de conduite correspondant.

Pas d'identifiant propre : le questionnaire est une configuration du groupe.

Cette configuration se pilote depuis les applications Pysae et n'est pas publiée dans le spec public.