Hyppää pääsisältöön

Kiinteistötietojen kyselypalvelu (OGC API Features)

Palvelusta saat käyttöösi kiinteistörajat, kiinteistötunnukset ja rajamerkit sijaintitietoineen, sekä palstan, rekisteriyksikön ja määräalan keskeisiä tietoja. Lisäksi voit saada tietoja niistä käyttöoikeusyksiköistä, joiden sijainti on tallennettu kiinteistörekisteriin. Käyttöoikeusyksiköitä ovat mm. tieoikeudet, luonnonsuojelualueet yksityisten omistamilla alueilla ja voimansiirtolinjat. Palvelusta on saatavissa myös kunnan rekisterinpitoalueiden sijainnit.  Tiedot tuotetaan ajantasaisesta kiinteistörekisteristä.

Palvelussa on sekä avoimia aineistoja että luvanvaraisia aineistoja. Avoimia aineistoja (tuotteita), voi käyttää Maanmittauslaitoksen avoimen tietoaineiston Nimeä CC 4.0 -lisenssin mukaisesti. Muiden tuotteiden käyttö edellyttää KTJ-lain mukaista käyttölupaa.

Palvelu on käytettävissä 24/7. Rekisteritiedot päivitetään joka yö klo 02.00 mennessä. Rajapinnan tuki palvelee ma - pe klo 8 - 16.

Sopimus vai avoin rajapintapalvelu?

Palvelusta on tarjolla kolme vaihtoehtoa:

  1. Avoimet tuotteet (API-avain)
  2. Avoimet tuotteet (sopimus)
  3. Luvanvaraiset tuotteet (sopimus)

Avoimet tuotteet (API-avain) on avoin rajapintapalvelu, jonka käytön etuna on sen nopea ja helppo käyttöönotto. Rajapintapalvelua saa käyttää vapaasti ja maksutta testaukseen sekä tuotantoon. Rajapintapalvelua ei ole kuitenkaan tarkoitettu suuren volyymin palveluiden käyttöön. Avoimen rajapintapalvelun käytölle ei tarjota käytön tukea eikä Maanmittauslaitos takaa palvelun toimivuutta tai saatavuutta. MML voi tarvittaessa rajoittaa yksittäisen rajapintapalvelun käyttäjän pääsyä palveluun, jos käytön suuri volyymi häiritsee rajapintapalvelun toimintaa. Avoimen rajapintapalvelun käyttöön vaaditaan API-avain. Lue lisää API-avaimen luomisesta ja käyttämisestä.

Avointa rajapintapalvelua voi käyttää Maanmittauslaitoksen avoimen rajapintapalvelun käyttöehtojen mukaisesti. 

Sopimukseen perustuvassa rajapintapalvelussa Maanmittauslaitos varmistaa käyttäjille palvelun toimivuuden ja saatavuuden sekä tarjoaa käytön tukea. Palvelun käyttöön tarvitaan käyttäjätunnus ja salasana. Sopimuspalvelusta peritään voimassa olevan hinnaston mukaista hakumääräperusteista ylläpitomaksua. Tarkemmat hintatiedot ovat luettavissa kohdassa Hinnasto

Lue lisää palvelun sopimusvaihtoehdoista Ota käyttöösi -osiosta. 

Voit myös testata palvelua. Voit käyttää avoimien aineistojen testaamiseen Avoimet tuotteet (API-avain) palvelua ja luvanvaraisten tuotteiden testaamiseen koekäyttöympäristöä. Lue lisää Koekäyttö -osiosta. 

Palveluvaihtoehdot 

 Avoimet tuotteet (API-avain)Avoimet tuotteet (sopimus)
