Velhon roolina on perustietovarastona toimiminen ja tietoa jaetaan myös muihin tiestötietoa hyödyntäviin tai tietoa jalostaviin palveluihin. Tällä sivulla kuvataan eri järjestelmien rooleja sekä avataan Velhon sisältämien palveluiden nykytilaa sekä tavoitetilaa.

Tietojen hyödyntämisen palvelut

Kuvassa näkyy yleistasoisesti Velhon hyödyntämisen palvelut. Velho itsessään tarjoaa ensivaiheessa käyttöliittymän kautta tieosuus- ja kohdehaun, tiestötietonäkymän sekä karttapalvelun tausta-aineistoille sekä projektitiedoille. Lisäksi Velhosta löytyy tietokuvaus.

Rajapintakäyttäjille Velho tarjoaa pääsyn käyttötarpeiden mukaan lataus-, haku-, metatieto- sekä lähetyspalveluihin, joiden kautta tietoa voi hakea massoina tai räätälöidysti. Muiden palveluiden kautta keskeisimpiä peruskäyttäjälle ovat avoimeen dataan perustuvat palvelut. Velhon data luetaan Paikkatietopalveluiden käyttöön, jossa ne julkaistaan Väyläviraston avoimen datan periaatteiden mukaisesti.

Käyttöliittymän kautta

Velhon käyttöliittymässä tarjolla olevat palvelut. Katkoviivalla kuvattuja siirtymiä tai palveluita ei vielä ole olemassa, mutta ne tullaan lisäämään. Ainoastaan suunnitelma- ja toteumatietovarastoon liittyvät palvelut on esitetty harmaalla.

Velho tarjoaa useita erilaisia tapoja tiestötietojen katseluun. Tässä kuvataan erilaiset tavat ja toiminnallisuudet, joilla tietoja pääsee katsomaan ja jatkohyödyntämään. Tarkemmat ohjeet toiminallisuuksien käyttöön on linkitetty jokaisen alle erikseen.

Tieosuushaku

Tieosuushaku yhdistelee tuloksiin tieosoitevälit eli sijainnit, joissa annetut hakuehdot täsmäävät. Esimerkiksi, kun halutaan etsiä kaikki sellaiset sijainnit, jotka sijaitsevat tietyn Elyn alueella ja tiellä on vakavia vaurioita.

  • Mahdollisuus antaa ehtoja, joiden mukaan tuloksissa näytettävät tieosuudet eli sijainnit yhdistellään

Käyttöohjeet: tieosuushaku

Kohdehaku

Kohdehaku on tarkoitettu nimensä mukaisesti Velhon kohteiden, kuten esimerkiksi varusteiden, rakennetietojen tai luokittelujen ominaisuustietojen hakemiseen.

  • Mahdollisuus hakea yhtä kohdeluokkaa kerrallaan (esim. aidat, pohjavesialueet)
  • Mahdollisuus rajata hakua kohteen ominaisuustiedoilla
  • Tuloksissa raakadatana kaikki kohteen ominaisuustiedot

Käyttöohjeet: kohdehaku

Tiestötietonäkymä

Tiestötietonäkymän kautta voi tarkastella tien rakenne- ja mittaustietoja sekä ajorata- ja kaistatietoja visualisoituna.

  • Siirtymä näkymään tapahtuu klikkaamalla kartalta haluttua tien kohtaa tai antamalla pikahakuun tarkan tieosoitteen

Käyttöohjeet: tiestötietonäkymä

Kartta

Kartta eli Velhon etusivu tarjoaa tällä hetkellä erilaisia karttatasoja sekä valitun tieosoitteen perustietojen katselun. Tänne tullaan lisäämään myös tiestötietoja myöhemmässä vaiheessa. Karttatasojen sisältöön pääsee kiinni laittamalla haluamansa tasot päälle tasovalikosta ja klikkaamalla karttaa – vasemmalle avautuva inforuutu näyttää ne tasot (taustakartta, tieosoite, projekti), jotka osuvat hiiren klikkauksen kohdalle.

Tieosoitteen tietoja pääset katsomaan klikkaamalla tietä kartalla tai syöttämällä tarkan tieosoitteen pikahakuun.

Käyttöohje: pikahaku

Käyttöohje: karttatoiminnot

Tietokuvaus

Tietokuvaus kuvaa nimensä mukaisesti kaiken tiedon mitä ja missä muodossa Velho sisältää. Tietokuvauksesta näet mitä

  • tietokokonaisuuksia Velhoon kuuluu
  • ominaisuuksia näiden kokonaisuuksien kohdeluokkiin kuuluu
  • arvoja tietyille ominaisuuksille voidaan antaa

