Datuak eta APIa
Mapan ikusten duzun guztia datu ireki gisa dago eskuragarri, erregistrorik eta gakorik gabe.
API publikoa
Parametroak, adibideak eta baldintzak dituen gida osoa garatzaileentzako APIa orrian dago.
| Bidea | Zer itzultzen duen |
|---|---|
/api/v1/trains | Zirkulazioan dauden trenak (GeoJSON), iturri bakoitzaren egoerarekin. |
/api/v1/trains/{id} | Tren bat bere azken ibilbidearekin (80 kokapen arte) eta, distantzia luzean eta ertainean, bere geldialdiekin, ordu programatua eta aurreikusia barne. |
/api/v1/stations/{código} | Geltoki batean hurrengo bi orduetako trenak: zirkulatzen ari direnak, aurreikusitako orduarekin, eta oraindik irten ez direnak, gaurko ordutegiaren arabera. |
/api/v1/horario/numero/{número}?nucleo= | Tren-zenbaki baten gaurko ordutegia (GTFS egutegia): geldialdiak, orduak eta Renfek bertan behera utzitzat ematen duen ala ez. |
/api/v1/puntualidad?dias=7 | Eguneko puntualtasuna linea eta produktuaren arabera (tren bakoitzaren azken atzerapen argitaratua). |
/api/v1/trains/numero/{número}?nucleo= | Xehetasun bera, zenbaki komertzialaren bidez bilatuta; nucleo-k hiri desberdinetako Cercanías bereizten ditu. |
/api/v1/stations | Geltokiak (GeoJSON). |
/api/v1/lines | Cercanías-eko lineak, beren ibilbidearekin eta kolorearekin (GeoJSON, ~15 m-ra sinplifikatua). |
/api/v1/alerts | Cercanías-eko abisu aktiboak. |
/api/v1/cancellations | Renferen arabera bertan behera utzitako trenak. |
/api/v1/status | Laburpena: trenak, puntualtasuna eta iturrien osasuna. |
/api/v1/lineas | Orri propioa duten lineak: Cercanías, Rodalies, FGC eta Metro Bilbao. |
/api/v1/lines/{núcleo}/{línea} | Linea bat: geltokiak hurrenez hurren, oraingo trenak eta, Renferen kasuan, abisuak, bertan behera uzteak eta 30 eguneko puntualtasuna. |
/api/v1/informe/{aaaa-mm}?nucleo= | Puntualtasunari eta bertan behera uzteei buruzko hileko txostena. |
/api/v1/historial/dias | Deskarga daitezkeen erregistro historikoko egunak. |
/api/v1/historial/{aaaa-mm-dd}.csv.gz | Erregistro historikoko egun oso bat (UTC ordua). |
/api/v1/feeds/avisos.xml | Cercanías-eko abisuak RSS bidez. |
/api/v1/feeds/cancelaciones.xml | Bertan behera utzitako trenak RSS bidez. |
/api/docs | Dokumentazio interaktiboa (OpenAPI). |
Adibidea: curl -s --compressed https://trenes.valfiguer.com/api/v1/trains
Tren bakoitzak reported_at (kokapenaren ordua), age_s (erantzuna sortzean zuen adina), stale eta flags ditu; azken horrek aplikatutako zuzenketak azaltzen ditu. Erantzuna 15–20 s-tik behin sortzen da berriro: 10 s-tik behin baino maizago kontsultatzeak ez du datu berriagorik ematen.
Iturriak
Datu ireki gisa argitaratutako multzoak soilik erabiltzen ditugu: Renfe Data, FGC Dades Obertes eta Metro Bilbao eta Euskotren, MovEuskadi bidez, guztiak CC BY 4.0 lizentziapean. Ez dugu berrerabiltzen datu ireki gisa argitaratuta ez dauden webguneetako edo aplikazioetako daturik.
| Datua | Jatorria | Kontsulta |
|---|---|---|
| AV/LD/MD kokapenak | gtfsrt.renfe.com/vehicle_positions_LD.json | 15 s-tik behin |
| Cercanías-eko kokapenak | gtfsrt.renfe.com/vehicle_positions.json | 20 s-tik behin |
| Atzerapenak eta bertan behera uzteak | gtfsrt.renfe.com/trip_updates(_LD).json | 30 s-tik behin |
| Cercanías-eko abisuak | gtfsrt.renfe.com/alerts.json | 60 s-tik behin |
| Ordutegiak (GTFS) | ssl.renfe.com · Fichero_AV_LD y Fichero_CER | 12 h-tik behin |
| FGC kokapenak | dadesobertes.fgc.cat · posicionament-dels-trens | 20 s-tik behin |
| FGC lineak eta geltokiak | dadesobertes.fgc.cat · gtfs_routes, codigo-estaciones | 24 h-tik behin |
| Metro Bilbao kokapenak | opendata.euskadi.eus · gtfsrt_metro_bilbao_vehicle_positions.pb | 20 s-tik behin |
| Metro Bilbao ordutegiak (GTFS) | opendata.euskadi.eus · gtfs_metro_bilbao.zip | 24 h-tik behin |
| Euskotren kokapenak (eguneratuta badaude soilik: jarioa geldituz gero, ez dira erakusten) | opendata.euskadi.eus · gtfsrt_euskotren_vehicle_positions.pb | 20 s-tik behin |
| Euskotren ordutegiak eta lineak (GTFS) | opendata.euskadi.eus · gtfs_euskotren.zip | 24 h-tik behin |
| Geltokien irisgarritasuna (wheelchair_boarding) | ssl.renfe.com · stops.txt de Fichero_AV_LD y Fichero_CER | 12 h-tik behin |
Lizentzia eta aitortza
Datu hauek CC BY 4.0 lizentzia berarekin berrerabil ditzakezu, honela aipatuta: «Iturria: Renfe Data (data.renfe.com), CC BY 4.0. Datuak trenes.valfiguer.com-ek (Valfiguer) normalizatuak». Gure normalizazioak iturrien akats ezagunak zuzentzen ditu eta flags eremuan adierazten du; datua Renfek argitaratzen duen bezala behar baduzu, erabili jatorrizko URLak.
Erregistro historikoa
Kokapen-, egoera- edo atzerapen-aldaketa oro CSV fitxategi konprimatuetan gordetzen dugu (zutabeak: received_at, reported_at, train_id, source, trip_id, lat, lon, status, stop_id, delay_s, speed_kmh, flags). Egun oso bakoitza deskarga dezakezu, UTC orduan, .csv.gz bakar gisa. Barruan, ordu bakoitza bere goiburu-errenkadarekin hasten da: salta ezazu errepikatzen denean. Uneko eguna ez da eskaintzen amaitu arte. 90 egun gordetzen dira.
CC BY 4.0 lizentzia: nahi duzunerako erabil ditzakezu, honela aipatuta: «Iturria: Renfe Data (data.renfe.com), CC BY 4.0. Datuak trenes.valfiguer.com-ek (Valfiguer) normalizatuak». Ez daude tren guztiak: beren kokapena argitaratzen dutenak soilik.
| Eguna (UTC) | Orduak | Tamaina | Deskarga |
|---|---|---|---|
| lr. 2026 urr. 31 | 1 (osatu gabea) | 0 MB | 2026-10-31.csv.gz |
Ikerketa edo erreportaje baterako egun gehiago behar badituzu, idatzi iezaguzu info@valfiguer.com helbidera.