Dades i API
Tot el que veus al mapa està disponible com a dades obertes, sense registre i sense clau.
API pública
Guia completa amb paràmetres, exemples i condicions a API per a desenvolupadors.
| Ruta | Què retorna |
|---|---|
/api/v1/trains | Trens en circulació (GeoJSON), amb l'estat de cada font. |
/api/v1/trains/{id} | Un tren amb el seu recorregut recent (fins a 80 posicions) i, en llarga i mitjana distància, les seves parades amb hora programada i estimada. |
/api/v1/stations/{código} | Trens de les dues properes hores en una estació: els que circulen, amb hora estimada, i els que encara no han sortit, segons l'horari d'avui. |
/api/v1/horario/numero/{número}?nucleo= | Horari d'avui d'un número de tren (calendari GTFS): parades, hores i si Renfe el dona per cancel·lat. |
/api/v1/puntualidad?dias=7 | Puntualitat diària per línia i producte (últim retard publicat de cada tren). |
/api/v1/trains/numero/{número}?nucleo= | El mateix detall cercant per número comercial; nucleo distingeix Cercanías de ciutats diferents. |
/api/v1/stations | Estacions (GeoJSON). |
/api/v1/lines | Línies de Cercanías amb el seu recorregut i el seu color oficial (GeoJSON, simplificat a ~15 m). |
/api/v1/alerts | Avisos actius de Cercanías. |
/api/v1/cancellations | Trens cancel·lats segons Renfe. |
/api/v1/status | Resum: trens, puntualitat i salut de les fonts. |
/api/v1/lineas | Línies amb pàgina pròpia: Cercanías, Rodalies, FGC i Metro Bilbao. |
/api/v1/lines/{núcleo}/{línea} | Una línia: estacions en ordre, trens ara i, a Renfe, avisos, cancel·lacions i puntualitat de 30 dies. |
/api/v1/informe/{aaaa-mm}?nucleo= | Informe mensual de puntualitat i cancel·lacions. |
/api/v1/historial/dias | Dies del registre històric que es poden descarregar. |
/api/v1/historial/{aaaa-mm-dd}.csv.gz | Un dia complet del registre històric (hora UTC). |
/api/v1/feeds/avisos.xml | Avisos de Cercanías en RSS. |
/api/v1/feeds/cancelaciones.xml | Trens cancel·lats en RSS. |
/api/docs | Documentació interactiva (OpenAPI). |
Exemple: curl -s --compressed https://trenes.valfiguer.com/api/v1/trains
Cada tren porta reported_at (hora de la posició), age_s (antiguitat en generar la resposta), stale i flags, que expliquen qualsevol correcció aplicada. La resposta es regenera cada 15–20 s: consultar-la més d'un cop cada 10 s no dona dades més noves.
Fonts
Només fem servir conjunts publicats oficialment com a dades obertes: Renfe Data, FGC Dades Obertes i Metro Bilbao i Euskotren a través de MovEuskadi, tots amb llicència CC BY 4.0. No reutilitzem dades de webs o aplicacions que no estiguin publicades com a dades obertes.
| Dada | Origen | Consulta |
|---|---|---|
| Posicions AV/LD/MD | gtfsrt.renfe.com/vehicle_positions_LD.json | cada 15 s |
| Posicions Cercanías | gtfsrt.renfe.com/vehicle_positions.json | cada 20 s |
| Retards i cancel·lacions | gtfsrt.renfe.com/trip_updates(_LD).json | cada 30 s |
| Avisos Cercanías | gtfsrt.renfe.com/alerts.json | cada 60 s |
| Horaris (GTFS) | ssl.renfe.com · Fichero_AV_LD y Fichero_CER | cada 12 h |
| Posicions FGC | dadesobertes.fgc.cat · posicionament-dels-trens | cada 20 s |
| Línies i estacions FGC | dadesobertes.fgc.cat · gtfs_routes, codigo-estaciones | cada 24 h |
| Posicions Metro Bilbao | opendata.euskadi.eus · gtfsrt_metro_bilbao_vehicle_positions.pb | cada 20 s |
| Horaris Metro Bilbao (GTFS) | opendata.euskadi.eus · gtfs_metro_bilbao.zip | cada 24 h |
| Posicions Euskotren (només si estan al dia: si el feed s'atura, no es mostren) | opendata.euskadi.eus · gtfsrt_euskotren_vehicle_positions.pb | cada 20 s |
| Horaris i línies Euskotren (GTFS) | opendata.euskadi.eus · gtfs_euskotren.zip | cada 24 h |
| Accessibilitat d'estacions (wheelchair_boarding) | ssl.renfe.com · stops.txt de Fichero_AV_LD y Fichero_CER | cada 12 h |
Llicència i atribució
Pots reutilitzar aquestes dades amb la mateixa llicència CC BY 4.0, citant: «Font: Renfe Data (data.renfe.com), CC BY 4.0. Dades normalitzades per trenes.valfiguer.com (Valfiguer)». La nostra normalització corregeix defectes coneguts de les fonts i ho indica a flags; si necessites la dada tal com la publica Renfe, fes servir les URL originals.
Registre històric
Guardem cada canvi de posició, estat o retard en fitxers CSV comprimits (columnes: received_at, reported_at, train_id, source, trip_id, lat, lon, status, stop_id, delay_s, speed_kmh, flags). Pots descarregar cada dia complet, en hora UTC, com un únic .csv.gz. A dins, cada hora comença amb la seva pròpia fila de capçalera: salta-la quan es repeteixi. El dia en curs no s'ofereix fins que acaba. Es conserven 90 dies.
Llicència CC BY 4.0: els pots fer servir per al que vulguis citant «Font: Renfe Data (data.renfe.com), CC BY 4.0. Dades normalitzades per trenes.valfiguer.com (Valfiguer)». No hi són tots els trens: només els que publiquen la seva posició.
| Dia (UTC) | Hores | Mida | Descàrrega |
|---|---|---|---|
| ds., 31 d’oct. 2026 | 1 (incomplet) | 0 MB | 2026-10-31.csv.gz |
Si necessites més dies per a una investigació o un reportatge, escriu-nos a info@valfiguer.com.