Kiinteistökauppojen kyselypalvelu (OGC API Features)

Palvelusta on saatavilla seuraavat tuotekokonaisuudet.  Tuotekokonaisuudet eroavat toisistaan lähinnä henkilötietojen laajuuden mukaan. Tuotekokonaisuuksien ja tuotteiden sisältö on kuvattu tarkemmin teknisessä kuvauksessa. 

Kiinteistöjen kauppahintarekisterin tiedot henkilötunnuksella

• Tuotekokonaisuus on saatavilla ainoastaan viranomaisille.
• Luovutusten osapuolien tiedot:
  • Luonnolliset henkilöt: Tiedot sisältävät nimen, kansalaisuuden ja henkilötunnuksen. Tietoihin ei sisälly osoitetta.
  • Oikeushenkilöiden (juridisten henkilöiden eli yritykset ja yhteisöt): Tiedot sisältävät y‑tunnuksen, kansalaisuuden ja nimen.  Jos juridinen henkilö on luovutuksen saajana, tietoihin sisältyy myös osoite.
  • Tuntemattomat henkilöt: Tiedot sisältävät nimen, kansalaisuuden ja tunnuksen. Uudessa aineistossa tunnus voi olla esimerkiksi ulkomaalaisen osapuolen syntymäaika. Tunnus voi myös puuttua.
• Kaupanvahvistajasta esitetään tunnus, virka-asema ja nimi. 

Kiinteistöjen kauppahintarekisterin tiedot ilman henkilötunnusta

• Luovutusten osapuolien tiedot:
  • Luonnolliset henkilöt: Tiedot sisältävät nimen ja kansalaisuuden, mutta henkilötunnus ei sisälly tietoihin.
  • Oikeushenkilöiden (juridisten henkilöiden eli yritykset ja yhteisöt): Tiedot sisältävät y‑tunnuksen, kansalaisuuden ja nimen. Jos juridinen henkilö on luovutuksen saajana, tietoihin sisältyy myös osoite.
  • Tuntemattomat henkilöt: Tiedot sisältävät nimen ja kansalaisuuden, mutta tunnus ei sisälly tietoihin
• Kaupanvahvistajasta esitetään tunnus, virka-asema ja nimi. 

 Kiinteistöjen kauppahintarekisterin tiedot ilman luonnollisen henkilön tunnistetietoja

• Luovutusten osapuolien tiedot:
  • Luonnolliset henkilöt: henkilötunnus, nimi ja kansalaisuus eivät sisälly tietoihin.
  • Oikeushenkilöiden (juridisten henkilöiden eli yritykset ja yhteisöt): Tiedot sisältävät nimen ja kansalaisuuden. Luovutuksen saajina olevien juridisten henkilöiden tiedot sisältävät myös osoitteen.
  • Tuntemattomat henkilöt: Tunnus, nimi ja kansalaisuus eivät sisälly tietoihin
• Tuotekokonaisuuden tiedot katsotaan välillisesti henkilötiedoiksi, joten tietojen käsittelyssä on noudatettava tietosuojasäännöksiä.

Tekninen kuvaus

Rajapintapalvelun käyttöönotto edellyttää seuraavia asioita:

• Lupa tietojen käyttöön (KHR-laki, Laki kiinteistöjen kauppahintarekisteristä 552/1980). Tietojen käyttölupa myönnetään hakemuksen perusteella. Käyttölupa voidaan myöntää, jos tietoja tarvitaan kiinteistön arvon määrittämisessä lunastustoimituksissa, maankäytön suunnittelussa, verotuksessa, luotonannossa, kansallisen turvallisuuden varmistamisessa sekä muissa arviointi- ja tutkimustehtävissä. Käyttölupaa ei voida myöntää suoramarkkinointiin tai muuhun vastaavaan toimintaan. Suuri osa viranomaisista saa palvelun käyttöönsä ilman lupamenettelyä.
• Sopimus Maanmittauslaitoksen kanssa rajapintapalvelun käytöstä. Sopimukset ovat määrämuotoisia ja toistaiseksi voimassa olevia.
• Suomi.fi-palveluväylän käyttöönotto

Palveluväylä

Kiinteistökauppojen kyselypalvelun (OGC API Features) käyttö edellyttää Suomi.fi-palveluväylän käyttöönottoa. Tutustu palveluväylään ja sen käyttöönottoon. Huomioi, että organisaatiosi täytyy ensin liittyä Palveluväylän testiympäristöön ja vasta sen jälkeen on mahdollista siirtyä tuotantoympäristöön. 

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
• Kauppahintarekisterin tietohakujen lokitus.

Käyttäjähallinta

