Toimijoiden tilanne
Seuraa ilmoitettuja rajapintoja, tunnista tarkistettavat puutteet ja avaa alkuperäinen data todentamista varten.
| Toimija ja ryhmä | Lähderajapinta | Formaatti | Kypsyys (Annex I) |
|---|
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.
Sääntely
Mihin pykäliin tilannekuvan sarakkeet nojaavat, ja mitä ne eivät todista.
| Kysymys | Oikeusperusta | Työkalun havainto | Rajaus |
|---|---|---|---|
| Mitä dataa? | MMTIS-asetuksen liite; kansallisen lain toimivaltapykälät | Palvelulaji ja ilmoitettu sisältö | Ei todista kaikkien pakollisten tietolajien kattavuutta |
| Mistä löytyy? | MMTIS-asetuksen kansallinen yhteyspiste | FINAPin julkaistu palvelukuvaus | NAPin ulkopuoliset velvolliset eivät näy |
| Rajapinta ja muoto? | MMTIS-asetuksen standardi- ja saatavuussäännöt | Ilmoitettu linkki ja formaatti | Rajapintaa ei vielä haeta tai validoida |
| Ajantasaisuus? | MMTIS-asetuksen päivitys- ja laatuehdot | Ei mittaustulosta | 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ä |
Tämä prototyyppi ei sisällä varmennettuja pykäläviittauksia — tuotantoversiossa jokainen rivi linkittyy tarkistettuun säädöstekstiin.
Lähteet ja menetelmä
Mistä esimerkkiaineisto tulisi tuotannossa, ja mitä se rajaa pois.
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ä tai yhteystietoja ei kopioida tähän näkymään.
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.