TuotteetAvoimetAvoimet
Tuotteiden rakenneSimpleSimple ja complex
Sopimus/lupaEi sopimusta, itserekisteröintiSopimus avoimien paikkatietojen 
rajapintapalvelusta
MaksullisuusMaksutonYlläpitomaksu
PääsynhallintaAPI-avainTunnus ja salasana
TietolähdeAjantasainen kiinteistörekisteriAjantasainen kiinteistörekisteri
Tekninen kuvausAvoimet tuotteet (API-avain)Avoimet tuotteet (sopimus)
Näin pääset alkuunLuo API -avain ja  ota rajapinta käyttöön.Ota yhteys verkkopalvelut@maanmittauslaitos.fi 
Toimitamme tunnuksen ja salasanan sopimuksen laatimisen jälkeen.

 

 Luvanvaraiset tuotteet (sopimus)Luvanvaraiset tuotteet (koekäyttö)
TuotteetAvoimet  ja 
a) luvanvaraiset tuotteet, ei henkilötietoja
b) luvanvaraiset, myös henkilötietoja
Avoimet ja luvanvaraiset ilman henkilötietoja
Tuotteiden rakenneSimple ja complexSimple ja complex
Sopimus/lupaSopimus
KTJ lain mukainen käyttölupa 
Tietoturvavaatimukset (tietoturvaliite).
Määräaikainen koekäyttölupa tai
sopimus jatkuvasta testikäytöstä
MaksullisuusYlläpitomaksu 
ja luvanvaraisista tuotteista aineistomaksu
Maksuton
PääsynhallintaTunnus ja salasanaTunnus ja salasana
TietolähdeAjantasainen kiinteistörekisteriKoekäyttöympäristö /testidata
Tekninen kuvausLuvanvaraiset tuotteet (sopimus)Luvanvaraiset tuotteet (koekäyttö)
Näin pääset alkuunOta yhteys verkkopalvelut@maanmittauslaitos.fi 
Toimitamme hakemuslomakkeen ja tietoturvaliitteen täytettäväksi.
Täytä koekäyttölomake

Voit tutustua avoimen palvelun tuotteisiin myös demosovelluksessa.

Avoimet tuotteet

  • Tietorakenteeltaan simple-muotoiset tuotteet
    • Rajamerkin sijaintitiedot
    • Kiinteistörajan sijaintitiedot
    • Kiinteistötunnuksen sijaintitiedot
    • Palstan sijaintitiedot
    • Projisoidun palstan kiinteistötunnuksen sijaintitiedot
    • Projisoidun palstan sijaintitiedot
    • Määräalan osan sijaintitiedot
  • Tietorakenteeltaan complex-muotoiset tuotteet
    • Palstan laajat sijaintitiedot
    • Rekisteriyksikön laajat sijaintitiedot
    • Rekisteriyksikön avoimet ominaisuustiedot
    • Rekisteriyksikön sijaintikuntatiedot

 Luvanvaraiset tuotteet 

Alla olevassa taulukossa on lueteltu palvelusta saatavat luvanvaraiset tuotteet ja tiedon rakenne (simple/complex). Voit käyttää simple,eli rakenteeltaan yksikertaisia tuotteita esim. QGIS- tai GDAL-ohjelmistoissa sekä sovelluksissa, joissa keskeisintä on kiinteistöjaotuksen (sisältäen myös määräalat) sijaintitietojen esittäminen.

Palvelun complex eli monimuotoisia tuotteita (esim. rekisteriyksikön tai palstan laajat sijaintitiedot) voi käyttää niissä sovellusintegraatioissa, joissa niitä pystytään teknisesti hyödyntämään.

Lisäksi taulukossa on esitetty sisältääkö tuote henkilötietoja ja pitääkö tuotteen haku lokittaa.

TuoteSisältää henkilötietojaSimpleComplexLokitusvaatimus
Käyttöoikeusyksikön osan sijaintitiedot x x
Kunnan rekisterinpitoalueen sijaintitiedot x  
Rekisteriyksikön perustiedot  x 
Rekisteriyksikön 3D-ominaisuustiedot  x 
Määräalan perustiedot  x 
Rekisteriyksiköt hakuehdoin  x 
Määräalat hakuehdoin  x 
Käyttöoikeusyksikön osan ominaisuustiedot  xx
Käyttöoikeusyksikön perustiedot  xx
Käyttöoikeusyksikön viranomaispäätökset  xx
Käyttöoikeusyksiköt hakuehdoin  xx
Käyttöoikeusyksikön osat hakuehdoin  xx
Rekisteriyksikön yhteisalueosuudet  x 
Rekisteriyksikön voimassa olevat muodostuneet  x 
Tiekunnan yhteystiedotx xx
Rantakunnan yhteystiedotx xx

 