Tietokuvaukseen tullaan myös lisäämään tarkemmat kuvaukset eri kohteiden sisällöstä ja käyttötarkoituksesta kevään 2022 aikana. Vastaavuustaulukosta näet mitä Tierekisterin tietoa nykyinen Velhon tieto vastaa.

Rajapintojen kautta

Latauspalvelu

Latauspalvelu mahdollistaa kohdeluokkakohtaisen massadatan lataamisen ndjson-muotoisena itselleen. Latauspalvelussa kukin kohdeluokka on rajattu ELY L-aluejaon mukaisesti. Tarkemmat ohjeet palvelun käyttöön löytyy täältä: Latauspalvelun dokumentaatio

Metatietopalvelu

Metatietopalvelu tarjoaa kuvauksen Velhon tietosisällöstä eli metatiedoista OpenAPI 3 -standardimuodossa Velhoon integroituvia tai tietosisältöä muuten hyödyntäviä järjestelmiä varten.

Metatietopalvelun dokumentaatio (vaatii kirjautumisen Velhoon)

Hakupalvelu

Hakupalvelun dokumentaatio

Muiden palveluiden kautta

Analytiikkapalvelu

Kuvaus tulossa.

Lataus- ja katselupalvelu

Kuvaus tulossa.


Tietojen päivittämisen palvelut

Käyttöliittymän kautta

Ylläpito (tulossa myöhemmin)

Ylläpitokäyttöliittymän kautta tiestötietoja voi lisätä ja päivittää eli muokata tai päättää. Käyttö vaatii erilliset päivitysoikeudet.

Alkuun käyttöliittymä tarjoaa mahdollisuudet vain tiedostopohjaiseen tietojen päivitykseen.

Tarkemmat käyttöohjeet tullaan lisäämään.

Rajapintojen kautta

Tiestötietoa päivitetään Velhossa eri tavoin tietokokonaisuudesta ja kohdeluokasta riippuen. 

Yleisimmät tavat päivittää tietoa ovat:

  • ulkoisista järjestelmistä Velhon tarjoaminen rajapintojen kautta (APIt)
  • eräajoina lähetyspalvelun kautta
    • toimijat itse
    • operaattoripalvelun avulla

Ulkoiset järjestelmät (APIt)

Osaa Velhon kohdeluokista ylläpidetään muissa järjestelmissä ja tieto luetaan Velhoon rajapintojen kautta. Nämä kohdeluokat ja liittyvät järjestelmät kuvataan tarkemmin kohdassa liittymät muihin palveluihin (tulossa).  

Rajapinnassa tarjotaan kunkin rekisteripalvelun toteuttamat päivitystoiminnallisuudet REST-toteutuksina:

  • uuden kohteen luomiselle
  • olemassaolevan kohteen muokkaamiselle
    • siten, että kohteen historia säilyy (tilanne, jossa kohteen ominaisuudet ovat muuttuneet “oikeasti”)
    • siten, että muokataan kohteen historiaa (tilanne, jossa kohteen tiedot ovat olleet virheelliset)
  • kohteen lakkauttamiselle, sen historia kuitenkin säilyttäen
  • kohteen poistolle, historia mukaanlukien. (ei yleensä sallittu)

Käyttöohje: ulkoiset rajapinnat

Lähetyspalvelu

Velhon lähetyspalvelun kautta on tarkoitus päivittää suuria datamassoja sekä aineistoja, joita luonteensa vuoksi päivitetään esimerkiksi muutamia kertoja vuodessa. 

Velhon lähetyspalvelun toimintaperiaate on seuraava:

  1. Ulkoinen järjestelmä tekee REST-rajapintaan pyynnön haluavansa tuoda kohteita Velhoon. Se saa vastauksena osoitteen, johon data voidaan lähettää HTTP:llä, sekä eräajotunnisteen.
  2. Ulkoinen järjestelmä lähettää datan annettuun osoitteeseen NDJSON-muotoisena siirtotiedostona (soveltuvin osin sama kuin Latauspalvelun tarjoama muoto).
  3. Lähetyspalvelu validoi lähetetyn datan ja vie sen Velhon rajapintoja käyttäen oikeisiin rekistereihin.
  4. Ulkoinen järjestelmä voi 1-kohdassa saamansa eräajotunnisteen avulla tiedustella, miten lähetetyn datan käsittely etenee, ja onko esim. datan validoinnissa ilmennyt virheitä.

Siirtotiedostossa voidaan ilmaista uusien kohteiden luonti (kohteen tiedot ilman OID:ia), kohteen päivitys (kohteen OID ja sen tiedot) sekä kohteiden lakkauttaminen tai poisto (kohteen OID sekä tieto lakkautuksesta/poistosta). Näiden operaatioiden semantiikka on sama kuin REST-rajapintojen kohdalla.

Tarkemmat käyttöohjeet lähetyspalvelun dokumentaatiossa.