Ce document décrit l’interface GTFS-RT (ou GTFS-realtime) sur PYSAE.
Point d'accès
Le connecteur GTFS-RT pour votre groupe est accessible à l'adresse suivante :
https://pysae.com/api/v2/groups/[group_id]/gtfs-rt
group_id est l'identifiant de votre groupe dans PYSAE.
Voici un exemple de flux en fonctionnement :
https://pysae.com/api/v2/groups/lila/gtfs-rt
Attention, le résultat d'une requête gtfs-rt est un fichier binaire. Il n'est donc pas lisible directement par un éditeur de texte.
Protocole d’échange
Transport
Le protocole de transport utilisé est le HTTPS.
Format
Conformément à la norme GTFS-RT les données sont renvoyée sous forme de ProtocolBuffer dont la description et les fichiers .proto se trouvent ici :
https://developers.google.com/transit/gtfs-realtime/reference/.
Services proposés
Les services proposés sont les suivants :
- TripUpdate
- VehiclePosition
- Alert
Service TripUpdate
Le tableau qui suit détaille le contenu du service TripUpdate.
Intitulé | Type | Disponibilité PYSAE | Commentaire |
trip | TripDescriptor | Oui | Course concernée |
vehicle | VehicleDescriptor | Oui | Véhicule concerné |
stop_time_update | StopTimeUpdate | Oui | Mise à jour du temps de passage |
VehiclePosition
Le tableau qui suit détaille le contenu du service VehiclePosition.
Intitulé | Type | Disponibilité PYSAE | Commentaire |
trip | TripDescriptor | Oui | Course concernée |
vehicle | VehicleDescriptor | Oui | Véhicule concerné |
position | Position | Oui | Position du véhicule |
current_status | VehicleStopStatus | Oui | Status du véhicule par rapport au prochain arrêt |
congestion_level | CongestionLevel | Non | Difficultés de circulation |
_occupancy_status_ | OccupancyStatus | Non | Taux d’occupation |
Alert
Le tableau qui suit détaille le contenu du service Alert.
Intitulé | Type | Disponibilité PYSAE | Commentaire |
active_period | TimeRange | Oui | Période d’application |
informed_entity | EntitySelector | Oui |
Élément concerné (course, arrêt, ligne) |
header_text | TranslatedString | Oui |
En-tête de l'alerte |
description_text | TranslatedString | Oui |
Description de l'alerte |
cause | Cause | Non | Cause de la perturbation |
effect | Effect | Non | Effet de la perturbation |
url | TranslatedString | Non | Traduction du message |