Tuotekokonaisuudet (koskee vain tietojen jälleenmyyjiä)

Jälleenmyyntisopimuksessa tuotteet ovat saatavilla palvelusta tuotekokonaisuuksina. Alla olevassa taulukossa on kuvattu mitä Kiinteistötietojen kyselypalvelun (OGC API Features) avoimia ja luvanvaraisia tuotteita tuotekokonaisuudet sisältävät. Hakemuksessa valitaan jokin alla olevista tuotekokonaisuuksista (1-4). Lisäksi taulukossa on kerrottu, mikäli tuotteen haku pitää lokittaa.

Tuotteet Tuote-kokonaisuudet    Lokitus-vaatimus
 1) KTJ:n  laajat tiedot henkilö-tunnuksin2) KTJ:n laajat tiedot ilman henkilö-tunnuksia3) KTJ:n suppeat tiedot4) KTJ:n suppeat tiedot ja kiinteistön omistajien yhteystiedot5) Kiinteistön perustiedot 
Rajamerkin sijaintitiedotxxxxx 
Kiinteistörajan sijaintitiedotxxxxx 
Kiinteistötunnuksen sijaintitiedotxxxxx 
Palstan sijaintitiedotxxxxx 
Projisoidun palstan kiinteistötunnuksen sijaintitiedotxxxxx 
Projisoidun palstan sijaintitiedotxxxxx 
Määräalan osan sijaintitiedotxxxxx 
Palstan laajat sijaintitiedotxxxxx 
Rekisteriyksikön laajat sijaintitiedotxxxxx 
Rekisteriyksikön avoimet ominaisuustiedotxxxxx 
Rekisteriyksikön sijaintikuntatiedotxxxxx 
Käyttöoikeusyksikön osan sijaintitiedotxxxx  
Kunnan rekisterinpitoalueen sijaintitiedotxxxxx 
Rekisteriyksikön perustiedotxxxxx 
Rekisteriyksikön 3D-ominaisuustiedotxxxxx 
Määräalan perustiedotxxxxx 
Rekisteriyksiköt hakuehdoinxxxxx 
Määräalat hakuehdoinxxxxx 
Käyttöoikeusyksikön osan ominaisuustiedotxxxx x
Käyttöoikeusyksikön perustiedotxxxx x
Käyttöoikeusyksikön viranomaispäätöksetxxxx x
Käyttöoikeusyksiköt hakuehdoinxxxx x
Käyttöoikeusyksikön osat hakuehdoinxxxx x
Rekisteriyksikön yhteisalueosuudetxxxxx 
Rekisteriyksikön  voimassa olevat muodostuneetxxxx  
Tiekunnan yhteystiedotxx x x
Rantakunnan yhteystiedotxx x x
       

 

Avoimien paikkatietojen kyselypalvelut

Palvelusta peritään hakumääräperusteista ylläpitomaksua. Maksu määräytyy todellisten hakumäärien mukaan. Taulukossa esitetään ylläpitomaksujen suuruus tietyillä hakumäärillä.

Minimimaksu on 235,40 € / vuosi (295,43 / vuosi, sis alv 25,5 %).

Palvelussa olevat tuotteet ovat maksuttomia ja maanmittauslaitoksen avoimen tietoaineiston lisenssin alaisia.

Ylläpitomaksu kattaa seuraavat palvelut:

  1. Kiinteistötietojen kyselypalvelu (OGC API Features) 
  2. Geokoodauspalvelu (REST)
  3. Rakennusten kyselypalvelu (OGC API Features)
  4. Nimistön kyselypalvelu (OGC API Features)
  5. Maastotietokannan kyselypalvelu (OGC API Features)
