Toiminnalliset rajapinnat tarjoavat palveluja, joita on mahdollista hyödyntää esimerkiksi osana muita palveluja.
Viitekehysmuunnin (VKM)
Viitekehysmuunnin-rajapintaa käytetään tiestösijaintien muuntamiseen sijaintiviitekehyksestä toiseen, esimerkiksi koordinaattien saamiseen tieosoitteelle. Viitekehysmuuntimesta on julkaistu uusi versio, jossa on aiempiin nähden useita uusia ominaisuuksia.
Tieosoitteen, katuosoitteen ja koordinaattien lisäksi käytössä on nyt lineaarilokaatio, eli tielinkkinumero ja m-arvo, uutena viitekehyksenä. Haussa pystyy aiempaa vapaammin yhdistelemään viitekehyksiä, esimerkiksi hakemalla tiellä ja kadulla tai koordinaateilla ja lineaarilokaatiolla yhtä aikaa. Uusia hakuparametreja ovat muun muassa urakka-alue, ely ja hallinnollinen luokka – voi siis hakea esimerkiksi tieosuuden urakka-alueelta.
Kaikki haut tapahtuvat yhden rajapinnan, eli osoitteen, kautta: https://avoinapi.vaylapilvi.fi/viitekehysmuunnin. Tähän rajapintaan voi antaa kaikki käytettävissä olevat hakuparametrit, sijainnit ja sijaintiyhdistelmät. Viitekehysmuunnin palauttaa halutessa lähtösijainnin jokaisessa muussa viitekehyksessä, esimerkiksi tieosoitteen koordinaatteina, lineaarilokaationa ja katuosoitteena aluetietoineen.
Palautus on uudessa viitekehysmuuntimessa GeoJSON-muotoinen, eli koostuu geometriasta ja sen paikkatiedoista. Viivamaisissa hauissa palautus jakautuu geometrisesti yhtenäisiin osiin.
Uusia hakumahdollisuuksia ovat muun muassa haku pistemäisellä ja viivamaisella lineaarilokaatiolla, katuviivan haku ja tieosoitevälin historiahaku.
Uuteen viitekehysmuuntimeen voi tutustua osoitteessa https://avoinapi.vaylapilvi.fi/viitekehysmuunnin.
Esimerkki pistemäisen muunnoksen rajapintakutsusta: https://avoinapi.vaylapilvi.fi/viitekehysmuunnin/muunna?tie=1&osa=1&etaisyys=0&palautusarvot=1,2,3,4,5,6.
Esimerkki viivamaisen muunnoksen rajapintakutsusta: https://avoinapi.vaylapilvi.fi/viitekehysmuunnin/muunna?tie=1&osa=1&osa_loppu=1&valihaku=true&palautusarvot=1,2,3,4,6.
Viitekehysmuuntimen rajapintakuvaus löytyy täältä
Rataverkon viitekehysmuunnin (Rata-VKM)
Rataverkon viitekehysmuunninta käytetään pistemäisten rataverkon muuntamiseen koordinaateista rataosoitteeksi ja rataosoitteesta koordinaateiksi. Rataverkon viitekehysmuuntimen swagger-dokumentaatio: https://avoinapi.vaylapilvi.fi/rata-vkm/swagger-ui/index.html#/
Palautus rataverkon viitekehysmuuntimessa on tieverkon viitekehysmuuntimen tavoin GeoJSON-muotoinen ja vastauksessa palautuu haettu geometria sekä rataverkon ominaisuustietoja kyseisen pisteen osalta.
Esimerkki pistemäisen muunnoksen rajapintakutsusta: https://avoinapi.vaylapilvi.fi/rata-vkm/v1/koordinaatit?ratakilometri=1&ratametri=0&ratanumero=001
