Datos e API
Todo o que ves no mapa está dispoñible como datos abertos, sen rexistro e sen clave.
API pública
Guía completa con parámetros, exemplos e condicións en API para desenvolvedores.
| Ruta | Que devolve |
|---|---|
/api/v1/trains | Trens en circulación (GeoJSON), co estado de cada fonte. |
/api/v1/trains/{id} | Un tren co seu percorrido recente (ata 80 posicións) e, en longa e media distancia, as súas paradas con hora programada e estimada. |
/api/v1/stations/{código} | Trens das próximas dúas horas nunha estación: os que circulan, con hora estimada, e os que aínda non saíron, segundo o horario de hoxe. |
/api/v1/horario/numero/{número}?nucleo= | Horario de hoxe dun número de tren (calendario GTFS): paradas, horas e se Renfe o dá por cancelado. |
/api/v1/puntualidad?dias=7 | Puntualidade diaria por liña e produto (último atraso publicado de cada tren). |
/api/v1/trains/numero/{número}?nucleo= | O mesmo detalle buscando polo número comercial; nucleo distingue Cercanías de distintas cidades. |
/api/v1/stations | Estacións (GeoJSON). |
/api/v1/lines | Liñas de Cercanías co seu percorrido e a súa cor oficial (GeoJSON, simplificado a ~15 m). |
/api/v1/alerts | Avisos activos de Cercanías. |
/api/v1/cancellations | Trens cancelados segundo Renfe. |
/api/v1/status | Resumo: trens, puntualidade e saúde das fontes. |
/api/v1/lineas | Liñas con páxina propia: Cercanías, Rodalies, FGC e Metro Bilbao. |
/api/v1/lines/{núcleo}/{línea} | Unha liña: estacións en orde, trens agora e, en Renfe, avisos, cancelacións e puntualidade de 30 días. |
/api/v1/informe/{aaaa-mm}?nucleo= | Informe mensual de puntualidade e cancelacións. |
/api/v1/historial/dias | Días do rexistro histórico que se poden descargar. |
/api/v1/historial/{aaaa-mm-dd}.csv.gz | Un día completo do rexistro histórico (hora UTC). |
/api/v1/feeds/avisos.xml | Avisos de Cercanías en RSS. |
/api/v1/feeds/cancelaciones.xml | Trens cancelados en RSS. |
/api/docs | Documentación interactiva (OpenAPI). |
Exemplo: curl -s --compressed https://trenes.valfiguer.com/api/v1/trains
Cada tren leva reported_at (hora da posición), age_s (antigüidade ao xerar a resposta), stale e flags, que explican calquera corrección aplicada. A resposta rexenérase cada 15–20 s: consultar máis dunha vez cada 10 s non dá datos máis novos.
Fontes
Só usamos conxuntos publicados oficialmente como datos abertos: Renfe Data, FGC Dades Obertes e Metro Bilbao e Euskotren a través de MovEuskadi, todos baixo licenza CC BY 4.0. Non reutilizamos datos de webs ou aplicacións que non estean publicados como datos abertos.
| Dato | Orixe | Consulta |
|---|---|---|
| Posicións AV/LD/MD | gtfsrt.renfe.com/vehicle_positions_LD.json | cada 15 s |
| Posicións Cercanías | gtfsrt.renfe.com/vehicle_positions.json | cada 20 s |
| Atrasos e cancelacións | gtfsrt.renfe.com/trip_updates(_LD).json | cada 30 s |
| Avisos Cercanías | gtfsrt.renfe.com/alerts.json | cada 60 s |
| Horarios (GTFS) | ssl.renfe.com · Fichero_AV_LD y Fichero_CER | cada 12 h |
| Posicións FGC | dadesobertes.fgc.cat · posicionament-dels-trens | cada 20 s |
| Liñas e estacións FGC | dadesobertes.fgc.cat · gtfs_routes, codigo-estaciones | cada 24 h |
| Posicións Metro Bilbao | opendata.euskadi.eus · gtfsrt_metro_bilbao_vehicle_positions.pb | cada 20 s |
| Horarios Metro Bilbao (GTFS) | opendata.euskadi.eus · gtfs_metro_bilbao.zip | cada 24 h |
| Posicións Euskotren (só se están ao día: se o feed se para, non se mostran) | opendata.euskadi.eus · gtfsrt_euskotren_vehicle_positions.pb | cada 20 s |
| Horarios e liñas Euskotren (GTFS) | opendata.euskadi.eus · gtfs_euskotren.zip | cada 24 h |
| Accesibilidade de estacións (wheelchair_boarding) | ssl.renfe.com · stops.txt de Fichero_AV_LD y Fichero_CER | cada 12 h |
Licenza e atribución
Podes reutilizar estes datos coa mesma licenza CC BY 4.0, citando: «Fonte: Renfe Data (data.renfe.com), CC BY 4.0. Datos normalizados por trenes.valfiguer.com (Valfiguer)». A nosa normalización corrixe defectos coñecidos das fontes e indícao en flags; se necesitas o dato tal como o publica Renfe, usa os URL orixinais.
Rexistro histórico
Gardamos cada cambio de posición, estado ou atraso en ficheiros CSV comprimidos (columnas: received_at, reported_at, train_id, source, trip_id, lat, lon, status, stop_id, delay_s, speed_kmh, flags). Podes descargar cada día completo, en hora UTC, como un único .csv.gz. Dentro, cada hora comeza coa súa propia fila de cabeceira: sáltaa cando se repita. O día en curso non se ofrece ata que remata. Consérvanse 90 días.
Licenza CC BY 4.0: podes usalos para o que queiras citando «Fonte: Renfe Data (data.renfe.com), CC BY 4.0. Datos normalizados por trenes.valfiguer.com (Valfiguer)». Non están todos os trens: só os que publican a súa posición.
| Día (UTC) | Horas | Tamaño | Descarga |
|---|---|---|---|
| sáb. 31 out. 2026 | 1 (incompleto) | 0 MB | 2026-10-31.csv.gz |
Se necesitas máis días para unha investigación ou unha reportaxe, escríbenos a info@valfiguer.com.