Hakumäärä (hakuja vuodessa)Ylläpitomaksu(euroa vuodessa)
 Hinta € (ilman alv.)Hinta € (sis. alv.)
20 000235,40 €295,43 €
50 000341,33 €428,37 €
100 000494,34 €620,40 €
200 000694,43 €871,51 €
500 0001 094,61 €1 373,74 €
1 000 0001 541,87 €1 935,05 €
2 000 0002 177,45 €2 732,70 €
5 000 0003 436,84 €4 313,23 €
10 000 0004 872,78 €6 115,34 €
20 000 0006 885,45 €8 641,24 €
Tuote Hinta € (ilman alv.) Hinta € (sis. alv.)
2200
Paikkatietojen kyselypalvelun minimimaksu
235,40 295,43

Kiinteistötietojen kyselypalvelu (OGC API Features), organisaatiot

Kiinteistötietojen kyselypalvelu (OGC API Features) sisältää avoimia ja luvanvaraisia tuotteita. Avoimen tietoaineiston lisenssin alaisista tuotteista peritään hakumääräperusteista ylläpitomaksua. Luvanvaraisista tuotteista peritään sekä aineisto- että ylläpitomaksua.  Lisäksi kahdesta tuotteesta veloitetaan tuotekohtaisesti kappalemäärään perustuvaa maksua.

Minimimaksu on 235,40 € / vuosi (295,43 € / vuosi, sis. alv 25,5 %). Julkishallinnon viranomaisilta ei peritä aineisto- eikä ylläpitomaksua viranomaistoimintaa varten.

Luvanvaraisia tietoja saa käyttää vain organisaation sisäisessä käytössä.

Avoimet tuotteet

Avoimista tuotteista peritään ylläpitomaksua. Ylläpitomaksu määräytyy hakujen mukaan. Yksi haku voi sisältää useamman vastauksen. Esimerkiksi palstojen haku kartalla suorakaiderajauksella on yksi haku. Jos samassa suorakaiderajauksessa haetaan rajamerkit, muodostaa se toisen haun.

  1. Rajamerkin sijaintitiedot
  2. Kiinteistörajan sijaintitiedot
  3. Kiinteistötunnuksen sijaintitiedot
  4. Palstan sijaintitiedot
  5. Palstan laajat sijaintitiedot
  6. Projisoidun palstan kiinteistötunnuksen sijaintitiedot
  7. Projisoidun palstan sijaintitiedot
  8. Rekisteriyksikön laajat sijaintitiedot
  9. Rekisteriyksikön avoimet ominaisuustiedot
  10. Rekisteriyksikön sijaintikuntatiedot
  11. Määräalan osan sijaintitiedot

Luvanvaraiset tuotteet

Alla olevista luvanvaraisista tuotteista peritään sekä aineisto- että ylläpitomaksua.  Maksut määräytyvät hakujen mukaan. Yksi haku voi sisältää useamman vastauksen. Esimerkiksi käyttöoikeusyksiköiden osan sijaintitietojen suorakaiderajaus kartalta on yksi haku sekä aineisto- että ylläpitomaksutaulukoon.

  1. Rekisteriyksiköt hakuehdoin
  2. Määräalat hakuehdoin
  3. Käyttöoikeusyksiköt hakuehdoin
  4. Käyttöoikeusyksikön osat hakuehdoin
  5. Käyttöoikeusyksikön osan sijaintitiedot
  6. Kunnan rekisterinpitoalueen sijaintitiedot

Alla olevista luvanvaraisista tuotteista peritään sekä aineisto- että ylläpitomaksua.  Maksut määräytyvät vastauksessa palautuvien kohteiden mukaan. Esimerkiksi viiden eri rekisteriyksikön perustiedoista muodostuu viisi hakua sekä aineisto- että ylläpitomaksutaulukoon.

  1. Rekisteriyksikön perustiedot
  2. Rekisteriyksikön 3D-ominaisuustiedot
  3. Määräalan perustiedot
  4. Käyttöoikeusyksikön osan ominaisuustiedot
  5. Käyttöoikeusyksikön perustiedot
  6. Käyttöoikeusyksikön viranomaispäätökset
  7. Rekisteriyksikön yhteisalueosuudet
  8. Rekisteriyksikön voimassa olevat muodostuneet

