Rajapintapalvelujen kautta saat käyttöösi Maanmittauslaitoksen ylläpitämiä paikkatietoja. Aineistot sisältävät muun muassa paikannimet, tiet, rakennukset, osoitteet, vesistöt ja muut maaston kuviot, korkeussuhteet sekä hallintorajat.
Paikkatietojen rajapintapalvelut sopivat käyttöösi silloin, kun haluat hakea sovellukseesi yksittäisten kohteiden tietoja, esimerkiksi paikannimiä tai osoitteita. Jos tarvitset karttakuvia tai ilmakuvia, tutustu karttojen rajapintapalveluihin.
Palvelun käyttö edellyttää, että käytössäsi on ohjelmisto, joka tekee pyynnöt Maanmittauslaitoksen palvelimelle. Käytännössä tämä tarkoittaa esimerkiksi paikkatieto-ohjelmistoja tai itse ohjelmoitua sovellusta. Rajapintojen kautta saat aina ajantasaisimman tiedon eikä aineistosta tarvitse ladata kopiota omaan tietojärjestelmääsi.
Paikkatietojen rajapintapalveluiden kautta tarjottavat aineistot
Liikenneverkot, rakennukset ja rakenteet, hallintorajat, nimistö, maankäyttö, vesistöt ja korkeussuhteet |
|
Osoitteet |
|
Paikannimet | Nimistön kyselypalvelu (OGC API Features) |
Sijainnin haku osoitteen, paikannimen, kiinteistön tai karttalehden avulla |
|
Maastotietokannan rakennustietoja |
|
Väestötietojärjestelmän rakennustietoja | Rakennustietojen kyselypalvelu (WFS) |
Ortokuvat ja korkeusmalli |
|
INSPIRE-direktiivin mukaiset tietokohteet | INSPIRE kyselypalvelut (WFS) |
Muut rajapintapalvelut ja niiden sisältö
Rajapintojen kautta saa myös karttoja ja kiinteistötietoja sekä palveluita kiinteistövaihdannan ammattitoimijoille.
Maasto- ja taustakartat, ortokuvat, kiinteistörajat, karttatulosteet | Tutustu karttojen rajapinpalveluihin |
Kiinteistötiedot ja -tulosteet | |
Sähköisen kiinteistökaupan asiakirjat ja hakemukset | Tutustu kiinteistövaihdannan rajapintapalveluihin |
Palveluissa käytetyt tekniikat
Paikkatietotuotteita ja -palveluita on saatavilla eri rajapintatekniikoiden kautta.
Kyselypalvelut – WFS tai OGC API Features
Paikkatietokohteiden kyselypalvelut on toteutettu WFS (Web Feature Service) tai OGC API Features -standardilla. Sen avulla sovellus voi hakea rajapinnalta yksittäisen paikkatietokohteen, esimerkiksi rakennuksen, paikannimen tai osoitteen tietoja. Rajapinnan kautta tarjottavat tuotteet ja palvelupyynnöt on kuvattu kunkin palvelun teknisessä kuvauksessa.
Kyselypalvelu WCS
Ortokuvien ja korkeusmallien kyselypalvelu on toteutettu WCS (Web Coverage Service) -standardin avulla. Rajapinnan kautta tarjottavat tuotteet ja palvelupyynnöt on kuvattu palvelun teknisessä kuvauksessa.
REST-rajapinnat
Geokoodauspalvelu on toteutettu REST (Representational State Transfer) -tekniikalla. Rajapinnan käyttö on selostettu palvelun teknisessä kuvauksessa.
Paikkatietojen avoimet rajapinnat
Osa paikkatietojen rajapintapalveluista on avoimia. Avoimia rajapintoja voi käyttää maksutta ilman sopimusta Maanmittauslaitoksen avoimen datan lisenssillä (CC 4.0. Nimeä).
Avoimia ja maksuttomia rajapintoja ovat:
- Geokoodauspalvelu (REST)
- Maastotietokannan kyselypalvelu (OGC API Features)
- Nimistön kyselypalvelu (OGC API Features)
- Rakennusten kyselypalvelu (OGC API Features)
Näin saat avoimet rajapintapalvelut käyttöösi
- Tutustu rajapintapalveluiden kuvauksiin.
- Rakennusten, Nimistön ja Maastotietokannan kyselypalveluiden käyttö vaatii rekisteröitymisen Maanmittauslaitoksen OmaTili -palvelussa ja API-Avaimen
- Geokoodauspalvelua voit käyttää suoraan palvelun osoitteella. Osoite on kerrottu rajapinnan teknisessä kuvauksessa.
Rajapintojen sopimuskäyttö
Avoimien rajapintapalveluiden rinnalla tarjoamme myös palveluita, joiden käytöstä tehdään sopimus. Sopimuskäyttäjille tarjoamme tukipalvelut, ja mahdollisissa ruuhkatilanteissa sopimusasiakkaiden haut ovat etusijalla avoimiin rajapintoihin verrattuna.
Seuraavien rajapintojen käyttö vaatii aina sopimuksen:
Avoimen palvelun lisäksi myös sopimuskäyttö:
Näin teet sopimuksen rajapintapalvelun käytöstä
- Tutustu rajapintapalveluiden kuvauksiin.
- Ota yhteyttä sopimuksen laatimiseksi. Lisätietoja saat rajapintakuvauksen ’Tilaa käyttöösi’ -kohdasta.
- Kun sopimus on allekirjoitettu, lähetämme palvelutunnuksen ja salasanan yhteyshenkilölle.