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: haku- ja tuontirajapinnat (aiemmilta nimiltään OUT- ja IN-rajapinnat).

Käytetty karttakoordinaattistandardi on EPSG 3067.

Tutustu tarkemmin Palvelutietovarannon rajapintaversioihin sivulla Tekninen dokumentaatio integraation toteuttajalle.

Hakurajapinta (OUT-rajapinta)

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

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

Tuontirajapinta (IN-rajapinta)

Organisaatio voi toteuttaa PTV:hen tuontirajapinnan (IN-integraatio), 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: 26.6.2026

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