Alla olevilla tuotteilla on tuotekohtainen hinta, näistä ei kerry ylläpitomaksua.

26. Tiekunnan yhteystiedot (tuotekohtaisesti hinta/tiekunta)
27. Rantakunnan yhteystiedot (tuotekohtaisesti hinta/rantakunta)

Taulukossa esitetään ylläpito- ja aineistomaksujen suuruus tietyillä hakumäärillä. Maksu määräytyy todellisten hakumäärien mukaan.

Hakumäärä (hakuja vuodessa)Ylläpitomaksu(euroa vuodessa)Aineistomaksut(euroa vuodessa)
 Hinta € (ilman alv.)Hinta € (sis. alv.)Hinta € (ilman alv.)Hinta € (sis. alv.)
200070,62 €88,63 €176,55 €221,57 €
5 000105,93 €132,94 €270,71 €339,74 €
10 000153,01 €192,03 €388,41 €487,45 €
20 000223,63 €280,66 €541,42 €679,48 €
50 000341,33 €428,37 €859,21 €1 078,31 €
100 000494,34 €620,40 €1 212,31 €1 521,45 €
200 000694,43 €871,51 €1 718,42 €2 156,62 €
500 0001 094,61 €1 373,74 €2 718,87 €3 412,18 €
1 000 0001 541,87 €1 935,05 €3 848,79 €4 830,23 €
2 000 0002 177,45 €2 732,70 €5 437,74 €6 824,36 €
5 000 0003 436,84 €4 313,23 €8 603,87 €10 797,86 €
10 000 0004 872,78 €6 115,34 €12 158,41 €15 258,80 €
20 000 0006 885,45 €8 641,24 €17 195,97 €21 580,94 €
Tuote Hinta € (ilman alv.) Hinta € (sis. alv.)
8700
Minimimaksu
235,40 295,43
8728
Rantakunnan yhteystiedot (tuotekohtaisesti hinta/rantakunta)
1,80 Ei arvonlisäveroa
8727
Tiekunnan yhteystiedot (tuotekohtaisesti hinta/tiekunta)
1,80 Ei arvonlisäveroa

Kiinteistötietojen kyselypalvelut (OGC API Features), jälleenmyyjät

Tämä hinnasto koskee tiedon jälleenmyyjiä. Jälleenmyyjien kanssa tehdään sopimus tietojen välittämisestä.

Kiinteistötietojen kyselypalvelu (OGC API Features) sisältää avoimia ja luvanvaraisia tuotteita. Avoimen tietoaineiston lisenssin alaisista tuotteista peritään hakumääräperusteista ylläpitomaksua. Luvanvaraisista tuotteista peritään sekä aineisto- että ylläpitomaksua.  Lisäksi kahdesta tuotteesta veloitetaan tuotekohtaisesti kappalemäärään perustuvaa maksua.

Minimimaksu on 235,40 € / vuosi (295,43 € / vuosi, sis. alv 25,5 %).

Avoimet tuotteet

Avoimista tuotteista peritään ylläpitomaksua. Ylläpitomaksu määräytyy hakujen mukaan. Yksi haku voi sisältää useamman vastauksen. Esimerkiksi palstojen haku kartalla suorakaiderajauksella on yksi haku. Jos samassa suorakaiderajauksessa haetaan rajamerkit, muodostaa se toisen haun.

  1. Rajamerkin sijaintitiedot
  2. Kiinteistörajan sijaintitiedot
  3. Kiinteistötunnuksen sijaintitiedot
  4. Palstan sijaintitiedot
  5. Palstan laajat sijaintitiedot
  6. Projisoidun palstan kiinteistötunnuksen sijaintitiedot
  7. Projisoidun palstan sijaintitiedot
  8. Rekisteriyksikön laajat sijaintitiedot
  9. Rekisteriyksikön avoimet ominaisuustiedot
  10. Rekisteriyksikön sijaintikuntatiedot
  11. Määräalan osan sijaintitiedot

