KTJkii-sanomarajapintapalvelu

Kiinteistörekisterin tiedot KTJ:stä suoraan sovellukseen

Palvelurajapinnan kautta asiakkaan sovellus voi hakea tarvitsemansa kiinteistötiedot suoraan KTJ:n tietokannasta. Palvelu perustuu sovellus-sovellus-yhteyteen, jossa asiakkaan ohjelma lähettää kyselyn tietoverkon kautta suoraan Maanmittauslaitokseen. Maanmittauslaitoksen ylläpitämä KTJ-palvelu vastaanottaa kyselyn, poimii asiakkaan tarvitsemat tiedot tietokannasta ja toimittaa ne asiakkaan sovellukselle.

Haku tunnuksen tai sijainnin perusteella

Kiinteistön tiedot on mahdollista poimia joko sijaintirajauksella tai kiinteistötunnuksella. Sijaintirajaus voi olla piste, viiva, suorakaide tai monikulmio.

Tietojen haku on kaksivaiheinen. Ensin haetaan rekisteriyksikön perustiedot, joita ovat muun muassa kiinteistön tunnus, rekisteröintipäivä ja pinta-ala. Perustietojen avulla voidaan vastauksesta poimia kiinteistöt, joista halutaan lisää tietoa. Kiinteistötunnuksella voidaan sitten hakea kiinteistön laajemmat ominaisuustiedot ja sijaintiedot.

Kiinteistötietojen rajapinta perustuu Web Services -teknologiaan. Palvelut kuvataan WSDL-dokumentteina ja järjestelmät keskustelevat SOAP-protokollaa käyttäen sanomin, joiden tietokuvaukset on määritelty XML-skeemoina. Kiinteistörekisteripalvelun ja asiakkaan välillä käytetään SSL-suojattua yhteyttä, joka on varmistettu käyttäjätunnuksella ja salasanalla.

Tarkemmat kuvaukset tuotteista ja palvelusta KTJkii-sanomarajapintadokumentissa (pdf,  versio 13.2.2012).

Kuinka pääsen käyttäjäksi

KTJkii-sanomarajapintapalveluun ei oteta enää uusia asiakkaita. Nykyisille asiakkaille palvelun toiminta jatkuu toistaiseksi entiseen tapaan. Palvelu korvataan aikanaan Kiinteistötietojen kyselypalvelulla (WFS).