Tekninen kuvaus Luvanvaraiset tuotteet (koekäyttö)
Palvelussa voi koekäyttää Kiinteistörekisterin luvanvaraisia tuotteita kohteista rekisteriyksikkö, määräala, käyttöoikeusyksikkö (mm. yksityistiet) ja kunnan rekisterinpitoalue. Lisäksi palvelu sisältää kiinteistörekisterin avoimet tuotteet (ml. kiinteistöjaotus).
Palvelussa voi lisäksi tarkastella omassa osoitepolussaan henkilötietoja sisältävien tuotteiden (TiekunnanYhteystiedot ja RantakunnanYhteystiedot) staattisia kuvitteellisia esimerkkejä. Esimerkkejä on koekäytössä 9 kpl kummastakin tuotteesta. Kyseisten tuotteiden käyttäminen tuotannossa vaatii oikeuden henkilötietoihin. Tuotannossa ko. tuotteet ovat samassa osoitepolussa kuin muutkin luvanvaraiset tuotteet ja ovat kysyttävissä aina, kun tiekunta tai rantakunta on olemassa.
Palvelun aineisto on testidataa ja sitä saa käyttää vain testaukseen. Testidatan pohjana on kiinteistörekisterin 21.3.2023 tilanne ja lisäksi testidata sisältää keksittyä dataa.
Tuotteiden testaamiseen tarvitset koekäyttöluvan ja käyttäjätunnuksen. Myös pelkkien avoimien tuotteiden koekäyttö on mahdollista. Katso lisää kohdasta ’Koekäyttö’.
Luvanvaraiset tuotteet (Koekäyttö)- rajapintapalvelua käytetään teknisesti samoin kuin tuotannollista palvelua, mutta eri palveluosoitteista.
Tutustu tuotannollisen palvelun tekniseen kuvaukseen täällä: Tekninen kuvaus: Luvanvaraiset tuotteet. Korvaa tuotannollisen palvelun teknisessä ohjeistuksessa mainitut palveluosoitteet alla olevassa taulukossa mainitulla koekäytön palveluosoitteella: https://koekaytto-paikkatieto.maanmittauslaitos.fi/kiinteisto-luvanvarainen/features/v3/
Tiekunnan yhteystiedot ja Rantakunnan yhteystiedot-tuotteiden käytöstä on erilliset ohjeet jäljempänä.
Tuotannollisen palvelun tekninen kuvaus sisältää myös tuotteiden kuvaukset.
Koekäytettävä palvelu on saatavilla OGC API Features-standardin mukaisena seuraavista osoitteista:
| Palvelu | Käyttäjätunnistus | Palveluosoite | API-kuvaus | Tuotteet |
|---|---|---|---|---|
Luvanvarainen (koekäyttö), Simple | Käyttäjätunnus | https://koekaytto-paikkatieto.maanmittauslaitos.fi/kiinteisto-luvanvarainen/simple-features/v3/ | API | Luvanvaraiset ja avoimet simple-tuotteet (ei henkilötietoja) |
Luvanvarainen (koekäyttö), kaikki ilman henkilötietoja | Käyttäjätunnus | https://koekaytto-paikkatieto.maanmittauslaitos.fi/kiinteisto-luvanvarainen/features/v3/ | API | Kaikki luvanvaraiset ja avoimet tuotteet (ei henkilötietoja) |
| Luvanvarainen (staattiset esimerkit) | Käyttäjätunnus | https://koekaytto-paikkatieto.maanmittauslaitos.fi/kiinteisto-luvanvarainen/examples/v3/ | kts. ohjeet käytöstä alempaa | Tiekunnan yhteystiedot ja Rantakunnan yhteystiedot (kuvitteelliset tiedot)
|
Esimerkkejä asiakassovelluksista
Luvanvarainen (koekäyttö), Simple:
Voit käyttää Simple – muotoisia tuotteita esim. QGIS- tai GDAL-ohjelmistoissa tms. sekä sovelluksissa, joissa keskeisintä on kiinteistöjaotuksen (sisältäen myös määräalat), käyttöoikeusyksiköiden (mm. yksityistiet) ja kunnan rekisterinpitoalueiden sijaintitietojen esittäminen.
Luvanvarainen (koekäyttö), kaikki ilman henkilötietoja:
Käyttö sovellusintegraatioissa, joissa hyödynnetään myös palvelun monimuotoisia tuotteita (esim. rekisteriyksikön tai palstan laajat sijaintitiedot) tai laajempia ominaisuustietoja (esim. rekisteriyksikön, määräalan tai käyttöoikeusyksikön perustiedot).
Alla muutamia esimerkkikyselyitä koekäyttöön. Lisää esimerkkejä löytyy tuotannollisen palvelun teknisestä dokumentaatiosta. Korvaa tuotannollisen palvelun dokumentaatiossa esiintyvä kulloinenkin palveluosoite koekäytön osoitteella.
Kiinteistörajojen selailu kartalla: kiinteistörajat bbox-suorakaiderajauksella (ETRS-TM35FIN koordinaateilla)
Perustiedot rekisteriyksiköstä annetussa pisteessä (ETRS-TM35FIN koordinaatilla kysyttynä)
Kohteiden määrän kysyminen
Kohteiden määrän kysymiseen käytetään HEAD-operaatiota. Palautuvissa tiedoissa on mukana OGC-headerit.
Annetusta kyselystä voi etukäteen selvittää, kuinka monta kohdetta sen rajausehtoihin kaikenkaikkiaan osuu (OGC-NumberMatched) ja kuinka monta kohdetta palvelu ensimmäisen kyselyn osajoukkona palauttaisi (OGC-NumberReturned).
Esim. Halutaan tietää, kuinka monta kohdetta täyttää seuraavan kyselyn rajausehdot: kysytään Espoon (kuntatunnus=049) voimassaolevista (olotila=1) rekisteriyksiköistä avoimet ominaisuustiedot. Tehdään HEAD-kysely:
curl -u USERNAME:PASSWD -I "https://koekaytto-paikkatieto.maanmittauslaitos.fi/kiinteisto-luvanvarainen/features/v3/collections/RekisteriyksikonAvoimetOminaisuustiedot/items?kuntatunnus=049&olotila=1"
Esimerkit tuotteiden Tiekunnan yhteystiedot ja Rantakunnan yhteystiedot käytöstä
Koekäytössä voi tarkastella omassa osoitepolussaan henkilötietoja sisältävien tuotteiden (TiekunnanYhteystiedot ja RantakunnanYhteystiedot) staattisia kuvitteellisia esimerkkejä.
Esimerkkejä on 9 kappaletta kummastakin tuotteesta ja ne on kuvattu alempana olevissa taulukoissa. Koekäytössä Yhteystiedot-tuotteet ovat saatavissa vain taulukoiden tapauksista.
Kyseisten tuotteiden käyttäminen tuotannossa vaatii oikeuden henkilötietoihin. Tuotannossa ko. tuotteet ovat samassa osoitepolussa kuin muutkin luvanvaraiset tuotteet ja ovat kysyttävissä aina, kun tiekunta tai rantakunta on olemassa.
Tiekunnan yhteystiedot (TiekunnanYhteystiedot) tuotteen käyttöesimerkki:
TiekunnanYhteystiedot-tuotetta kutsutaan tiekunnan id-arvolla, jonka saa tuotteelta KayttooikeusyksikonPerustiedot. Eli ensin on haettava halutuilla hakuehdoilla tuotteen KayttooikeusyksikonPerustiedot avulla tiekunnallinen käyttöoikeusyksikkö (yleisimmin tiekunnallinen yksityistie), josta ollaan kiinnostuneita. Kun haluttu käyttöoikeusyksikkö on saatu, niin sen tiedoissa olevan tiekunnan id:n avulla pääsee tuotteelle TiekunnanYhteystiedot.
Tuotteella KayttooikeusyksikonPerustiedot on käytössä monipuoliset hakuehdot.
Jos yhtenä hakuparametrina käyttää parametria tiekunnallisuus=1, niin silloin palautuu vain tiekunnallisia käyttöoikeusyksiköitä (mm. tiekunnalliset yksityistiet).
Lisäksi voi luonnollisesti rajata muillakin hakuehdoilla esim. sijainnilla. Käyttöoikeusyksiköllä on tiekunta silloin, kun KayttooikeusyksikonPerustiedot-tuotteella olevan tiedon tiekunnallisuus arvo on 1.
Taulukon esimerkeissä käyttöoikeusyksikkö on haettu käyttöoikeusyksikkötunnuksen avulla (tuotteella KayttooikeusyksikonPerustiedot) ja sen jälkeen kysytään sitä vastaavan tiekunnan yhteystietoja (tuotteella TiekunnanYhteystiedot).
| KayttooikeusyksikonPerustiedot | TiekunnanYhteystiedot |
|---|---|
Haku käyttöoikeusyksikkötunnuksella Y2000-37088 Vastauksesta löytyy tiekunnan id 94615362 kohdasta KayttooikeusyksikonPerustiedot($.properties.tiekunta[0].id)
| Yhteystietotuotteen haku tiekunnan id:lla 94615362
|
Haku käyttöoikeusyksikkötunnuksella Y2004-23544 Vastauksesta löytyy tiekunnan id 141177706 kohdasta KayttooikeusyksikonPerustiedot($.properties.tiekunta[0].id) | Yhteystietotuotteen haku tiekunnan id:lla 141177706 |
Haku käyttöoikeusyksikkötunnuksella Y1999-5955 Vastauksesta löytyy tiekunnan id 177497075 kohdasta KayttooikeusyksikonPerustiedot($.properties.tiekunta[0].id) | Yhteystietotuotteen haku tiekunnan id:lla 177497075 |
Haku käyttöoikeusyksikkötunnuksella 000-2006-K010370 Vastauksesta löytyy tiekunnan id 177697987 kohdasta KayttooikeusyksikonPerustiedot($.properties.tiekunta[0].id) | Yhteystietotuotteen haku tiekunnan id:lla 177697987 Y-tunnuksellisista yhteyshenkilöistä esitetään vain nimi. |
Haku käyttöoikeusyksikkötunnuksella Y1999-20302 Vastauksesta löytyy tiekunnan id 305570485 kohdasta KayttooikeusyksikonPerustiedot($.properties.tiekunta[0].id) | Yhteystietotuotteen haku tiekunnan id:lla 305570485
|
Haku käyttöoikeusyksikkötunnuksella 000-2007-K010859 Vastauksesta löytyy tiekunnan id 191090592 kohdasta KayttooikeusyksikonPerustiedot($.properties.tiekunta[0].id) | Yhteystietotuotteen haku tiekunnan id:lla 191090592 |
Haku käyttöoikeusyksikkötunnuksella 000-2020-K009764 Vastauksesta löytyy tiekunnan id 386737614 kohdasta KayttooikeusyksikonPerustiedot($.properties.tiekunta[0].id) | Yhteystietotuotteen haku tiekunnan id:lla 386737614 |
Haku käyttöoikeusyksikkötunnuksella 000-2007-K027470 Vastauksesta löytyy tiekunnan id 196394888 kohdasta KayttooikeusyksikonPerustiedot($.properties.tiekunta[0].id) | Yhteystietotuotteen haku tiekunnan id:lla 196394888 |
Haku käyttöoikeusyksikkötunnuksella 000-2007-K027434 Vastauksesta löytyy tiekunnan id 196369720 kohdasta KayttooikeusyksikonPerustiedot($.properties.tiekunta[0].id) | Yhteystietotuotteen haku tiekunnan id:lla 196369720 |
Rantakunnan yhteystiedot (RantakunnanYhteystiedot) tuotteen käyttöesimerkki:
RantakunnanYhteystiedot-tuotetta kutsutaan rantakunnan id-arvolla, jonka saa tuotteelta KayttooikeusyksikonPerustiedot. Eli ensin on haettava halutuilla hakuehdoilla tuotteen KayttooikeusyksikonPerustiedot avulla rantakunnallinen käyttöoikeusyksikkö, josta ollaan kiinnostuneita. Kun haluttu käyttöoikeusyksikkö on saatu, niin sen tiedoissa olevan rantakunnan id:n avulla pääsee tuotteelle RantakunnanYhteystiedot.
Tuotteella KayttooikeusyksikonPerustiedot on käytössä monipuoliset hakuehdot.
Jos yhtenä hakuparametrina käyttää parametria rantakunnallisuus=1, niin silloin palautuu vain rantakunnallisia käyttöoikeusyksiköitä.
Lisäksi voi luonnollisesti rajata muillakin hakuehdoilla esim. sijainnilla. Käyttöoikeusyksiköllä on rantakunta silloin, kun KayttooikeusyksikonPerustiedot-tuotteella olevan tiedon rantakunnallisuus arvo on 1.
Taulukon esimerkeissä käyttöoikeusyksikkö on haettu käyttöoikeusyksikkötunnuksen avulla (tuotteella KayttooikeusyksikonPerustiedot) ja sen jälkeen kysytään sitä vastaavan rantakunnan yhteystietoja (tuotteella RantakunnanYhteystiedot).
| KayttooikeusyksikonPerustiedot | RantakunnanYhteystiedot |
|---|---|
Haku käyttöoikeusyksikkötunnuksella Y2000-36340 Vastauksesta löytyy rantakunnan id 89704284 kohdasta KayttooikeusyksikonPerustiedot($.properties.tiekunta[0].id)
| Yhteystietotuotteen haku rantakunnan id:lla 89704284
|
Haku käyttöoikeusyksikkötunnuksella 000-2019-K008395 Vastauksesta löytyy rantakunnan id 416656444 kohdasta KayttooikeusyksikonPerustiedot($.properties.tiekunta[0].id) | Yhteystietotuotteen haku rantakunnan id:lla 416656444 |
Haku käyttöoikeusyksikkötunnuksella Y1999-17059 Vastauksesta löytyy rantakunnan id 74806910 kohdasta KayttooikeusyksikonPerustiedot($.properties.tiekunta[0].id) | Yhteystietotuotteen haku rantakunnan id:lla 74806910 |
Haku käyttöoikeusyksikkötunnuksella Y2000-15289 Vastauksesta löytyy rantakunnan id 87679878 kohdasta KayttooikeusyksikonPerustiedot($.properties.tiekunta[0].id) | Yhteystietotuotteen haku rantakunnan id:lla 87679878 Vastauksessa ei ole ollenkaan yhteyshenkilön tietoja. Yhteyshenkilöä ei ole tallennettu tai yhteyshenkilön tiedot eivät muuten ole esittämiskelpoiset. |
Haku käyttöoikeusyksikkötunnuksella Y2000-15476 Vastauksesta löytyy rantakunnan id 416230304 kohdasta KayttooikeusyksikonPerustiedot($.properties.tiekunta[0].id) | Yhteystietotuotteen haku rantakunnan id:lla 416230304 |
Haku käyttöoikeusyksikkötunnuksella 000-2011-K044447 Vastauksesta löytyy rantakunnan id 357186696 kohdasta KayttooikeusyksikonPerustiedot($.properties.tiekunta[0].id) | Yhteystietotuotteen haku rantakunnan id:lla 357186696 |
Haku käyttöoikeusyksikkötunnuksella 000-2011-K038944 Vastauksesta löytyy rantakunnan id 416230307 kohdasta KayttooikeusyksikonPerustiedot($.properties.tiekunta[0].id) | Yhteystietotuotteen haku rantakunnan id:lla 416230307 |
Haku käyttöoikeusyksikkötunnuksella 000-2018-K008253 Vastauksesta löytyy rantakunnan id 364290329 kohdasta KayttooikeusyksikonPerustiedot($.properties.tiekunta[0].id) | Yhteystietotuotteen haku rantakunnan id:lla 364290329 |
Haku käyttöoikeusyksikkötunnuksella 000-2018-K009523 Vastauksesta löytyy rantakunnan id 364590086 kohdasta KayttooikeusyksikonPerustiedot($.properties.tiekunta[0].id) | Yhteystietotuotteen haku rantakunnan id:lla 364590086 |
Yhteiset testikiinteistöt eri koekäyttöpalveluissa
Kiinteistötietojen kyselypalvelun (OGC API Features) koekäyttöpalvelun aineistossa on 5 testikiinteistöä, joiden tiedot löytyvät myös Digi- ja väestötietoviraston ylläpitämästä testiaineistopalvelusta. Testiaineistossa on käytetty testikuntatunnusta 998. Vastaavat testikiinteistöt löytyvät myös Kiinteistötietojen kyselypalvelun (REST) ja Kiinteistötietojen tulostepalvelun koekäyttöpalvelusta.
- 998-503-4-3 (tila)
- 998-3-27-1 (tontti)
- 998-3-27-2 (tontti)
- 998-3-27-3 (tontti)
- 998-3-27-4 (tontti)
Testiaineistopalvelu on Digi- ja väestötietoviraston, Patentti- ja rekisterihallituksen, Maanmittauslaitoksen sekä Verohallinnon yhteishanke.
Seuraavassa esimerkkikysely Kiinteistötietojen kyselypalvelun (OGC API Features) koekäyttöpalveluun, jossa haetaan testikiinteistön 998-503-4-3 kaikki palstat sijainteineen (PalstanSijaintitiedot-kohteet). Esimerkkikyselyssä koordinaatit halutaan tulostaa ETRS-TM35FIN koordinaatistoon.
https://koekaytto-paikkatieto.maanmittauslaitos.fi/kiinteisto-luvanvarainen/features/v3/collections/PalstanSijaintitiedot/items?kiinteistotunnuksenEsitysmuoto=998-503-4-3&crs=http://www.opengis.net/def/crs/EPSG/0/3067
Versiohallinta
Julkaisu 16.11.2023
- Koordinaatiston EPSG:4326 axis order EPSG-standardin mukaiseksi. Jos asiakassovelluksessa pyydetään crs-parametria käyttäen tulostusta EPSG:4326-koordinaatistoon, niin koordinaatit tulostuvat vastaukseen jatkossa järjestyksessä NE. Mikäli tekee sijaintikyselyitä koordinaatistossa EPSG:4326 käyttäen parametria bbox-crs tai filter-crs, niin koordinaatit annetaan kyselyyn jatkossa järjestyksessä NE.
- Muiden koordinaatistojen osalta ei tapahdu muutoksia. Myös oletuskoordinaatiston CRS84 osalta ei tapahdu mitään muutosta.
- Tullut uutena mahdollisuus kysyä niitä käyttöoikeusyksiköitä, joissa määräala on oikeutettuna. Tuotteille KayttooikeusyksikonPerustiedot ja KayttooikeusyksikotHakuehdoin tullut tätä varten uudet kyselyparametrit maaraalatunnus ja maaraalatunnuksenEsitysmuoto
- Tullut uutena mahdollisuus kysyä niitä käyttöoikeusyksikön osia, joissa määräala on oikeutettuna. Tuotteille KayttooikeusyksikonOsanSijaintitiedot, KayttooikeusyksikonOsanOminaisuustiedot ja KayttooikeusyksikonOsatHakuehdoin tullut tätä varten uudet kyselyparametrit maaraalatunnus ja maaraalatunnuksenEsitysmuoto
Julkaisu 11.10.2023 Julkaistu uusi tuote Rekisteriyksikön voimassa olevat muodostuneet
Palvelun aineistoa (testidataa) päivitetty 31.3.2023. Testidatan pohjaksi päivitetty kiinteistörekisterin 21.3.2023 tilanne. Lisäksi testidata sisältää keksittyä dataa. Aineisto on testidataa ja sitä saa käyttää vain testaukseen
Bugikorjaus 22.11.2022 PalstanLaajatSijaintitiedot-tuotteella ja RekisteriyksikonLaajatSijaintitiedot-tuotteella alikohteiden geometriat (kiinteistörajojen ja rajamerkkien geometriat) eivät tulleet pyydettyyn koordinaatistoon (oletuskoordinaatistoon tai annettuun koordinaatistoon), vaan ne tulostettiin virheellisesti aina koordinaatistoon EPSG:3067.
Bugikorjaus 24.8.2022. PalstanLaajatSijaintitiedot-tuotteen vastauksesta oli palstalta saattanut jäädä puuttumaan kiinteistörajoja (laajatSijaintitiedotKiinteistoraja-elementtejä) tietoineen
Julkaistu 06/2022