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. Listat avoimista ja luvanvaraisista tuotteista löydät osiosta Tuotteet.

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ö)
Tuotteet

Avoimien tuotteiden lisäksi jokin seuraavista tuotekokonaisuuksista: 
1) kaikki luvanvaraiset tuotteet

2) luvanvaraiset tuotteet, joihin ei sisälly henkilötietoja

3) kiinteistön perustiedot (ei lokitusvaatimusta)

Avoimet ja luvanvaraiset tuotteet, ei tiekuntien yhteistiedot ja rantakuntien yhteystiedot tuotteita
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 ja tuotekokonaisuudet

Palvelusta on tarjolla kolme vaihtoehtoista tuotekokonaisuutta. Alla olevassa taulukossa on lueteltu tuotekokonaisuuksiin sisältyvät tuotteet ja tiedon rakenne (simple/complex). Avoimet tuotteet sisältyvät kaikkiin tuotekokonaisuuksiin.

Voit käyttää simple tuotteita, 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.

Simple tuotteita on mahdollista käyttää erillisestä palveluosoitteesta. Katso palveluosoitteet osiosta Ota käyttöösi.

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

TuoteTuotekokonaisuudetSisältää henkilö-tietojaSimpleComplexLokitus-vaatimus
 

1.

Kaikki luvan-varaiset tuotteet

2. Luvanvaraiset tuotteet, ei henkilö-tietoja sisältäviä tuotteita3. Kiinteistön perustiedot (ei lokitusvaatimusta)    
Käyttöoikeusyksikön osan sijaintitiedotxx  x x
Kunnan rekisterinpitoalueen sijaintitiedotxxx x  
Rekisteriyksikön perustiedotxxx  x 
Rekisteriyksikön 3D-ominaisuustiedotxxx  x 
Määräalan perustiedotxxx  x 
Rekisteriyksiköt hakuehdoinxxx  x 
Määräalat hakuehdoinxxx  x 
Käyttöoikeusyksikön osan ominaisuustiedotxx   xx
Käyttöoikeusyksikön perustiedotxx   xx
Käyttöoikeusyksikön viranomaispäätöksetxx   xx
Käyttöoikeusyksiköt hakuehdoinxx   xx
Käyttöoikeusyksikön osat hakuehdoinxx   xx
Rekisteriyksikön yhteisalueosuudetxxx  x 
Rekisteriyksikön voimassa olevat muodostuneetxxx  x 
Yksityistien osan sijaintitiedotxxx x  
Tiekunnan yhteystiedot   x xx
Rantakunnan yhteystiedot   x 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) luvanvaraisia tuotteita tuotekokonaisuudet sisältävät. Avoimet tuotteet sisältyvät kaikkiin tuotekokonaisuuksiin. Hakemuksessa valitaan jokin alla olevista tuotekokonaisuuksista (1-5). Lisäksi taulukossa on kerrottu, jos tuotteen haku pitää lokittaa.

Tuotteet TuotekokonaisuudetLokitus-vaati-mus
 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 yhteys-tiedot5) Kiinteistön perustiedot (ei lokitus-vaatimusta) 
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 muodostuneetxxxxx  
Yksityistien osan sijaintitiedotxxxxx 
Tiekunnan yhteystiedotxx x x
Rantakunnan yhteystiedotxx x x
       

 

