Tekninen kuvaus Kiinteistörekisterin aineistopalvelu
Skeema
Skeematiedostot .zip-pakettina
Koodistot
Määräys kiinteistötietojärjestelmän kiinteistörekisterin koodistoista lisäyksineen
Aineistojen nouto
Aineistot toimitetaan aineistonvälityshakemistoon, josta tiedot voi noutaa manuaalisesti tai automaattisesti. Hakemistoon pääsee vain käyttäjätunnuksella ja salasanalla. Aineistonvälityshakemiston osoite sekä tunnukset sen käyttöön toimitetaan ensimmäisen tilauksen yhteydessä.
- Aineistot ovat noudettavissa aina irrotuspäivän aamuna.
- Tiedot vastaavat aina irrotusajankohdan ajantasaisia rekisteritietoja.
- Aineistot jaotellaan aineistonvälityshakemistoon aineistotyypeittäin.
- Aineistot tulee ladata irrotusajankohdan mukaisessa aikajärjestyksessä.
- Tiedostot säilyvät hakemistossa 60 vuorokautta tiedoston syntymisestä.
Aineistoja voidaan hakea joko https:llä tai käyttäen webdav-tekniikkaa https:n päällä.
Rekisterinpidossa tehdyt muutokset (ylläpitotapahtumien rekisteröinnit) näkyvät aineistopalvelussa seuraavana päivänä. Perjantaina tehdyt muutokset näkyvät vasta maanantaina. Jos aineistoirrotus on tilattu esimerkiksi keskiviikoksi, se irrotetaan keskiviikon ensimmäisinä tunteina sen jälkeen, kun tiistaina rekisterinpidossa tehdyt muutokset ovat siirtyneet rekisteriin.
Aineistot ja tuotteet
Kiinteistörekisterin laajat tiedot
Rekisteriyksiköstä tulostetaan kiinteistörekisteriotetta vastaavat tiedot sekä sijaintitiedot: kohteen perustiedot, muodostumistiedot, erottamattomat määräalat, erillisinä luovutetut yhteisalueosuudet, maankäyttöpäätöstiedot, rasitteet, käyttöoikeudet, käyttörajoitukset, osuudet yhteisiin alueisiin ja erityisiin etuuksiin, kiinteistötoimitukset, viranomaispäätökset, palstat, kiinteistörajat ja rajamerkit.
Kohteet voidaan poimia kolmella eri poimintatavalla:
- Kohdetunnuksella, jolloin tulostetaan yksittäisten kohteiden tiedot
- Kuntarajauksella, jolloin tulostetaan pyydetyissä kunnissa sijaitsevien kohteiden tiedot
- Muuttuneet kohteet, jolloin tulostetaan pyydetyllä aikavälillä rekisterissä muuttuneiden kohteiden tiedot
Jokaisesta poimitusta kohteesta tulostetaan täydelliset tiedot. Jos yhtään kohdetta ei löytynyt, tulostetaan juurielementin <TietoaKiinteistorekisterista/> alle vain metatietoja.
Kun kohteet poimitaan kohdetunnuksella tai muuttuneiden kohteiden irrotuksena, tulostiedosto on pakattu tiedosto, jonka nimi on muotoa 'tilauksen nimi'_'irrotuspvm'0000.zip, eli esimerkiksi Kuusamo_toisten_ominaisuus_muutokset_201311250000.zip. Pakatun tiedoston sisällä on kaksi xml-tiedostoa: varsinainen tulostiedosto nimellä ATP_(7 numeroa)_(13 numeroa).xml ja irrotuksen metatiedot sisältävä tiedosto nimellä ATP_(7 numeroa)_(13 numeroa).META.xml. Varsinaisen tulostiedoston ja metatiedoston nimissä olevat numerot ovat keskenään samat ja muuttuvat jokaisella tiedoston irrotuskerralla.
Kun kohteet poimitaan kuntarajauksella, aineisto jaetaan osatiedostoihin kiinteistötunnuksen kuuden ensimmäisen merkin mukaan. Samaan osatiedostoon poimitaan sellaiset rekisteriyksiköt, joiden kiinteistötunnuksen kuusi ensimmäistä merkkiä ovat samat. Jokaisesta osatiedostosta muodostetaan oma pakattu tulostiedosto, jonka nimi on muotoa 'kiinteistötunnuksen kuusi ensimmäistä merkkiä'_ATP_(7 numeroa)_(13 numeroa).zip, eli esimerkiksi 740001_ATP_1820146_1386200211074.zip. Pakatun tiedoston sisällä on kaksi xml-tiedostoa: varsinainen tulostiedosto nimellä 'kiinteistötunnuksen kuusi ensimmäistä merkkiä'_ATP_(7 numeroa)_(13 numeroa).xml ja irrotuksen metatiedot sisältävä tiedosto nimellä 'kiinteistötunnuksen kuusi ensimmäistä merkkiä'_ATP_(7 numeroa)_(13 numeroa).META.xml. Pakatun tiedoston, varsinaisen tulostiedoston ja metatiedoston nimissä olevat numerot ovat keskenään samat ja muuttuvat jokaisella tiedoston irrotuskerralla.
Tuotteen skeemassa on osia, joita käytetään useassa tietopalvelutuotteessa. Tästä syystä skeemassa esiintyy myös sellaisia tietoja, joita tähän tuotteeseen ei koskaan tulosteta.
1) Tietojen poiminta kohdetunnuksella
Tulostiedostoon poimitaan hakuparametrina annettujen kohdetunnusten mukaiset rekisteriyksiköt. Jokaisesta poimitusta rekisteriyksiköstä tulostetaan täydelliset tuotteen mukaiset tiedot.
Hakuparametrit
| Nimi | Lkm | Arvot | Kommentti |
| kohdetunnus | 1..n | kiinteistötunnus | Pakollinen |
Tulostusparametrit
| Nimi | Lkm | Arvot | Kommentti |
| koordinaatisto | 1 |
Mahdolliset arvot:
|
Kaikki sijaintikohteiden koordinaatit tulostetaan valitussa koordinaatistossa.
|
2) Tietojen poiminta kuntarajauksella
Tulostiedostoon poimitaan hakuparametrina annetun kunnan kaikki voimassa olevat ja lakanneet rekisteriyksiköt. Jokaisesta poimitusta rekisteriyksiköstä tulostetaan täydelliset tuotteen mukaiset tiedot.
Hakuparametrit
| Nimi | Lkm | Arvot | Kommentti |
| kunta | 1 | kuntatunnus | Pakollinen |
Tulostusparametrit
| Nimi | Lkm | Arvot | Kommentti |
| koordinaatisto | 1 |
Mahdolliset arvot:
|
Kaikki sijaintikohteiden koordinaatit tulostetaan valitussa koordinaatistossa.
|
3) Tietojen poiminta muuttuneista kohteista
Tulostiedostoon poimitaan rekisteriyksiköt, jotka ovat muuttuneet hakuparametreissa annetulla tavalla. Jokaisesta poimitusta rekisteriyksiköstä tulostetaan täydelliset tuotteen mukaiset tiedot.
1.1. voimaan tulevia sijaintikuntamuutoksia ei toimiteta ollenkaan tällä hakutavalla. Ne voidaan toimittaa aikaisintaan 1.1. irrottamalla koko kunnan aineisto.
Vuoden aikana tehdyt yksittäiset sijaintikuntamuutokset toimitetaan tällä hakutavalla aina riippumatta siitä, onko asiakas tilannut vastuuorganisaation omat tai toisten tekemät muutokset tai sijainti- tai ominaisuusmuutokset. Tiedostoon tulostetaan aina sekä kuntaan siirtyneet että kunnasta pois siirtyneet rekisteriyksiköt.
Hakuparametrit
| Nimi | Lkm | Arvot | Kommentti |
| kunta | 1 | kuntatunnus | |
| tapahtumalaatu | 1 |
Koodiston Ktj aineistoluovutus tapahtumalaatu koodiarvot:
|
|
| muutoslaatu | 1..n |
Koodiston Ktj aineistoluovutus muutoslaatu koodiarvot:
|
|
| muutospäivämäärän alkuarvo | 1 | päivämäärä | |
| muutospäivämäärän loppuarvo | 1 | päivämäärä |
Tulostusparametrit
| Nimi | Lkm | Arvot | Kommentti |
| koordinaatisto | 1 |
Mahdolliset arvot:
|
Kaikki sijaintikohteiden koordinaatit tulostetaan valitussa koordinaatistossa.
|
Kiinteistörekisterin ominaisuustiedot
Rekisteriyksiköstä tulostetaan kohteen perustiedot, muodostumistiedot, erottamattomat määräalat, erillisinä luovutetut yhteisalueosuudet ja maankäyttöpäätöstiedot. Määräalasta ja erillisenä luovutetusta yhteisalueosuudesta tulostetaan vain kohteen perustiedot. Tuotteeseen ei sisälly sijaintitietoja.
Kohteet voidaan poimia kolmella eri poimintatavalla:
- Kohdetunnuksella, jolloin tulostetaan yksittäisten kohteiden tiedot
- Kuntarajauksella, jolloin tulostetaan pyydetyissä kunnissa sijaitsevien kohteiden tiedot
- Muuttuneet kohteet, jolloin tulostetaan pyydetyllä aikavälillä rekisterissä muuttuneiden kohteiden tiedot
Jokaisesta poimitusta kohteesta tulostetaan täydelliset tiedot. Jos yhtään kohdetta ei löytynyt, tulostetaan juurielementin <TietoaKiinteistorekisterista/> alle vain metatietoja.
Tulostiedosto on pakattu tiedosto, jonka nimi on muotoa 'tilauksen nimi'_'irrotuspvm'0000.zip, eli esimerkiksi Kuusamo_kr_ominaisuus_muuttuneet_rek_201311250000.zip. Pakatun tiedoston sisällä on kaksi xml-tiedostoa: varsinainen tulostiedosto nimellä 'tilauksen nimi'_'irrotuspvm'0000.xml ja irrotuksen metatiedot sisältävä tiedosto nimellä 'tilauksen nimi'_'irrotuspvm'0000.META.xml.
Tuotteen skeemassa on osia, joita käytetään useassa tietopalvelutuotteessa. Tästä syystä skeemassa esiintyy myös sellaisia tietoja, joita tähän tuotteeseen ei koskaan tulosteta.
Tietosisällön kuvaus
Esimerkkitiedosto (rekisteriyksikkö)
Esimerkkitiedosto (määräala)
1) Tietojen poiminta kohdetunnuksella
Tulostiedostoon poimitaan hakuparametrina annettujen kohdetunnusten mukaiset kohteet (rekisteriyksiköt ja/tai määräalat). Poimittavia kohteita voidaan rajata suodatusparametreilla. Jokaisesta poimitusta kohteesta tulostetaan täydelliset tuotteen mukaiset tiedot.
Hakuparametrit
| Nimi | Lkm | Arvot | Kommentti |
| kohdetunnus | 1..n | kiinteistötunnus, määräalatunnus | Pakollinen |
Suodatusparametrit
| Nimi | Lkm | Arvot | Kommentti |
| olotila | 0..2 |
Koodiston Olotila arvot:
|
2) Tietojen poiminta kuntarajauksella
Tulostiedostoon poimitaan hakuparametrina annetun kunnan halutun kohdelajin kaikki kohteet (rekisteriyksiköt ja/tai määräalat). Poimittavia kohteita voidaan rajata suodatusparametreilla. Jokaisesta poimitusta kohteesta tulostetaan täydelliset tuotteen mukaiset tiedot.
Hakuparametrit
| Nimi | Lkm | Arvot | Kommentti |
| kunta | 1 | kuntatunnus | Pakollinen |
| kohdelaji | 0..2 | rekisteriyksikkö tai määräala | Jos ei ole annettu, haetaan sekä rekisteriyksiköt että määräalat. |
Suodatusparametrit
| Nimi | Lkm | Arvot | Kommentti |
| olotila | 0..2 |
Koodiston Olotila arvot:
|
|
| rekisteriyksikkölaji | 0..n |
Koodiston Rekisteriyksikkolaji arvot:
|
Suodattaa rekisteriyksiköitä |
| maapinta-alan alaraja | 0..1 | Kokonaisluku neliömetreinä | Suodattaa rekisteriyksiköitä |
| maapinta-alan yläraja | 0..1 | Kokonaisluku neliömetreinä | Suodattaa rekisteriyksiköitä |
3) Tietojen poiminta muuttuneista kohteista
Tulostiedostoon poimitaan kohteet (rekisteriyksiköt ja/tai määräalat), jotka ovat muuttuneet hakuparametreissa annetulla tavalla. Poimittavia kohteita voidaan rajata suodatusparametreilla. Jokaisesta poimitusta kohteesta tulostetaan täydelliset tuotteen mukaiset tiedot.
Hakuparametrit
| Nimi | Lkm | Arvot | Kommentti |
| kunta | 0..n | kuntatunnus | Jos ei ole annettu, haetaan koko Suomesta. |
| kohdelaji | 1 | rekisteriyksikkö tai määräala | Samaan tiedostoon voidaan saada joko vain muuttuneita rekisteriyksiköitä tai vain muuttuneita määräaloja. Mikäli asiakas haluaa tiedot sekä muuttuneista rekisteriyksiköistä että muuttuneista määräaloista, tulee tehdä kaksi erillistä tilausta. |
| muutostapahtumalaji | 1..n |
Koodiston Muutostapahtumalaji arvot:
|
Pakollinen Koodiarvoilla 207, 208, 209 ja 211 haetaan vain rekisteriyksiköitä. Koodiarvolla 210 haetaan vain määräaloja. Koodiarvo 201 sisältää kaikki koodiarvojen 202-211 muutokset. Koodiarvoa 201 on tarkoitettu käytettäväksi silloin, kun kohteen muutostapahtumien hakua ja tulostusta ei haluta rajata tarkemmilla koodiarvoilla 202-211. |
| muutospäivämäärän alkuarvo | 1 | päivämäärä | Pakollinen |
| muutospäivämäärän loppuarvo | 1 | päivämäärä | Pakollinen |
Suodatusparametrit
| Nimi | Lkm | Arvot | Kommentti |
| olotila | 0..2 |
Koodiston Olotila arvot:
|
Suodattaa sekä rekisteriyksiköitä että määräaloja |
| rekisteriyksikkölaji | 0..n |
Koodiston Rekisteriyksikkolaji arvot:
|
Suodattaa rekisteriyksiköitä |
| maapinta-alan alaraja | 0..1 | Kokonaisluku neliömetreinä | Suodattaa rekisteriyksiköitä |
| maapinta-alan yläraja | 0..1 | Kokonaisluku neliömetreinä | Suodattaa rekisteriyksiköitä |
Esimerkkitiedostot
Versiohallinta
Sovellusversio 1.14 (käyttöönotto 13.2.2017)
Ennakkotiedote 24.3.2016
Tiedote 22.9.2016
Kaikki skeematiedostot zip-pakettina
Esimerkkitiedostot (viimeisin päivitys 20.11.2017: lisätty Kiinteistörekisterin ominaisuustiedot -tuotteisiin rekisteriyksiköille ja määräaloille elementti <muutostapahtumat>):
- Kiinteistörekisterin laajat tiedot, 3D-rekisteriyksiköstä
- Kiinteistörekisterin laajat tiedot, 3D-määräalasta
- Kiinteistörekisterin ominaisuustiedot, 3D-rekisteriyksiköstä
- Kiinteistörekisterin ominaisuustiedot, 3D-määräalasta
- Kiinteistörekisterin laajat tiedot
- Kiinteistörekisterin ominaisuustiedot
Virheiden hallinta
Mikäli Aineistopalvelussa (kiinteistörekisteri) on ongelmia, ilmoittaa Verkkopalveluiden asiakastuki tilanteesta tilauksen yhteydessä ilmoitetuille yhteyshenkilöille. Paluusanomassa tai ajastetussa koko kunnan irrotuksessa eli ns. määräväli-irrotuksessa on saattanut olla aineistovirheitä tai teknisistä syistä ne eivät ole muodostuneet lainkaan.
Paluusanomassa tai määräväli- irrotuksessa ollut aineistovirhe korjataan joko rekisteröinnin tehneessä kunnassa tai Maanmittauslaitoksessa. Maanmittauslaitos hoitaa korjauspyynnöt oikeille tahoille.
Aineistovirheistä huolimatta tiedostot voi ladata kuntajärjestelmään, koska aineistovirheen sisältävä kohde jää pois tiedostosta. Tiedostoon tulee mukaan vain merkintä, että virheitä on ollut. Aineistovirheet korjataan ja kohteiden tiedot ovat mukana seuraavassa onnistuneessa paluusanomassa. Määräväli-irrotuksissa voidaan aineistovirheen korjauksen jälkeen tehdä erillinen paikkaustiedosto, joka toimitetaan aineistonvälityshakemistoon. Paikkaustiedosto pitää ladata sisään irrotushetken mukaisessa aikajärjestyksessä muihin paluusanomatiedostoihin verrattuna.
Mikäli paluusanomat tai määräväli-irrotukset eivät ole teknisistä syistä muodostuneet lainkaan, ovat tiedot mukana seuraavassa onnistuneessa aineistoirrotuksessa edellisestä onnistuneesta irrotuksesta alkaen. Jos paluusanoman tai määräväli-irrotuksen tietoja kuitenkin tarvitaan ennen seuraavaa ajastettua irrotusta, voi sähköpostitse pyytää Verkkopalveluiden asiakastukea toimittamaan tiedot.
Jos huomataan että kuntajärjestelmässä joidenkin kiinteistöjen tiedoissa on virheitä suhteessa kiinteistörekisterintietoihin, voidaan niistä tehdä erillinen paikkaus. Paikkausta voi pyytää sähköpostitse Verkkopalveluiden asiakastuesta. Paikkauksia varten tarvitaan lista niiden kiinteistöjen tunnuksista, joiden tiedot tarvitaan.