Suomi.fi kehittäjille
Siirry suoraan sisältöön.

Palvelutietovaranto teknisenä järjestelmänä

Palvelutietovarannon käyttöliittymä

Ensisijainen tapa tuottaa tiedot Palvelutietovarantoon on kuvata ne PTV-käyttöliittymän kautta. Käyttöliittymän käytön edellytyksenä on hyväksytty PTV-käyttölupahakemus.

Käyttölupahakemuksen tekemisestä, käyttöliittymään tunnistautumisesta ja käyttöoikeuksien hallinnoinnista löydät lisätietoa sivulta Palvelutietovarannon käyttöönotto.

Palvelutietovarannon käyttöliittymä käyttää HTTPS-protokollaa.

Palvelutietovarannon asiakastestiympäristö

Palvelutietovarannon asiakastestiympäristöä voi käyttää

  • palvelutietovarannon käyttöliittymän opetteluun ja kokeiluun
  • rajapinnan testaamiseen.

Linkin asiakastestiympäristöön sekä tekstitunnukset löydät sivulta Käyttöliittymän yleiset ohjeet.

Palvelutietovarannon rajapinnat

Palvelutietovaranto on toteutettu avoimella lähdekoodilla. Sovelluksessa on avoin REST-/JSON-rajapinta.

Palvelutietovaranto tarjoaa kaksi rajapintaa: IN- ja OUT-rajapinnat.

Käytetty karttakoordinaattistandardi on EPSG 3067.

Tutustu tarkemmin Palvelutietovarannon rajapintaversioihin sivulla Tekninen dokumentaatio integraation toteuttajalle.

OUT-rajapinta

Palvelutietovarantoon kuvattuja tietoja voi hyödyntää vapaasti avoimen OUT-rajapinnan kautta ilman erillisiä käyttöoikeuksia tai tunnistautumista.

Lue lisää tietojen hyödyntämisestä OUT-rajapinnan kautta sivulta PTV-tietojen hyödyntäminen.

IN-rajapinta

Organisaatio voi toteuttaa PTV:hen IN-integraation, jos sillä on jokin oma järjestelmä, jossa on ajantasaista, asiakaslähtöisesti kuvattua, PTV-tietomallin kanssa yhteensopivaa rakenteista palvelutietoa.

Lue lisää sivulta Näin otan IN-rajapinnan käyttöön.


Päivitetty: 14.1.2026

Oletko tyytyväinen tämän sivun sisältöön?