Luvanvaraiset tuotteet

Alla olevista luvanvaraisista tuotteista peritään sekä aineisto- että ylläpitomaksua.  Maksut määräytyvät hakujen mukaan. Yksi haku voi sisältää useamman vastauksen. Esimerkiksi käyttöoikeusyksiköiden osan sijaintitietojen suorakaiderajaus kartalta on yksi haku sekä aineisto- että ylläpitomaksutaulukoon.

  1. Rekisteriyksiköt hakuehdoin
  2. Määräalat hakuehdoin
  3. Käyttöoikeusyksiköt hakuehdoin
  4. Käyttöoikeusyksikön osat hakuehdoin
  5. Käyttöoikeusyksikön osan sijaintitiedot
  6. Kunnan rekisterinpitoalueen sijaintitiedot

Alla olevista luvanvaraisista tuotteista peritään sekä aineisto- että ylläpitomaksua.  Maksut määräytyvät vastauksessa palautuvien kohteiden mukaan. Esimerkiksi viiden eri rekisteriyksikön perustiedoista muodostuu viisi hakua sekä aineisto- että ylläpitomaksutaulukoon.

  1. Rekisteriyksikön perustiedot
  2. Rekisteriyksikön 3D-ominaisuustiedot
  3. Määräalan perustiedot
  4. Käyttöoikeusyksikön osan ominaisuustiedot
  5. Käyttöoikeusyksikön perustiedot
  6. Käyttöoikeusyksikön viranomaispäätökset
  7. Rekisteriyksikön yhteisalueosuudet
  8. Rekisteriyksikön voimassa olevat muodostuneet

Alla olevilla tuotteilla on tuotekohtainen hinta, näistä ei kerry ylläpitomaksua.

26. Tiekunnan yhteystiedot (tuotekohtaisesti hinta/tiekunta) 
27. Rantakunnan yhteystiedot (tuotekohtaisesti hinta/rantakunta)

Taulukossa esitetään ylläpito- ja aineistomaksujen suuruus tietyillä hakumäärillä. Maksu määräytyy todellisten hakumäärien mukaan.

Hakumäärä (hakuja vuodessa)Ylläpitomaksu(euroa vuodessa)Aineistomaksut(euroa vuodessa)
 Hinta € (ilman alv.)Hinta € (sis. alv.)Hinta € (ilman alv.)Hinta € (sis. alv.)
50035,31 €44,31 €247,17 €310,20 €
100047,08 €59,09 €341,33 €428,37 €
200070,62 €88,63 €482,57 €605,63 €
5 000105,93 €132,94 €765,05 €960,14 €
10 000153,01 €192,03 €1 082,84 €1 358,96 €
20 000223,63 €280,66 €1 541,87 €1 935,05 €
50 000341,33 €428,37 €2 436,39 €3 057,67 €
100 000494,34 €620,40 €3 436,84 €4 313,23 €
200 000694,43 €871,51 €4 861,01 €6 100,57 €
500 0001 094,61 €1 373,74 €7 685,81 €9 645,69 €
1 000 0001 541,87 €1 935,05 €10 875,48 €13 648,73 €
2 000 0002 177,45 €2 732,70 €15 383,39 €19 306,15 €
5 000 0003 436,84 €4 313,23 €24 328,59 €30 532,38 €
10 000 0004 872,78 €6 115,34 €34 403,71 €43 176,66 €
20 000 0006 885,45 €8 641,24 €48 645,41 €61 049,99 €

 

