# Le format GTFS expliqué : comment les horaires deviennent des données

> GTFS expliqué simplement : les fichiers stops, routes, trips, stop_times et calendar, comment ils se relient, le GTFS-Realtime, et les horaires publiés par IDFM.

Publié le 9 novembre 2026 · Par Yanis Bourdieu (https://www.wimt.fr/auteurs/yanis-bourdieu/) · Données et applis (https://www.wimt.fr/donnees/)

URL : https://www.wimt.fr/donnees/format-gtfs/
Wimt — Où est mon train ? Les RER et le Transilien au quotidien — https://www.wimt.fr/

## À retenir avant de monter

- Un GTFS est une archive ZIP de fichiers texte au format CSV qui décrit l'offre prévue d'un réseau : arrêts, lignes, trajets, heures de passage, jours de circulation.
- Les fichiers se relient par des identifiants : stop_times.txt renvoie à trips.txt et à stops.txt, trips.txt à routes.txt et au calendrier.
- Le format est né en 2005 d'une collaboration entre Google et TriMet, le réseau de Portland, et a ensuite été renommé General Transit Feed Specification.
- Le GTFS ne contient pas le temps réel : retards et suppressions passent par le GTFS-Realtime ou, en Île-de-France, par les API SIRI Lite du portail PRIM.

Le GTFS, pour General Transit Feed Specification, est le format dans lequel la plupart des réseaux de transport publient leurs horaires prévus. Concrètement, c'est une archive ZIP qui contient des fichiers texte, un par type d'information : les arrêts, les lignes, les trajets, les heures de passage, les jours de circulation. Chaque fichier ressemble à un tableur exporté en CSV, et les fichiers se répondent par des identifiants.

Île-de-France Mobilités publie le GTFS de toute la région sur son portail PRIM, et c'est avec ce fichier que j'ai construit mes premiers tableaux d'horaires. Je décris ici comment il est organisé, comment retrouver les départs d'une gare à la main, et où s'arrête ce que ce format sait dire.

## D'où vient le format

Le GTFS est né en 2005 d'une collaboration entre Google et TriMet, le réseau de transport de Portland, dans l'Oregon. Le premier calculateur d'itinéraires de Google en transports en commun a été lancé en décembre 2005, avec TriMet comme seul réseau pendant la plus grande partie de la première année, selon [l'article Wikipédia consacré au GTFS](https://en.wikipedia.org/wiki/GTFS), qui s'appuie sur les récits des deux partenaires.

Le format s'appelait alors Google Transit Feed Specification. Il a été renommé General Transit Feed Specification quand il est devenu un standard ouvert, utilisé bien au-delà de Google ; les sources hésitent entre 2009 et 2010 pour la date du changement. Sa documentation de référence est aujourd'hui tenue par MobilityData, une organisation à but non lucratif, sur [gtfs.org](https://gtfs.org/).

## Les fichiers d'un GTFS

La spécification « GTFS Schedule » liste une trentaine de fichiers possibles. Une poignée suffit pour comprendre l'essentiel.

| Fichier | Ce qu'il décrit | Statut dans la spécification |
|---|---|---|
| agency.txt | Les exploitants dont le service figure dans le jeu | Obligatoire |
| stops.txt | Les arrêts, les quais et les gares, avec leurs coordonnées | Requis, sauf cas particulier des zones de transport à la demande |
| routes.txt | Les lignes, telles que présentées aux voyageurs | Obligatoire |
| trips.txt | Les trajets : un train précis, un jour type, dans un sens | Obligatoire |
| stop_times.txt | Les heures d'arrivée et de départ de chaque trajet à chaque arrêt | Obligatoire |
| calendar.txt | Les jours de la semaine où un service circule, entre deux dates | Requis, sauf si tout est dans calendar_dates.txt |
| calendar_dates.txt | Les exceptions : jours ajoutés ou retirés | Requis si calendar.txt est absent |

Les statuts viennent de la [référence GTFS publiée sur le dépôt de Google](https://github.com/google/transit/blob/master/gtfs/spec/en/reference.md), reprise sur gtfs.org. D'anciens guides présentent certains fichiers comme facultatifs : la spécification en vigueur fait foi.

### stops.txt : les arrêts, les quais, les gares

Chaque ligne de stops.txt a un identifiant, un nom, une latitude et une longitude. Un champ précise de quel type d'objet il s'agit : un point d'arrêt où le véhicule s'arrête, ou une station qui regroupe plusieurs points d'arrêt. Une grande gare apparaît donc comme une station « parente », et ses quais comme des arrêts rattachés à elle.

C'est le premier piège que j'ai rencontré. En cherchant les départs d'une gare avec l'identifiant de la station, je n'obtenais rien : les horaires sont attachés aux quais, pas à la gare.

### routes.txt et trips.txt : la ligne et le train

Une « route », dans le vocabulaire GTFS, c'est une ligne au sens commercial : le RER B, la ligne H, un bus. Un « trip », c'est un trajet précis : une suite d'au moins deux arrêts, parcourue à une heure donnée. Chaque trip renvoie à sa route par un identifiant, et à un service, c'est-à-dire à un ensemble de jours de circulation.

### stop_times.txt : le gros fichier

C'est le fichier le plus volumineux, et de loin. Il contient une ligne par passage d'un trajet à un arrêt : identifiant du trip, identifiant de l'arrêt, heure d'arrivée, heure de départ, rang dans le trajet. Le champ stop_id de stop_times.txt renvoie à stop_id dans stops.txt, comme le précise la référence.

Un détail surprend la première fois : un trajet qui commence le soir et finit après minuit peut afficher des heures comme 25:10:00. La spécification prévoit qu'on compte les heures à partir du début de la journée de service, sans repasser à zéro à minuit.

### calendar.txt et calendar_dates.txt : quels jours

calendar.txt décrit des régularités : ce service circule du lundi au vendredi, entre telle date et telle date. calendar_dates.txt ajoute ou retire des jours précis, pour un jour férié ou des travaux. Un réseau peut aussi tout décrire dans calendar_dates.txt, jour par jour, et se passer de calendar.txt.

**Les identifiants, colonne vertébrale du format**

Aucun fichier d'un GTFS ne se lit seul. stop_times.txt dit « le trip 123 passe à l'arrêt 456 à 8 h 12 » ; on va dans trips.txt pour savoir que le trip 123 appartient à telle ligne et circule selon tel service, puis dans le calendrier pour savoir quels jours, puis dans stops.txt pour connaître le nom de l'arrêt 456. Un tableur suffit pour suivre ces liens sur un petit réseau. Sur celui de l'Île-de-France, un script ou une base de données devient vite plus pratique.

## Exemple : retrouver les départs d'une gare

Voici l'ordre que je suis pour reconstituer, à partir du seul GTFS, la liste des trains prévus dans une gare un jour donné.

1. Chercher la gare dans stops.txt et noter l'identifiant de la station.
2. Lister les quais rattachés à cette station, grâce au champ qui désigne la station parente.
3. Dans stop_times.txt, garder les lignes dont l'arrêt est l'un de ces quais.
4. Pour chaque trajet trouvé, lire dans trips.txt sa ligne et son service.
5. Vérifier dans calendar.txt et calendar_dates.txt que le service circule le jour voulu.
6. Trier les passages restants par heure de départ.

On obtient l'équivalent de la fiche horaire théorique de la gare. Sur une ligne à branches comme la [ligne H](/lignes/ligne-h/), on peut ensuite regarder le dernier arrêt de chaque trip pour connaître sa destination.

## Le GTFS d'Île-de-France Mobilités

IDFM publie son GTFS sur le portail [PRIM](https://prim.iledefrance-mobilites.fr/), sous licence ODbL. D'après la fiche du jeu de données « Horaires prévus sur les lignes de transport en commun d'Île-de-France », le fichier couvre l'offre prévue sur les 30 jours suivants pour l'ensemble des lignes de la région, tous exploitants confondus, et il est mis à jour plusieurs fois par jour. Une ancienne documentation de 2022 décrivait un horizon et un rythme différents : la fiche en ligne au moment du téléchargement est la seule référence fiable.

La même fiche signale une différence entre exploitants : les horaires de bus et de tramways de la RATP n'intègrent pas les adaptations liées aux travaux prévus, alors que ceux de la SNCF les incluent. Un même fichier peut donc être plus ou moins fidèle selon la ligne regardée.

Le reste de ce que publie IDFM, avec les licences et les conditions d'accès, est décrit dans [l'article sur les données ouvertes des transports franciliens](/donnees/open-data-transports-ile-de-france/). La rubrique [Données et applis](/donnees/) regroupe les autres articles sur le sujet.

## Ce que le GTFS ne dit pas

Le GTFS décrit ce qui est prévu. Il ne sait rien d'un retard, d'un train supprimé ce matin, d'un quai changé à la dernière minute.

### Le GTFS-Realtime

Pour le temps réel, la spécification a un format compagnon, le GTFS-Realtime. Selon la [présentation de Google](https://developers.google.com/transit/gtfs-realtime), il repose sur les Protocol Buffers, un format binaire compact, et définit trois types de flux : les mises à jour de trajets (retards, suppressions, itinéraires modifiés), les positions des véhicules, et les alertes de service. Ces flux s'appuient sur les identifiants du GTFS statique : un retard est attaché à un trip et à un arrêt déjà décrits.

### En Île-de-France, le temps réel passe par SIRI

Pour les prochains passages, IDFM diffuse surtout ses données au format SIRI Lite, une norme européenne, sur le même portail PRIM. Ce que ces API montrent, et la couverture encore partielle du réseau, sont détaillés dans [l'article sur le trafic en temps réel](/trafic/info-trafic-rer-temps-reel/).

### Les trous du calendrier

Un GTFS ne voit pas au-delà de son horizon. Un trajet de dans six semaines n'y figure pas encore, et des travaux décidés tard peuvent n'apparaître qu'à la mise à jour suivante. Quand mes tableaux affichent un train qui ne passera pas, c'est souvent là que je trouve l'explication.

C'est aussi ce qui rend le format si pratique : stable, lisible avec un simple éditeur de texte, et compris par tous les calculateurs d'itinéraires. La carte des RER qui a donné son nom à ce site, décrite dans [l'histoire de Where Is My Train](/donnees/where-is-my-train/), reposait déjà sur cette idée : partir d'un horaire publié pour en déduire où devrait être un train.

## Retrouver les départs d'une gare dans un GTFS

Les six étapes décrites dans l'article, mélangées. Remettez-les dans l'ordre.

Classez les étapes de la première à la dernière.

1. Chercher la gare dans stops.txt et noter l'identifiant de la station
2. Lister les quais rattachés à cette station
3. Garder dans stop_times.txt les passages à ces quais
4. Lire dans trips.txt la ligne et le service de chaque trajet
5. Vérifier dans calendar.txt et calendar_dates.txt que le service circule ce jour-là
6. Trier les passages restants par heure de départ

[Exemple : retrouver les départs d'une gare](https://www.wimt.fr/donnees/format-gtfs/#exemple-retrouver-les-departs-dune-gare)

Votre correspondance : [Ligne H du Transilien : une ligne à branches où la destination compte autant que l'heure](https://www.wimt.fr/lignes/ligne-h/)


## Questions de voyageurs

**Qu'est-ce que le format GTFS ?**

C'est un format standard de publication des horaires de transport en commun : une archive de fichiers texte qui décrit les arrêts, les lignes, les trajets, les heures de passage et les jours de circulation.

**Quels fichiers sont obligatoires dans un GTFS ?**

La spécification exige notamment agency.txt, routes.txt, trips.txt et stop_times.txt. stops.txt et calendar.txt sont requis dans la plupart des cas, avec des exceptions prévues par la spécification.

**Le GTFS donne-t-il les retards en temps réel ?**

Non. Le GTFS décrit l'offre prévue. Les retards et suppressions passent par un format compagnon, le GTFS-Realtime, ou par d'autres normes comme SIRI.

**Où télécharger le GTFS des transports d'Île-de-France ?**

Île-de-France Mobilités publie le sien sur son portail PRIM, sous licence ODbL, avec l'offre prévue sur l'ensemble des lignes de la région.
