Toimijoiden tilanne
Seuraa ilmoitettuja rajapintoja, tunnista tarkistettavat puutteet ja avaa alkuperäinen data todentamista varten.
| Toimija ja ryhmä | Lähderajapinta | Formaatti | Kypsyys (Annex I) | Jatkokäyttö |
|---|
Datan laatu
Miten laatuväite syntyy, ja mitä nykyinen tilannekuva tosiasiassa todistaa.
Laatu tarvitsee lähdeaineistosta mitatun näytön
- Saatavuus: tee HTTP-pyyntö julkaistuun rajapintaan ja kirjaa aikaleima, vastauskoodi ja virhe.
- Rakenne: tunnista GTFS, GTFS RT, NeTEx, SIRI, GBFS tai muu formaatti; validoi oikealla skeemalla ja dokumentoi poikkeamat.
- Kattavuus: vertaa palvelukuvauksen alueita, reittejä ja pysäkkejä aineiston sisältöön sekä tunnisteisiin.
- Tuoreus: vertaa lähteen julkaisuaikaa, voimassaoloaikaa ja toteutuneita muutoksia useassa peräkkäisessä mittauksessa.
- Laatupäätelmä: näytä tarkistuksen ajankohta ja suora linkki raakadataan. Vasta sen jälkeen annetaan varsinainen laatuarvosana.
Mitä tilannekuva todistaa?
Katalogista voidaan nähdä ilmoitettu rajapinnan osoite ja formaattimerkintä sekä palvelukuvauksen julkaisuhetki. Julkaisuhetki ei kerro, milloin GTFS-, NeTEx- tai reaaliaikainen syöte viimeksi päivittyi.
Tämä testiversio ei lataa kaikkia ulkoisia syötteitä, joten yksittäisten toimijoiden tuoreus ja tekninen virheettömyys näkyvät tarkoituksella tilassa Ei mitattu.
Raakadatan osoite löytyy toimijakortista. Yksittäiset osoitteet voivat vaatia lisenssin, tunnuksen tai erillisen latausohjeen.
Jatkokäyttö
Näkyykö toimijan data oikeasti jossain matkatietopalvelussa, ja miten se voidaan todeta.
Milloin käyttö voidaan todeta?
- Yksilöi toimijan palvelu ja lähtörajapinta FINAPissa.
- Etsi sama lähde ja sen tunniste koontipalvelun aineistoluettelosta.
- Vertaile reittioppaan käyttämää syötettä, reitti- ja pysäkkitunnisteita sekä julkaisuhetkeä.
- Kirjaa havainto ja palvelun versio. Näkyvyys palvelussa ei yksin kerro käyttäjämäärää.
Nyt: matka.fi tarkistetaan automaattisesti joka yö. Sen reititin (Digitransit, finland) julkaisee listan lähdesyötteistään; niistä luetaan liikennöitsijät. Sama syöte = toimijan FINAPiin ilmoittama rajapinta on matka.fi:n lähdesyöte. Nimi täsmää = toimijan nimi (ilman yhtiömuotoa) löytyy syötteen liikennöitsijöistä. Muita palveluja ei vielä tarkisteta.
Avaa mahdolliset jatkopalvelut
- → Fintrafficin koontipalvelun aineistot
- → Fintraffic Matka, reittiopas
- → Digitransit, reititys ja aineistot
- → Digitransitin API-kuvaukset
Nämä ovat tarkastuskohteita. Pelkkä linkki ei tarkoita, että juuri valitsemasi toimijan data olisi palvelussa.
Raportit
Kypsyyden kehitys ajoittain, tietoluokkien saatavuus, nopeimmat parannukset ja yhteenveto toimivaltaisille viranomaisille.
Sääntely
Mihin pykäliin tilannekuvan sarakkeet nojaavat, ja mitä ne eivät todista.
Vaatimukset, määräajat ja muodot toimijaluokittain
Kaikki delegoidun asetuksen (EU) 2017/1926 liitteen I tietoluokat sellaisina kuin ne ovat asetuksella (EU) 2024/490 muutettuina: asetuksen sanamuoto, mihin mennessä tieto on annettava kansallisen yhteyspisteen (FINAP) kautta, asetuksen mukainen muoto ja mistä standardin tietokentästä tämä työkalu tulkitsee tiedon löytyvän. Valitse toimijaluokka, niin näet sen vaatimustasot (NAPCORE: xx pakollinen, x odotettu, o valinnainen) ja sitä koskevat määräajat.
Lievennykset ja poikkeukset aikatauluun
Pysäkkien ja asemien esteettömyys: miksi tiedon tuottaa pysäkin hallinnoija
Ladataan…
| Kysymys | Oikeusperusta | Työkalun havainto | Rajaus |
|---|---|---|---|
| Mitä dataa? | MMTIS-asetuksen liite I (ks. taulukko yllä); kansallisen lain toimivaltapykälät | Palvelulaji, ilmoitettu sisältö ja NeTEx-/GTFS-aineiston tietoluokat | Osa tietoluokista ei näy aikatauluaineistossa (ks. sarake "ei tarkisteta") |
| Mistä löytyy? | MMTIS-asetuksen kansallinen yhteyspiste | FINAPin julkaistu palvelukuvaus | NAPin ulkopuoliset velvolliset eivät näy |
| Rajapinta ja muoto? | Asetuksen 4 art. 1–2 kohta (NeTEx ym.) ja 5 art. 1–2 kohta (SIRI ym.) | NeTEx-/GTFS-aineisto haetaan ja analysoidaan; reaaliaikarajapinnasta tunnistetaan SIRI tai GTFS-RT | Sisältö- ja kattavuusanalyysi, ei XSD-validointia |
| Ajantasaisuus? | Asetuksen 6 art. (datan päivittäminen) ja 8 art. 1 kohta | Aineiston voimassaolo ja reaaliaikatiedon uusimman tietueen ikä | Julkaisuhetki ei ole datan päivityshetki |
| Jatkokäyttö? | MMTIS:n tavoite: matkatietopalvelujen tarjonta | Havainto matka.fi:n lähdesyötteissä (syöte tai liikennöitsijän nimi) | Vain matka.fi tarkistetaan; kaupunkien syötteissä näkyy usein tilaaja |
| Valvonta? | Kansallisen lain valvontapykälät | Todisteet valvontatyön tueksi | Sovellus ei tee viranomaispäätöksiä |
Liitteen I taulukon määräajat, muodot ja lievennykset on tarkistettu asetuksen (EU) 2024/490 suomenkielisestä tekstistä (4 ja 5 artikla). Tämän taulukon rivit ohjaavat valvontaa; lopullinen arvio tehdään säädöstekstin perusteella.
Lähteet ja menetelmä
Mistä esimerkkiaineisto tulisi tuotannossa, ja mitä se rajaa pois.
Analysoi NeTEx-paketti tai reaaliaikasanoma
Lähetä NeTEx-aineisto yhtenä tai useampana XML-tiedostona tai zip-pakettina (myös GTFS-zip käy). Aineisto pisteytetään samalla validaattorilla ja NAPCORE-jaottelulla kuin FINAPin rajapinnat, joten tulos on suoraan verrattavissa tilannekuvan tuloksiin. Tiedostoja ei tallenneta tilannekuvaan: ne poistetaan analyysin jälkeen ja tulos säilyy palvelimella tunnin. Yksittäinen tallennettu reaaliaikasanoma (SIRI-XML, SIRI Lite -JSON tai GTFS-RT) analysoidaan sisällöltään; asetuksen mukainen muoto on SIRI.
Miten poiminta toimisi
Tuotantoversiossa toimijalista poimitaan säännöllisesti FINAPin julkisesta palveluhausta. Samaan Y-tunnukseen kuuluvat palvelukuvaukset ryhmitellään yhden toimijan alle.
Poiminnassa säilytettäisiin vain toimijan nimi, Y-tunnus, palvelun nimi ja tunniste, tyyppi, kuvauksen julkaisuhetki, liikennemuoto sekä ilmoitetun datarajapinnan osoite ja muoto. Yhteyshenkilöitä ei kopioida. Excel-vientiin otetaan organisaation postiosoite (FINAPiin ilmoitettu tai PRH:n rekisteröimä) ja sähköposti palvelimen omasta yhteystietolistasta; toiminimiksi arvioiduilta toimijoilta yhteystietoja ei viedä.
Mistä tuotantoversio hakisi dataa
- → FINAPin palvelukatalogi
- → VACO — validointi- ja muunnospalvelu
- → MMTIS-asetuksen konsolidoitu teksti (EUR-Lex)
- → Digitraffic — tieliikenteen NAP
Tilannekuva ei sisällä vertailua kaikkiin alalla toimiviin tai kaikkiin lain mukaan velvollisiin organisaatioihin. Se vertailu vaatii erillisen perusjoukon.
NAPCORE-jaottelu: mitä tietoluokkia kulkumuodolta odotetaan
Kypsyys lasketaan MMTIS-asetuksen liitteen I tietoluokista (asetus 2017/1926, muutettu 2024/490) NAPCOREn kulkumuotokohtaisen taulukon mukaan. Taulukko kertoo jokaiselle kulkumuodolle, mitkä tietoluokat on rekisteröitävä NAPiin: xx = joka tapauksessa, x = kun tieto on koneluettavana saatavilla, o = valinnainen. Pakolliset (xx) luokat tuovat yhteensä 50 % pisteistä ja odotetut (x) 50 % (koko 100 %, jos toista ryhmää ei ole); valinnaiset ja ei-odotetut luokat eivät tuo pisteitä.
Kulkumuoto päätellään aineistosta (NeTEx: Line/TransportMode ja FlexibleLine; GTFS: route_type). Jos aineistossa on useita kulkumuotoja, kustakin luokasta käytetään tiukinta vaatimusta. Jos aineisto ei kerro kulkumuotoa, käytetään FINAPin palvelutietoja.
NAPCORE-taulukko nimeää tietoluokat, ei NeTEx- tai GTFS-elementtejä: luokan ja elementtien vastaavuus on tämän työkalun tulkinta (annex_mapping_netex.py, annex_mapping_gtfs.py). Luokat, jotka eivät kuulu aikatauluaineistoon – toteutuneet viivästykset ja peruutukset (1.4), reaaliaikatieto (2.x), tie-, pyörä- ja jalankulkuverkot – listataan raportissa erikseen eivätkä vaikuta pisteisiin.