Asiakasorganisaation tulee järjestää tietojen käyttäjille käyttäjähallinta. Käyttäjien oikeudet luvanvaraisiin tietoihin on pidettävä ajan tasalla. Käyttöoikeuksia saa olla vain henkilöillä, jotka tarvitsevat luvanvaraisia kiinteistökauppojen tietoja työtehtävissä. Käyttöoikeudet on suljettava esimerkiksi työsuhteen päättyessä tai työtehtävien muuttuessa. 

Tietojen käytön lokitus

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

Käyttöönoton vaiheet lyhyesti

1. Tutustu Kiinteistökauppojen kyselypalvelun (OGC API Features) palvelukuvaukseen.
2. Tutustu Suomi.fi-palveluväylän kuvauksiin ja selvitä miten liityt Suomi.fi-palveluväylään tai onko organisaatiosi jo sen käyttäjä. 
3. Ota yhteyttä Maanmittauslaitoksen verkkopalveluiden asiakastukeen osoitteeseen verkkopalvelut@maanmittauslaitos.fi. Kerro viestissä:
   • millaista palvelua olet suunnittelemassa
   • millaiseen käyttötarkoitukseen tuotantopalvelun tietoja on tarkoitus hyödyntää ja
   • kuka tietoja käyttää.
4. Täytä asiakastuen toimittama hakemuslomake ja tietoturvaliite.
5. Odota hakemuksen käsittelyä. Tarvittaessa pyydämme lisätietoja.
6. Myönteisen lupapäätöksen jälkeen toimitamme rajapintapalvelun sopimuksen ja pyydämme tiedot liityntäpalvelimesta turvaviestillä. Lue ja allekirjoita sopimus sekä toimita pyydetyt tiedot organisaatiosi liityntäpalvelimesta palveluväylän kytkemistä varten. 

7. Sopimuksen solmimisen jälkeen saat rajapintapalvelun käyttäjätunnuksen (palvelutunnuksen) ja salasanan. Tallenna tunnus-salasana yhdistelmä sovellukseesi siten, ettei sovelluksen loppukäyttäjä pääse siihen missään vaiheessa käsiksi.

    

Voit käyttää Kiinteistökauppojen kyselypalvelun (OGC API Features)  koekäyttöpalvelua maksutta. 

Koekäyttöpalvelun aineisto on testidataa ja sitä saa käyttää vain testaukseen. Testidatan pohjana on kiinteistöjen kauppahintarekisterin 10/2020 tilanne, jossa kauppahinnat on muutettu ja henkilötiedot anonymisoitu ja lisäksi testidata sisältää keksittyä dataa. 

Palvelun käyttöön tarvitaan koekäyttölupa ja käyttäjätunnus. Lisäksi käyttöä varten tulee kytkeytyä Suomi.fi-palveluväylän testiympäristöön. Tutustu tarkemmin Suomi.fi-palveluväylään. Koekäyttöpalvelusta on kerrottu tarkemmin teknisessä kuvauksessa.

Koekäytön käyttöönoton vaiheet lyhyesti

1. Tutustu Kiinteistökauppojen kyselypalvelun (OGC API Features) koekäyttöpalvelun palvelukuvaukseen.
2. Tutustu Suomi.fi-palveluväylän kuvauksiin ja selvitä miten liityt Suomi.fi-palveluväylään testiympäristöön tai onko organisaatiosi jo sen käyttäjä. 
3. Ota yhteyttä Maanmittauslaitoksen verkkopalveluiden asiakastukeen osoitteeseen verkkopalvelut@maanmittauslaitos.fi. Kerro viestissä:
   • millaista palvelua olet suunnittelemassa
   • millaiseen käyttötarkoitukseen tuotantopalvelun tietoja on tarkoitus hyödyntää ja
   • kuka tietoja käyttää.
4. Pyydämme tiedot liityntäpalvelimesta erikseen turvaviestillä. Toimita pyydetyt tiedot organisaatiosi testiympäristön liityntäpalvelimesta palveluväylän kytkemistä varten. 
5. Toimitamme koekäyttöluvan ja samalla saat rajapintapalvelun käyttäjätunnuksen (palvelutunnuksen) ja salasanan. Tallenna tunnus-salasana yhdistelmä sovellukseesi siten, ettei sovelluksen loppukäyttäjä pääse siihen missään vaiheessa käsiksi. Koekäyttöpalvelun käyttöön myönnetään lupa, joka on voimassa kuusi kuukautta

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

Voit antaa palautetta palvelusta tai tällä sivustolla olevasta dokumentaatiosta palautelomakkeen kautta  (valitse yhteydenoton syyksi Palaute, sen jälkeen Rajapintapalvelut -> Kiinteistökauppojen kyselypalvelu (OGC API Features).