Cet article décrit le point d'API permettant d'accéder aux horaires de passage enregistrés.
Requête
La requête vers le service doit avoir la forme :
https://pysae.com/api/v2/groups/<groupe_id>/history/stop_times?from=<from_ts>&to=<to_ts>&stop_id=<stop_id>
Paramètre | Valeur |
<group_id> | Identifiant du réseau concerné |
<from_ts> | Renvoyer les passages à partir de ce timestamp UNIX |
<to_ts> | Renvoyer les passages jusqu’à ce timestamp UNIX |
<stop_id> | Renvoyer les passages à cet/ces arrêts uniquement (optionnel, peut être spécifié plusieurs fois) |
Réponse
La réponse est une liste d’objets history_stop_times contenant les champs suivants
Champ | Valeur |
_id | Identifiant unique du passage |
gtfs_id | Identifiant du fichier GTFS actif au moment de l’enregistrement de l’événement |
start_date | Date de début de la course au format GTFS YYYYMMDD |
trip_id | Identifiant de la course |
stop_sequence | Numéro de séquence de l’arrêt dans la course |
stop_id | Identifiant de l’arrêt |
ts | Heure de l’événement enregistré en timestamp UNIX |
event | Type d’événement : soit « arrival » (arrivée à l’arrêt) soit « departure » (départ de l’arrêt) |
delay | Avance/retard par rapport au théorique en secondes |
device_id | Identifiant de l’appareil |
Exemple
Requête :
Demande des horaires de passage sur le groupe "pysae" entre le 20/10/2020 0h00 et le 21/10/2020 0h00 pour l'arrêt avec stop_id=1.
Réponse :
[ { _id: "5f8e9c5a9fe0c82317674765", gtfs_id: "5c3df090d18436050f506b83", trip_id: "105", start_date: "20201020", stop_id: "1", stop_sequence: 1, event: "arrival", device_id: "b51d5a1814b5a30f", delay: 0, ts: 1603181649 }, { _id: "5f8e9c609fe0c82317674775", gtfs_id: "5c3df090d18436050f506b83", trip_id: "105", start_date: "20201020", stop_id: "1", stop_sequence: 1, event: "arrival", device_id: "b51d5a1814b5a30f", delay: 0, ts: 1603181664 },]