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.