TuoteHinta € (ilman alv.)Hinta € (sis. alv.)
8700 Minimimaksu235,40 €295,43
8728 Rantakunnan yhteystiedot (tuotekohtaisesti hinta/rantakunta)1,80 €Ei arvonlisäveroa
8727 Tiekunnan yhteystiedot (tuotekohtaisesti hinta/tiekunta)1,80 €Ei arvonlisäveroa

Avoimet tuotteet (API avain)

Avoimet tuotteet (API avain) rajapintapalvelua saa käyttää vapaasti ja maksutta testaukseen sekä tuotantoon. Avoimen rajapintapalvelun käyttöön vaaditaan API-avain. Lue lisää API-avaimen luomisesta ja käyttämisestä.

PalveluTuotteetKäyttäjätunnistusPalveluosoite
Avoimet tuotteet (API-avain)Avoimet, SimpleAPI-avainhttps://avoin-paikkatieto.maanmittauslaitos.fi/kiinteisto-avoin/simple-features/v3/ 
    

Avoimesta rajapintapalvelusta on saatavilla vain simple-muotoisia tuotteita. Tietosisältö on kuvattu tarkemmin teknisessä kuvauksessa.

Avoimet tuotteet (sopimus)

Avoimen rajapintapalvelun lisäksi avoimia tuotteita on saatavilla myös sopimuspalveluna. Jos teet sopimuksen avoimien paikkatietojen kyselypalvelusta, saat samalla sopimuksella mahdollisuuden käyttää muitakin avoimien paikkatietojen kyselypalveluita. Sopimus on voimassa toistaiseksi.

Sopimuspalvelusta on saatavilla sekä simple- että comblex-muotoisia tuotteita.

Avoimien paikkatietojen kyselypalvelun sopimukseen kuuluvat, ja tällä hetkellä käytössä olevat palvelut:

Avoimien paikkatietojen kyselypalvelun sopimukseen kuuluvat, mutta myöhemmin sopimukselliseen käyttöön tulevat palvelut:

Tiedotamme palvelujen liittämisestä sopimukselliseen rajapintapalveluun.

Jos olet kiinnostunut palvelusta, ota yhteyttä verkkopalveluiden asiakastukeen osoitteeseen: verkkopalvelut@maanmittauslaitos.fi

PalveluTuotteetKäyttäjätunnistusPalveluosoite
Avoimet tuotteet, SopimusAvoimet Simple - tuotteetKäyttäjätunnushttps://sopimus-paikkatieto.maanmittauslaitos.fi/kiinteisto-avoin/simple-features/v3/
Avoimet tuotteet, SopimusKaikki avoimetKäyttäjätunnushttps://sopimus-paikkatieto.maanmittauslaitos.fi/kiinteisto-avoin/features/v3/

Tietosisältö on kuvattu tarkemmin teknisessä kuvauksessa.

Luvanvaraiset tuotteet (sopimus)

Luvanvaraisten tuotteiden käyttö edellyttää KTJ-lain mukaista lupaa ja palvelun käyttöönotto sopimusta Maanmittauslaitoksen kanssa.

Luvanvaraisten tuotteiden käyttö edellyttää myös tietoturvavaatimusten täyttämistä, mm. tietojen käytön lokittamista. Lokitiedoista täytyy pystyä selvittämään:

  • kuka henkilö on käyttänyt tietoja,
  • mitä tietoja ja
  • milloin.

Lokitiedot tulee toimittaa Maanmittauslaitokselle. Helpointa ne on toimittaa tietojen haussa käytettävän rajapintakyselyn mukana henkilön yksilöivänä tunnisteena. Eli HTTP-standardin mukaisessa Request Header-kentässä, joka on nimeltään "enduserid". Lue tarkemmin loppukäyttäjen lokituksesta teknisestä kuvauksesta Toinen vaihtoehto on toimittaa lokitiedot tiedostona Maanmittauslaitokselle kaksi kertaa vuodessa.

