En tant que solution SAEIV complète, PYSAE possède différents connecteurs pour l'affichage des données en temps réel de votre réseau, notamment en GTFS-RT. Ce format normalisé facilite la transmission des données temps réel vers des outils tiers.
Les avantages d'un connecteur GTFS-RT
Le format GTFS-RT (ou GTFS-realtime) est de plus en plus utilisé pour les réseaux de transport. Il permet de simplifier l'intégration des informations de planification et de déplacement de vos flux, tout en transmettant ces informations à vos passagers via une application ou un afficheur.
Ainsi, le connecteur GTFS-RT est idéal pour intégrer des données en temps réel et fournir des informations précises et actualisées à vos passagers.
Point d'accès
Le connecteur GTFS-RT pour votre groupe est accessible à l'adresse suivante (cela comprend tous les services):
https://pysae.com/api/v2/groups/[group_id]/gtfs-rt
group_id est l'identifiant de votre groupe dans Pysae.
Nous proposons des alias, en cas de nécessité d'une adresse par service :
https://pysae.com/api/v2/groups/[group_id]/gtfs-rt/trip-update
https://pysae.com/api/v2/groups/[group_id]/gtfs-rt/vehicle-position
https://pysae.com/api/v2/groups/[group_id]/gtfs-rt/alert
Voici un exemple de flux en fonctionnement :
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ées 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é sur 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é sur 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é sur 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 | Oui | Cause de la perturbation |
effect | Effect | Oui | Effet de la perturbation |
url | TranslatedString | Non | Traduction du message |