File size: 2,734 Bytes
1b7f3f7
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
# API Horaires SNCF — GTFS

API REST FastAPI pour consulter les horaires des prochains trains depuis les données GTFS SNCF.

## Installation

```bash
pip install fastapi uvicorn pandas
```

## Démarrage rapide

### 1. Construire la base SQLite
```bash
# Placer les fichiers GTFS dans ./uploads/
python build_db.py --uploads-dir ./uploads --db gtfs_sncf.db
```

### 2. Lancer l'API
```bash
uvicorn main:app --reload
# → http://localhost:8013
# → http://localhost:8013/docs  (Swagger UI interactif)
```

### Variable d'environnement
```bash
export DB_PATH=/chemin/vers/gtfs_sncf.db
uvicorn main:app --reload
```

---

## Endpoints

| Méthode | URL | Description |
|---------|-----|-------------|
| GET | `/` | Index des endpoints |
| GET | `/health` | Statut + stats tables |
| GET | `/stops/search?q=Paris` | Chercher une gare |
| GET | `/stops/{stop_id}` | Détails d'un arrêt |
| GET | `/next-trains?stop_id=...` | Prochains trains depuis une gare |
| GET | `/trains?from_stop_id=...&to_stop_id=...` | Trains directs entre 2 gares |
| GET | `/routes?q=TGV` | Rechercher une ligne |
| GET | `/routes/{route_id}/stops` | Arrêts d'une ligne |

---

## Exemple d'utilisation

```bash
# 1. Trouver l'identifiant de Lyon Part Dieu
curl "http://localhost:8013/stops/search?q=Lyon+Part+Dieu"
# → stop_id: "StopPoint:OCETrain TER-87723197"

# 2. Prochains trains aujourd'hui à partir de maintenant
curl "http://localhost:8013/next-trains?stop_id=StopPoint:OCETrain%20TER-87723197"

# 3. Trains directs Lyon → Paris demain matin
curl "http://localhost:8013/trains?from_stop_id=StopPoint:OCETGV%20INOUI-87723197&to_stop_id=StopPoint:OCETGV%20INOUI-87113001&date=20260219&time=07:00:00"
```

---

## Structure des fichiers GTFS attendus

```
uploads/
├── agency.txt          — Opérateurs (SNCF Voyageurs…)
├── routes.csv          — Lignes
├── trips.txt           — Trajets / courses
├── stop_times2.csv     — Horaires arrêt par arrêt (sep=;)
├── stops.csv           — Points d'arrêt
├── calendar_dates.txt  — Dates de circulation
├── transfers.txt       — Correspondances
└── feed_info.txt       — Métadonnées du flux
```

---

## Notes techniques

- Les `stop_id` SNCF contiennent le type de train : `StopPoint:OCETrain TER-87723197`, `StopPoint:OCETGV INOUI-87723197`, etc. Un même arrêt physique peut avoir plusieurs `stop_id` selon le type de train.
- Le champ `departure_time` peut dépasser `24:00:00` (ex : `25:30:00`) pour les trains de nuit — c'est du GTFS standard.
- La table `calendar_dates` gère uniquement les exceptions (exception_type=1 = service actif, 2 = supprimé).

## Requirements
```
fastapi>=0.110
uvicorn>=0.29
pandas>=2.0
```