Jos olet kiinnostunut palvelusta, ota yhteyttä verkkopalveluiden asiakastukeen: verkkopalvelut@maanmittauslaitos.fi. Verkkopalveluiden tuki lähettää sinulle hakemuslomakkeen ja tietoturvaliitteen täytettäväksi. Hakemuslomakkeesta ja tietoturvaliitteestä käy ilmi tarkemmat tietoturvavaatimukset.

PalveluTuotteetKäyttäjätunnistusPalveluosoite
Luvanvaraiset tuotteet (sopimus)Avoimet ja luvanvaraiset Simple -tuotteetKäyttäjätunnushttps://sopimus-paikkatieto.maanmittauslaitos.fi/kiinteisto-luvanvarainen/simple-features/v3/
Luvanvaraiset tuotteet (sopimus)

Kaikki avoimet ja luvanvaraiset tuotteet

ei kuitenkaan henkilötietoja

Käyttäjätunnus

 

 

https://sopimus-paikkatieto.maanmittauslaitos.fi/kiinteisto-luvanvarainen/features/v3/

Luvanvaraiset tuotteet (sopimus)

Kaikki avoimet ja luvanvaraiset tuotteet

myös henkilötietoja sisältävät tuotteet

Käyttäjätunnus (vaatii oikeuden henkilötietoihin)https://sopimus-paikkatieto.maanmittauslaitos.fi/kiinteisto-luvanvarainen/features/v3/

Palvelu sisältää myös avoimet tuotteet. Tietosisältö on kuvattu tarkemmin teknisessä kuvauksessa.

Rajapintapalvelujen käyttäjätunnuksen (palvelutunnus) ja salasanan käyttö

 Sopimuksen solmimisen jälkeen Maanmittauslaitos antaa asiakasorganisaatiolle käyttäjätunnuksen (palvelutunnuksen) ja salasanan. Tunnus ja salasana on tarkoitettu asiakkaan sovelluksen käyttöön. Tunnus-salasanayhdistelmä tulee tallentaa ohjelmaan niin, että sovelluksen loppukäyttäjä  ei saa sitä tietoonsa missään vaiheessa. Käyttäjien pääsyä palveluun tulee hallinnoida muulla tavoin ja varmistaa, että käyttöoikeudet palveluun ovat vain niillä henkilöillä, jotka työtehtäviensä perusteella tarvitsevat luvanvaraisia kiinteistötietoja, eikä ylimääräisiä käyttöoikeuksia jää voimaan esimerkiksi työsuhteen päättyessä tai työtehtävien vaihtuessa.  Lupa ja sopimus edellyttävät, että käyttäjien oikeudet luvanvaraisiin tietoihin ovat ajantasalla.

Avoimet tuotteet

Kiinteistötietojen kyselypalvelun (OGC API Features) avoimien tuotteiden (API-avain) palvelua voi käyttää maksutta tekniseen testaamiseen.

Luvanvaraiset tuotteet

Luvanvaraisia tuotteita voi testata koekäyttöympäristössä. Koekäyttö on maksutonta. Palvelun aineisto on testidataa ja sitä saa käyttää vain testaukseen. Testidatan pohjana on kiinteistörekisterin 12.10.2020 tilanne ja lisäksi testidata sisältää keksittyä dataa.

Koekäyttöympäristö sisältää myös avoimet tuotteet. Tietosisältö on kuvattu tarkemmin Koekäyttöympäristön teknisessä kuvauksessa.

Hae luvanvaraisten tuotteiden koekäyttöä lomakkeella.

Huom! Luvanvaraisten tuotteiden käyttöoikeuteen sisältyy aina automaattisesti myös avoimet tuotteet.

Lupa ja käyttäjätunnus koekäyttöympäristön käyttöön lähetetään hakijalle sähköpostilla. Lupa palvelun koekäyttöön on määräaikainen.

Rajapinnan tekninen tuki palvelee ma - pe klo 8 - 16. Saat tukeen yhteyden verkkolomakkeella.

Anna palautetta palvelun tuotteista, toimivuudesta ja dokumentoinnista verkkolomakkeella. Kirjaa palautteesi yhteyteen palvelun nimi.

Tutustu myös näihin