Palvelun tarkempi kuvaus ja tuotemäärittelyt löytyvät teknisistä kuvauksista:

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 247,40 € / vuosi (310,49 / 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. Nimistön kyselypalvelu (OGC API Features)
  4. Maastotietokannan kyselypalvelu (OGC API Features)
Hakumäärä (hakuja vuodessa)Ylläpitomaksu(euroa vuodessa)
 Hinta € (ilman alv.)Hinta € (sis. alv.)
20 000228,60 €286,89 €
50 000361,50 €453,68 €
100 000511,20 €641,56 €
200 000723,00 €907,37 €
500 0001 143,20 €1 434,72 €
1 000 0001 616,70 €2 028,96 €
2 000 0002 286,30 €2 869,31 €
5 000 0003 615,00 €4 536,83 €
10 000 0005 112,30 €6 415,94 €
20 000 0007 229,90 €9 073,52 €
Tuote Hinta € (ilman alv.) Hinta € (sis. alv.)
2200
Paikkatietojen kyselypalvelun minimimaksu
 		247,40 310,49

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 247,40  € / vuosi (310,49  € / 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
  9. Yksityistien osan sijaintitiedot

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

27. Tiekunnan yhteystiedot (tuotekohtaisesti hinta/tiekunta)
28. 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.)
200072,30 €93,12 €180,80 €226,90 €
5 000114,30 €143,45 €285,80 €358,68 €
10 000161,70 €202,93 €404,20 €507,27 €
20 000228,60 €286,89 €571,60 €717,36 €
50 000361,50 €453,68 €903,70 €1 134,14 €
100 000511,20 €641,56 €1 278,10 €1 604,02 €
200 000723,00 €907,37 €1 807,50 €2 268,41 €
500 0001 143,20 €1 434,72 €2 857,90 €3 586,66 €
1 000 0001 616,70 €2 028,96 €4 041,70 €5 072,33 €
2 000 0002 286,30 €2 869,31 €5 715,80 €7 173,33 €
5 000 0003 615,00 €4 536,83 €9 037,40 €11 341,94 €
10 000 0005 112,30 €6 415,94 €12 780,80 €16 039,90 €
20 000 0007 229,90 €9 073,52 €18 074,80 €22 683,87 €
Tuote Hinta € (ilman alv.) Hinta € (sis. alv.)
8700
Minimimaksu
 		247,40 310,49
8728
Rantakunnan yhteystiedot (tuotekohtaisesti hinta/rantakunta)
 		2,00 Ei arvonlisäveroa
8727
Tiekunnan yhteystiedot (tuotekohtaisesti hinta/tiekunta)
 		2,00 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 247,40  € / vuosi (310,49  € / 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
  9. Yksityistien osan sijaintitiedot

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

27. Tiekunnan yhteystiedot (tuotekohtaisesti hinta/tiekunta) 
28. 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.)
50036,10 €45,31 €255,60 €320,78 €
100051,10 €64,13 €361,40 €453,56 €
200072,30 €90,61 €511,20 €641,56 €
5 000114,30 €143,32 €808,20 €1 014,29 €
10 000161,70 €202,68 €1 143,00 €1 434,47 €
20 000228,60 €286,77 €1 616,40 €2 028,58 €
50 000361,50 €453,31 €2 555,80 €3 207,53 €
100 000511,20 €641,05 €3 614,40 €4 536,07 €
200 000723,00 €906,61 €5 111,60 €6 415,06 €
500 0001 143,20 €1 433,46 €8 082,10 €10 143,04 €
1 000 0001 616,70 €2 027,33 €11 429,80 €14 344,40 €
2 000 0002 286,30 €2 867,05 €16 164,20 €20 286,07 €
5 000 0003 615,00 €4 533,06 €25 557,80 €32 075,04 €
10 000 0005 112,30 €6 410,79 €36 144,10 €45 360,85 €
20 000 0007 229,90 €9 066,25 €51 115,50 €64 149,95 €

 

TuoteHinta € (ilman alv.)Hinta € (sis. alv.)
8700 Minimimaksu247,40 €310,49
8728 Rantakunnan yhteystiedot (tuotekohtaisesti hinta/rantakunta)2,00 €Ei arvonlisäveroa
8727 Tiekunnan yhteystiedot (tuotekohtaisesti hinta/tiekunta)2,00 €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ä.

Palveluosoite

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

Palveluosoitteet

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)

Rajapintapalvelun käyttöönotto edellyttää sopimusta Maanmittauslaitoksen kanssa sekä KTJ-lain (Laki kiinteistötietojärjestelmästä) mukaista käyttölupaa. Palvelun käyttölupa myönnetään hakemuksen perusteella. Käyttölupa voidaan myöntää, mikäli tietoja tarvitaan

  • yhdyskuntasuunnittelua,
  • kiinteistönvälitystä,
  • luoton myöntämistä tai valvontaa tai
  • muuta näihin verrattavaa kiinteistöihin liittyvää tarkoitusta varten.

Käyttölupaa ei voida myöntää suoramarkkinointiin tai muuhun vastaavaan toimintaan. Suuri osa viranomaisista saa palvelun käyttöönsä ilman lupamenettelyä.

