
Comparatif documenté · 3 périmètres
Horaires, temps réel et vélos partagés : quel flux pour quel usage ?
Un horaire prévu, une perturbation et la disponibilité d’un vélo répondent à des questions différentes. Choisissez le flux selon la décision du voyageur, puis vérifiez sa couverture locale.
Contenu éditorial mis à jour le . Chaque référence indique sa propre date de consultation. Les faits sont attribués aux sources ; les scénarios et conseils sont éditoriaux. Le périmètre commercial, les prix et les droits de votre compte restent à confirmer.
Références documentaires et points à vérifier
Les lignes comparent des rôles et des conditions d’accès. Un point non documenté reste une question à poser, sans lui attribuer une note négative. Sur téléphone, chaque périmètre se lit dans une carte.
| Périmètre et rôle | Documenté | Limite | À demander |
|---|---|---|---|
GTFS Schedule Décrire un réseau et son service prévu | Le format décrit notamment agences, arrêts, lignes, courses, heures aux arrêts et calendriers de service. GTFS : référence Schedule ↗Consulté le | Un horaire planifié ne prouve pas la position actuelle d’un véhicule ni la disponibilité d’un billet. | Le calendrier couvre-t-il la date recherchée et les exceptions locales ? |
GTFS Realtime Compléter le service avec des mises à jour | Le format prévoit des mises à jour de courses, des positions de véhicules et des alertes de service, reliées au réseau décrit. GTFS : référence Realtime ↗Consulté le | Un flux peut ne couvrir qu’une partie de ces objets. L’existence du standard ne garantit pas leur présence chez l’opérateur. | Quels objets sont publiés et comment détecter une information devenue trop ancienne ? |
GBFS Décrire la mobilité partagée disponible | GBFS organise des informations publiques en lecture sur les services de mobilité partagée, leurs stations et leur disponibilité. GBFS : documentation officielle ↗Consulté le | Lire une disponibilité n’attribue pas un véhicule et ne réalise pas sa réservation. | Le service couvre-t-il stations, véhicules et zones utiles au trajet étudié ? |
Commencer par la question du voyageur
Pour organiser un trajet à une date future, le service prévu constitue une base. Pour accompagner un départ immédiat, une mise à jour peut apporter une information différente. Pour rejoindre une station de vélos, la présence d’une station ne suffit pas : l’utilisateur doit comprendre l’état pertinent et le moment où il a été observé.
Évitez de choisir un flux pour sa popularité. Décrivez d’abord la tâche, la date et le territoire, puis examinez les objets nécessaires. Une couverture partielle doit rester visible dans le parcours.
Rapprocher les identités et les dates
Conservez les identifiants utilisés par chaque source et documentez les correspondances. Un nom d’arrêt peut désigner plusieurs accès ou plusieurs objets. Le rapprochement doit éviter de rattacher une alerte ou une disponibilité au mauvais lieu.
Affichez le rôle de l’heure : prévu, mis à jour ou observé. Prévoyez un état lorsque la donnée récente manque, afin que l’interface ne présente pas une ancienne observation comme une garantie actuelle.
Séparer information et transaction
Une suggestion de trajet doit expliquer ses limites avant d’orienter le voyageur vers une réservation ou un déverrouillage. Le service transactionnel possède ses propres droits, conditions et résultats. Ne déduisez pas leur existence du seul accès à un flux public.
La recette doit couvrir une journée sans service, une perturbation et un flux indisponible. Les réponses servent à décider ce que l’interface peut annoncer et quel contact ou alternative elle peut proposer.
Expliquer ce qui reste disponible sans le flux
Scénario de préparation : le temps réel disparaît mais les horaires planifiés restent accessibles. Décidez les messages de repli pour retards, alertes et disponibilité vélo. Un ancien instant de collecte ne doit pas être présenté comme un état courant.
Conservez la source de chaque type de donnée et une règle d’arrêt d’affichage. Testez un parcours pendant l’indisponibilité : l’utilisateur doit comprendre la date de l’information et retrouver le canal opérateur utile.
Choisir selon le besoin
Trois situations pour cadrer le bon périmètre
Le trajet préparé avant le séjour et l’information montrée au départ ne demandent pas la même fraîcheur. Définissez ce que le visiteur peut décider à partir de la donnée : planifier, vérifier une perturbation ou chercher un véhicule disponible près de lui.
Les situations ci-dessous sont fictives. Elles servent à comparer un périmètre de travail et les preuves nécessaires ; elles ne décrivent pas les conditions d’une offre fournisseur.
Préparation de séjour
Cas fictif : le visiteur prépare un trajet pour le 15 juin, tandis que le calendrier reçu s’arrête au 31 mai. Le flux permet de lire lignes et arrêts mais ne couvre pas encore la date demandée.
Avant de retenir ce périmètre : Obtenir la couverture de juin et ses exceptions avant d’annoncer le trajet comme prévu. Le nombre de lignes décrites ne répond pas à la question de validité du service à cette date.
Information pendant le déplacement
Cas fictif : un départ est prévu à 16 h et une mise à jour reçue à 15 h 40 estime le passage à 16 h 08. La règle locale de fraîcheur doit encore être confirmée.
Avant de retenir ce périmètre : Conserver horaire prévu, estimation et moment d’observation. Les huit minutes d’écart ne prouvent pas la fiabilité actuelle du flux ; demander la règle de donnée ancienne et le comportement si une mise à jour manque.
Accès à une station de vélos
Cas fictif : à l’observation, la station affiche quatre vélos utilisables et deux places de retour. Un groupe de cinq souhaite partir ensemble.
Avant de retenir ce périmètre : La lecture ne permet pas d’annoncer cinq vélos disponibles ni d’en attribuer quatre au groupe. Vérifier état de location, heure et alternative ; les places de retour ne s’ajoutent pas au nombre de vélos.
Arbitrer les contraintes et le coût de fonctionnement
Multiplier les flux peut enrichir l’interface mais ajoute des dépendances et états d’absence. Commencez par une couverture géographique utile et une politique de fraîcheur lisible. Une donnée plus récente sur quelques arrêts ne doit pas masquer l’absence de service sur le reste du parcours. Dans un cas fictif, le dernier état d’une station date de 10 h ; le visiteur consulte à 10 h 05. L’observation a cinq minutes, même si votre propre page vient de se recharger. Affichez l’heure de la source et appliquez le seuil convenu pour cet usage. Si le flux devient ancien, le parcours peut conserver l’information de localisation et le lien de l’opérateur, sans affirmer qu’un vélo ou une place reste disponible.
Points à clarifier avant la décision
- Le calendrier ne couvre pas la date du parcours et l’interface présente pourtant le service comme assuré.
- Une estimation ou une disponibilité ancienne est montrée sans origine temporelle ni traitement défini de l’information manquante.
Quatre cas pour rendre la comparaison vérifiable
Les nombres et situations ci-dessous sont fictifs, à adapter au périmètre proposé. Utilisez un environnement et des données de test autorisés. Conservez les réponses, les opérations manuelles et les points qui restent inconnus.
| Situation | Contrôle | Preuve utile |
|---|---|---|
| Une course prévue, un flux ancien | Cas fictif : départ prévu 10 h, dernière mise à jour reçue 9 h 30, consultation 9 h 58. Fixer le seuil de fraîcheur avec l’opérateur. | Horaire prévu et observation distingués ; flux périmé signalé selon le seuil convenu, sans inventer de retard. |
| Arrêt homonyme | Rattacher la mise à jour à l’objet et au lieu corrects. | Identifiants source et correspondance vérifiée. |
| Station vide | Cas fictif : station ouverte, 0 vélo utilisable et 5 places libres. Afficher séparément départ et possibilité de retour. | Aucune disponibilité de vélo déduite des places libres ; horodatage et périmètre visibles. |
| Vélo annoncé puis absent | Expliquer que la lecture du flux ne constitue pas une attribution. | Parcours d’information et résultat du service opérationnel, testés séparément. |
Consulter le registre de comparaison et préparer le contrôle d’accès API.
Questions fréquentes
GTFS permet-il d’acheter un billet ?
Ces flux décrivent le service et ses mises à jour. L’achat demande un service transactionnel et ses conditions propres.
Faut-il combiner les trois formats ?
Seulement si le parcours utilise leurs objets respectifs. Une intégration plus large sans usage défini ajoute des correspondances à maintenir.
Un standard garantit-il la couverture d’une ville ?
Non. Vérifiez l’émetteur, le périmètre, les objets publiés et les dates réellement disponibles.
Faut-il toujours ajouter un flux temps réel ?
Le temps réel sert une décision lorsque son objet, sa couverture et sa fraîcheur sont connus. Pour une date future, vérifiez d’abord le service prévu et les exceptions. Pendant le trajet, gardez l’horaire de référence, l’estimation et leur source ; une ancienne observation ne doit pas devenir une promesse de passage ou de véhicule disponible.
Documentation et application
Les précisions utiles des sources
GTFS : heure de service, fuseau et heure tarifaire
Une même notation horaire ne se lit pas de la même façon dans tous les fichiers GTFS. Le type de fichier fait partie de l’information à conserver.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| stop_times.txt | Les horaires d’arrivée et de départ peuvent dépasser 24:00:00 pour prolonger une journée de service après minuit. | Rattacher le trajet à sa date de service avant de convertir l’heure civile. |
| Fuseau des horaires | arrival_time et departure_time utilisent agency.agency_timezone, et non stops.stop_timezone. | Ne pas recalculer chaque arrêt à partir de son seul fuseau local. |
| timeframes.txt | Les heures des tranches tarifaires ne peuvent pas dépasser 24:00:00 ; une fin absente correspond à 24:00:00. | Ne pas appliquer à une règle tarifaire la tolérance propre aux horaires de course. |
Ces règles décrivent le format planifié. Elles n’attestent ni la circulation du jour ni la disponibilité d’une place à vendre.
GTFS Schedule — référence, stop_times et timeframes · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Examiner le dossier et son périmètre.
GTFS Realtime : arrêt desservi, arrêt sauté ou information absente
Le statut d’un arrêt décrit sa relation au service prévu. Il ne se réduit pas à une valeur de retard.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| SCHEDULED | L’arrêt suit la séquence prévue, sans garantir que les heures prévues seront respectées. | Ne pas afficher automatiquement « à l’heure » à partir de ce seul statut. |
| SKIPPED | Le véhicule ne dessert pas cet arrêt ; ce statut ne se propage pas automatiquement aux arrêts suivants. | Ne pas annuler tout le parcours à partir d’un seul arrêt sauté. |
| NO_DATA | Aucune prévision horaire temps réel n’est disponible à partir de ce point, jusqu’à une information ultérieure qui la remplace. | Conserver la distinction entre horaire planifié et horaire prévu en temps réel. |
| Retard | delay est exprimé en secondes et peut être positif, nul ou négatif ; les prévisions time et delay sont interdites sous NO_DATA. | Ne pas remplacer une information absente par un retard nul. |
Lecture des arrêts et des horaires GTFS Realtime. Certains autres champs de la spécification restent expérimentaux ; ce tableau ne valide ni la circulation ni une correspondance.
GTFS Realtime — StopTimeUpdate et ScheduleRelationship · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
Paris : le titre de transport détermine les correspondances possibles
Un changement de gare peut combiner plusieurs réseaux urbains. Le trajet indiqué sur une carte ne prouve pas que tous les déplacements sont couverts par le même ticket.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Métro, train et RER | Le ticket Métro-Train-RER permet les correspondances entre ces modes en restant dans la zone contrôlée et en suivant les cheminements indiqués. | Précisez le trajet depuis le quai d’arrivée jusqu’au réseau urbain, puis jusqu’à la gare de départ. |
| Bus et tramway | Le ticket Bus-Tram couvre les correspondances entre bus, tramway et Câble. Un même ticket unitaire ne permet pas de combiner ces modes avec métro, train ou RER. | Ne présentez pas un changement métro–bus comme automatiquement couvert par le ticket Métro-Train-RER. |
| Sortie et nouvelle entrée | En règle générale, sortir du réseau puis entrer à nouveau consomme un autre titre. Certaines correspondances signalées par la voie publique font exception. | Suivez la signalétique de correspondance ; une sortie improvisée vers la rue ne constitue pas cette exception. |
Règles RATP consultées le 22 octobre 2026 pour ces tickets unitaires. Les forfaits Navigo et Navigo Liberté + ont un fonctionnement distinct ; vérifier aussi le titre, le parcours et les conditions du jour.
RATP — règles de correspondance · mise à jour par la source le 27/08/2026 · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
GBFS 3.0 : croiser les quantités d’une station avec ses autorisations de retrait et de retour
Un compteur de vélos ou de places libres ne suffit pas à décrire un service utilisable. Pour une station de mobilité partagée, GBFS sépare les quantités physiques, les opérations autorisées et la date de remontée de son état.
| Point documenté | Ce que la source précise | Conséquence pour votre contrôle |
|---|---|---|
| Véhicules et retrait | num_vehicles_available compte les véhicules fonctionnels présents. Avec is_renting à false, ils ne sont pas actuellement proposés au retrait. | Relisez les deux champs ensemble ; un nombre positif ne suffit pas pour afficher « vélos à louer maintenant ». |
| Places et retour | num_docks_available compte les points d’attache fonctionnels disponibles. is_returning peut rester true même si la station est pleine. | Croisez quantité et autorisation. « Retours autorisés » ne signifie pas qu’une place libre est déclarée. |
| Types de véhicules et d’attaches | vehicle_types_available détaille les types disponibles ; vehicle_docks_available précise les compatibilités lorsque toutes les attaches n’acceptent pas les mêmes types. | Vérifiez le type recherché avant de reprendre un total de station comme une capacité compatible. |
| Date du flux et date de la station | last_reported correspond à la dernière remontée de la station vers le système de l’opérateur ; last_updated décrit la connaissance de l’état au niveau du flux. | Conservez la date propre à la station pour apprécier son état. Une mise à jour du flux ne démontre pas une nouvelle remontée de chaque station. |
| Actualisation et ttl | La référence demande des données proches du temps réel, sans plus de cinq minutes de retard. ttl exprime en secondes le délai avant nouvelle mise à jour ; 0 signifie que les données doivent toujours être rafraîchies. | Ne transformez pas ttl égal à 0 en absence de vélo ou de place, et ne prenez pas cinq minutes comme une garantie de disponibilité à l’arrivée. |
| Station virtuelle et compteur absent | num_docks_available est requis sauf pour une station à capacité d’accueil illimitée, par exemple certaines stations virtuelles. Un champ absent n’est pas automatiquement un zéro. | Retrouvez le type de station avant de conclure à une station pleine. |
| Installation physique | is_installed indique si la station est installée. false peut décrire une station prévue ou du matériel retiré hors saison. | La présence d’une station dans les fichiers ne suffit pas à en faire un point utilisable. |
Deux compteurs à lire avec leur état de service
Extraits fictifs limités à quelques champs GBFS 3.0, sans flux réel interrogé.
Cinq véhicules présents, retraits fermés
Une station fictive installée déclare cinq véhicules fonctionnels, mais les retraits sont désactivés.
is_installed : true
num_vehicles_available : 5
is_renting : falseLecture du cas. La quantité physique ne permet pas d’annoncer cinq véhicules actuellement proposés au retrait. Affichez la fermeture des retraits et vérifiez l’état complet avant toute recommandation de parcours.
Les retours sont autorisés, mais aucune attache n’est libre
Une station fictive à attaches limitées accepte le principe des retours tout en déclarant zéro place disponible.
is_installed : true
num_docks_available : 0
is_returning : trueLecture du cas. Aucune place libre n’est déclarée dans cet état. Ne traduisez pas l’autorisation de retour par « station disponible » ; cherchez une autre station compatible et relisez la fraîcheur de son état.
Lecture de la version 3.0 publiée par MobilityData, consultée le 31 octobre 2026. Le lecteur de quantités suppose une station installée avec des attaches en nombre limité ; la chronologie compare des horodatages fictifs. Aucune disponibilité réelle, compatibilité, tarification ou accessibilité du trajet n’est vérifiée par ces exercices.
MobilityData — GBFS, spécification version 3.0, station_status.json · consultée le . Les contrôles proposés sont une lecture éditoriale de cette référence.
GBFS 3.0 — référence courante, fraîcheur et format de sortie · consultée le 31/10/2026