National Access Point, NAP Liikennevirasto toteuttaa rajapintakatalogin Risto Pitkänen, Atostek Martin Johanssonin (Liikennevirasto) kalvojen pohjalta 7.6.2017
Liikkumispalveluita koskeva olennainen tieto ja siihen liittyvät velvoitteet
Olennaiset tiedot - NAP ja digitointityökalut Liikennevirasto ottaa vastaan tietoja liikkumispalveluiden tarjoajien olennaisten tietojen koneluettavista rajapinnoista ( tietoja tiedosta ja rajapinnoista ) tarvitaan järjestely tietojen toimittamiseen tarvitaan järjestely tietojen jakamiseksi Järjestelyä kutsutaan nimellä National Access Point (NAP) NAP = kansallinen liikkumispalveluissa käsiteltävien tietojen rajapintaluettelo, jossa voidaan esittää henkilöliikenteen liikkumispalveluiden olennaisten tietojen koneluettavien rajapintojen internetosoitteita Liikennevirasto tarjoaa digitointityökalut liikkumispalveluiden tarjoajille olennaisten tietojen digitoimiseen ja avaamiseen koneluettavaan rajapintaan ensisijaisesti pienille toimijoille, käyttäjille maksuton palvelu toimijan digitoimat tiedot päätyvät Liikenneviraston tietokantaan, josta tiedot myös julkaistaan koneluettavassa rajapinnassa koneluettavaa rajapintaa kuvaavat tiedot julkaistaan automaattisesti NAPissa, mikäli kuvailutiedot ovat kunnossa
Tiedon kulku liikkumispalvelun tarjoajilta NAP:iin NAP ei pääosin sisällä varsinaisia olennaisia tietoja, vaan tietoja rajapinnoista Toimijan oman tietojärjestelmän rajapinta, josta olennaiset tiedot on jaettavissa. Toteutus itse tai palvelutoimittajan kautta National Access Point (NAP) Liikenneviraston tuottama rajapintojen hakupalvelu Toimijayhteenliittymän yhteinen ratkaisu olennaisen tiedon tallentamiseksi ja jakamiseksi yhteisen rajapinnan kautta. Toteutus itse tai palvelutoimittajan kautta Liikenneviraston järjestämä digitoidun tiedon tallennuspaikka ja rajapinta Liikenneviraston digitointityökalu tiedon digitoimiseksi Vaihtoehto A Vaihtoehto B Vaihtoehto C Aikataulun mukainen henkilöliikenne Taksiliikenne Asemat, satamat ja terminaalit Muu kutsun perusteella toimiva henkilöliikenne Ajoneuvojen vuokraus ja kaupallinen yhteiskäyttö Yleiset kaupalliset pysäköintipalvelut Välitys- ja yhdistämis palvelut Henkilöiden kuljetuspalvelut
Digitointityökalu Tietojen syöttö- ja ylläpitotyökalu, jolla liikkumispalveluiden tarjoaja voi itse digitoida liikkumispalvelunsa olennaiset tiedot liikennepalvelulain ja tietoasetuksen mukaisesti. Tekninen ratkaisu sisältää myös avoimien rajapintojen julkaisun sekä mahdollistaa rajapintaa koskevien tietojen toimittamisen NAP:iin Olennainen tieto mm. kaikkia palveluita (esim. kutsuliikenne, taksi jne) koskeva tieto mm. hinta- ja saatavuus/palvelualuetietoja sekä esteettömyystietoja ennalta määriteltyä reittiä noudattava palvelu: reitti-, pysäkki-, aikataulutieto
Toteutuksen aikataulu 1.1.2018: Valmiina NAP minimipalvelu, tavoitteena mahdollisimman hyödyllinen ja joustavasti ylläpidettävä rajapintaluettelo-palvelu Digitointityökalut Liikenneviraston nykypalveluiden pohjalta 1.1.2018 jälkeen kehitystyötä tehdään käytännön kokemusten perusteella
NAP: periaatekuva Tietojen hyödyntäjä (esim. uusien digitaalisten palvelujen kehittäjä) LPT Liikkumispalvelun tarjoajan (LPT) Pieni toimija Rajapintoja kuvaavien tietojen ilmoittaminen NAP Katalogi Liikkumispalvelu A Reitti- ja aikataulurajapinta Myyntirajapinta LPT:n järjestelmä 1 LPT:n järjestelmä 2 Reaaliaikarajapinta Digitointityökalu Digitoidut tiedot Digitointityökalulla digitoitujen tietojen rajapinta LPT:n järjestelmä 3
NAP:in ominaisuuksia Teknisesti NAP on palvelu- tai rajapintakatalogi Varsinaiset rajapinnat ja/tai tietoaineistot ovat yleensä palveluntarjoajien omissa järjestelmissä Poikkeus: digitointityökalulla digitoidut tiedot on mahdollista teknisesti julkaista suoraan NAP:issa Poikkeus: osa olennaisista tiedoista on luonteeltaan kompaktia metatietoa, joka voi olla sellaisenaan NAP:issa Esim. nimi, yhteystiedot, lupatunnus, linkki kotisivuille Tietojen ilmoittajat pitää tunnistaa organisaatioidensa edustajina Suunnitteilla Suomi.fi/Katso-tunnistus Tietojen selaajia/käyttäjiä ei tarvitse tunnistaa
Olennaisten tietojen tietolajit (VN asetusluonnos), esimerkkiformaatteja (EU:n MMTIS asetuksen nimeämä NeTEx kattaa osan näistä) Nimi, yhteystiedot, mahdollinen lupatunnus Tieto välitettävistä palveluista palvelutyypeittäin Reitit paikkatietoina (GTFS) Pysäkit ja muut pysähdyspaikat paikkatietoina (GTFS) Pysäkkiaikataulut (GTFS) Tiedot alueesta/alueista, joilla palvelua tarjotaan (GeoJSON) Maksutavat Asemien ja terminaalien aukioloajat Sijainti paikkatietona (osoite, koordinaatit, GeoJSON) Tiedot palveluajoista Pysäköintiaikarajoitukset Liikennevälineet, joita varten esim. pysäköintipalveluita tarjotaan Tiedot esteettömistä palveluista ja tiloista ym. Esteettömyys: matalalattiaisuus, pyörätuolipaikat Tieto erityisryhmille varatusta kapasiteetista tai muista käyttöä helpottavista seikoista Tieto mahdollisesti saatavilla olevista energianlatauspisteistä ja niiden mahdollisesta maksullisuudesta Tieto palvelun käyttöön ottamiseksi mahdollisesti vaadittavista ehdoista kuten ikä tai ajokortti sekä linkki tarvittaviin menettelyihin Varausmahdollisuus tai -velvollisuus, linkki mahd. varauspalveluun (URL) Mahdolliset staattiset hintatiedot sekä tiedot alennusperusteista Mahdollinen linkki tarjoajan myyntipalveluun (URL) Tiedot lisäpalveluista tai rajoituksista, ml. matkatavaraedot Mahdolliset reaaliaikatiedot kulusta reitillä (SIRI, GTFS- RT) Linkki kotisivuille (URL)
Rajapintojen määrittely Pienten toimijoiden käyttöön tarjottavan digitointityökalun toteutusvaiheessa Liikennevirasto tarvitsee rajapintamääritykset olennaisille tiedoille Digitointityökalulla tulee pystyä digitoimaan kaikki olennaiset tiedot Poikkeukset: dynaamiset tiedot ja rajapinnat (reaaliaikatiedot, myyntirajapinnat, ym.) Jos ei ole standardeja tai de facto standardeja puuttuvat rajapintamääritykset luodaan NAP-toteutusprojektissa avoimessa vuorovaikutuksessa liikkumispalvelutoimijoiden kanssa Nimi, yhteystiedot, mahdollinen lupatunnus Tieto välitettävistä palveluista palvelutyypeittäin Reitit paikkatietoina (GTFS) Sijainti paikkatietona (osoite, koordinaatit, GeoJSON) Liikennevälineet, joita varten palveluita tarjotaan Tiedot alueesta/alueista, joilla palvelua tarjotaan (GeoJSON) Tiedot palveluajoista Sisätilojen mahdolliset aukioloajat Pysäköintiaikarajoitukset Tiedot esteettömistä palveluista ja tiloista ym. Pysäkit ja muut pysähdyspaikat paikkatietoina (GTFS) Pysäkkiaikataulut (GTFS) Maksutavat Esteettömyys: matalalattiaisuus, pyörätuolipaikat Tieto erityisryhmille varatusta kapasiteetista tai muista käyttöä helpottavista seikoista Tieto mahdollisesti saatavilla olevista energianlatauspisteistä ja niiden mahdollisesta maksullisuudesta Tieto palvelun käyttöön ottamiseksi mahdollisesti vaadittavista ehdoista kuten ikä tai ajokortti sekä linkki tarvittaviin menettelyihin Varausmahdollisuus tai -velvollisuus, linkki mahd. varauspalveluun (teksti, URL) Mahdolliset staattiset hintatiedot sekä tiedot alennusperusteista Mahdollinen linkki tarjoajan myyntipalveluun (URL) Tiedot lisäpalveluista tai rajoituksista, ml. matkatavaraedot Mahdolliset reaaliaikatiedot kulusta reitillä (SIRI, GTFS-RT) Linkki kotisivuille (URL) Digitoidut tiedot NAP Digitointityökalu Digitointityökalulla digitoitujen tietojen rajapinta