Käyttöönotto

  1. Ota yhteyttä sähköpostitse verkkopalveluiden asiakastukeen osoitteeseen verkkopalvelut(at)maanmittauslaitos.fi. Kirjoita viestiin millaisessa sovelluksessa ja käyttötarkoituksessa kiinteistötietoja on tarkoitus käyttää.
  2. Asiakastuki toimittaa sinulle hakemuslomakkeen ja tietoturvaliitteen täytettäväksi.
  3. Harkitsemme käyttöluvan myöntämistä tapauskohtaisesti hakemuksessa ja tietoturvaliitteessä annettujen tietojen pohjalta. Tarvittaessa pyydämme lisätietoja.
  4. Jos luvan ehdot täyttyvät, toimitamme sopimuksen tutustuttavaksi ja allekirjoitettavaksi. Sopimukset ovat määrämuotoisia ja toistaiseksi voimassa olevia.
  5. Sopimuksen solmimisen jälkeen Maanmittauslaitos luovuttaa asiakasorganisaatiolle käyttäjätunnuksen (palvelutunnuksen) ja salasanan. Tunnus-salasanayhdistelmä tulee tallentaa asiakkaan sovellukseen niin, että sovelluksen loppukäyttäjä ei saa sitä tietoonsa missään vaiheessa.

Ota huomioon tietoturva- ja tietosuojavaatimukset

Lupa ja sopimus edellyttävät tietoturva- ja tietosuojavaatimusten täyttämistä. Tietoturvaliitteessä kysymme mm. miten organisaatiossanne hoidetaan tämän palvelun osalta:

  • henkilötietojen käsittely,
  • organisaation käyttäjä- ja pääsynhallinta ja
  • KTJ-tietojen haun lokitus.

Käyttäjähallinta

Asiakasorganisaation tulee järjestää tietojen käyttäjille käyttäjähallinta. Käyttäjien oikeudet luvanvaraisiin tietoihin tulee pitää ajantasalla. Käyttöoikeudet palveluun saa olla vain niillä henkilöillä, jotka työtehtäviensä perusteella tarvitsevat luvanvaraisia kiinteistötietoja. Käyttöoikeudet täytyy sulkea esimerkiksi työsuhteen päättyessä tai työtehtävien vaihtuessa. 

Tietojen käytön lokitus

Organisaation tulee järjestää tietojen haun lokitus ja lokien säilytys. Lokitiedoista tulee käydä ilmi, kuka henkilö on hakenut tietoja, mitä tietoja ja milloin.

Kiinteistön perustiedot -tuotekokonaisuuden tietojen käyttöä ei tarvitse lokittaa.

Lokien säilytyksen lisäksi lokitiedot täytyy toimittaa Maanmittauslaitokselle. Ensisijaisesti toivomme, että toimitatte loppukäyttäjätiedon jokaisessa rajapintakyselyssä. 

Palveluosoitteet

Palvelu/tuotekokonaisuudetTuotteetKäyttäjätunnistusPalveluosoite
  1. Luvanvaraiset tuotteet
  2. Luvanvaraiset tuotteet, ei henkilötietoja sisältäviä tuotteita
  3. Kiinteistön perustiedot (ei lokitusvaatimusta)

Kaikki avoimet ja luvanvaraiset simple- ja complex-tuotteet tuotekokonaisuuden mukaisessa laajuudessa

 

Käyttäjätunnus https://sopimus-paikkatieto.maanmittauslaitos.fi/kiinteisto-luvanvarainen/features/v3/
  1. Luvanvaraiset tuotteet
  2. Luvanvaraiset tuotteet, ei henkilötietoja sisältäviä tuotteita
  3. Kiinteistön perustiedot (ei lokitusvaatimusta)
Vain simple -tuotteet (avoimet ja luvanvaraiset)  tuotekokonaisuuden mukaisessa laajuudessaKäyttäjätunnushttps://sopimus-paikkatieto.maanmittauslaitos.fi/kiinteisto-luvanvarainen/simple-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

Olet estänyt evästeet. Jos haluat antaa palautetta tästä sivusta, hyväksy kävijämittaus- ja analytiikkaevästeet.