Hyppää pääsisältöön

Geokoodauspalvelu (REST)

Geokoodauspalvelu mahdollistaa sijainnin löytämisen hakusanoilla, jotka sisältävät paikannimiä, osoitteita, kiinteistötunnuksia (kiinteistötunnus ja palstan tunnuspisteen sijainti) tai karttalehtiä koko maasta. Palvelu tarjoaa myös käänteistä geokoodausta, eli lähimpien kohteiden hakemista annetuilla koordinaateilla.

Aineistolähteet koostuvat Maanmittauslaitoksen tuottamista aineistoista (paikannimet, laskennalliset tiestön osoitteet, kiinteistötunnukset ja karttalehdet) sekä Väestötietojärjestelmän rakennusten osoitteista. Tiedot aineistojen päivittymisestä voi tarkastaa kohdasta Tuotteet löytyvien linkkien kautta.

Aineistot ovat Maanmittauslaitoksen avoimen tietoaineiston Nimeä CC 4.0 -lisenssin alaisia. Väestötietojärjestelmän rakennusten osoitetietoja voi käyttää Nimeä CC 4.0 Kansainvälinen lisenssin mukaisesti.

Geokoodauspalvelu on tarkoitettu karttapalvelujen paikanhakujen toteutukseen. Palvelussa ei ole käyttörajoituksia, mutta sitä ei ole kuitenkaan tarkoitettu tietojen massamaiseen lataamiseen. Suurien aineistojen lataamiseen suosittelemme Karttapaikan Lataa paikkatietoaineistoja -osiota.

Joissain tapauksessa voi olla tarkoituksenmukaista käyttää suoraan niitä rajapintapalveluja, joiden varaan geokoodauspalvelun toiminta perustuu (katso kohta Tuotteet).

Palvelu on käytettävissä 24/7.

Sopimus vai avoin rajapintapalvelu?

Palvelu tarjotaan sekä maksuttomasti avoimena rajapintapalveluna että sopimukseen perustuvana rajapintapalveluna.

Sopimukseen perustuvassa rajapintapalvelussa Maanmittauslaitos varmistaa käyttäjille palvelun toimivuuden ja saatavuuden sekä tarjoaa käytön tukea. Palvelun käyttöön tarvitaan käyttäjätunnus ja salasana. Sopimuspalvelusta peritään voimassa olevan hinnaston mukaista hakumääräperusteista ylläpitomaksua. Tarkemmat hintatiedot ovat luettavissa kohdassa Hinnasto.

Avoimen rajapintapalvelun käytön etuna on sen nopea ja helppo käyttöönotto. Rajapintaa voi käyttää vapaasti eikä palvelussa ole käyttömäärärajoituksia. Avoimen rajapintapalvelun käyttöön vaaditaan API-avain. Lue lisää API-avaimen luomisesta ja käyttämisestä.

Avointa rajapintapalvelua voi käyttää Maanmittauslaitoksen avoimen rajapintapalvelun käyttöehtojen mukaisesti. 

Lue lisää Ota käyttöösi kohdasta.

Geokoodauspalvelu hyödyntää seuraavia aineistoja ja rajapintapalveluja:

Paikannimet 

Rakennusten osoitteet

Laskennalliset tiestön osoitteet

Kiinteistötunnukset

Karttalehdet (TM35)

Geokoodauspalvelusta on tarjolla versiot v2 ja v1. Palvelun versio v1 suljetaan lokakuussa 2023 samalla kun palvelun käyttämä Kiinteistötietojen kyselypalvelu (WFS 2.0) suljetaan. Suosittelemme käyttämään palvelun v2 versiota.

Tuotteet on kuvattu tarkemmin teknisessä kuvauksessa:

Tekninen kuvaus, versio v2 

Tekninen kuvaus , versio v1 (poistuu käytöstä 10/2023)

Geokoodauspalvelusta on tarjolla versiot v2 ja v1. Palvelun versio v1 suljetaan lokakuussa 2023 samalla kun palvelun käyttämä Kiinteistötietojen kyselypalvelu (WFS 2.0) suljetaan. Suosittelemme käyttämään palvelun v2 versiota.

Tekninen kuvaus, versio v2 

Tekninen kuvaus , versio v1 (poistuu käytöstä 10/2023)

Avoimien paikkatietojen kyselypalvelut

Palvelusta peritään hakumääräperusteista ylläpitomaksua. Maksu määräytyy todellisten hakumäärien mukaan. Taulukossa esitetään ylläpitomaksujen suuruus tietyillä hakumäärillä.

Minimimaksu on 220 € / vuosi (272,80 / vuosi, sis alv 24 %).

Palvelussa olevat tuotteet ovat maksuttomia ja maanmittauslaitoksen avoimen tietoaineiston lisenssin alaisia.

Ylläpitomaksu kattaa seuraavat palvelut:

  1. Geokoodauspalvelu (REST)
  2. Rakennusten kyselypalvelu (OGC API Features)
  3. Nimistön kyselypalvelu (OGC API Features)
  4. Maastotietokannan kyselypalvelu (OGC API Features)
  5. Kiinteistötietojen kyselypalvelu (OGC API Features) 
Hakumäärä (hakuja vuodessa) Ylläpitomaksu (euroa vuodessa)
  Ilman Alv:a ALV 24 %
500 220,00 € 272,80 €
1 000 220,00 € 272,80 €
2 000 220,00 € 272,80 €
5 000 220,00 € 272,80 €
10 000 220,00 € 272,80 €
20 000 220,00 € 272,80 €
50 000 319,00 € 395,56 €
100 000 462,00 € 572,88 €
200 000 649,00 € 804,76 €
500 000 1 023,00 € 1 268,52 €
1 000 000 1 441,00 € 1 786,84 €
2 000 000 2 035,00 € 2 523,40 €
5 000 000 3 212,00 € 3 982,88 €
10 000 000 4 554,00 € 5 646,96 €
20 000 000 6 435,00 € 7 979,40 €
Tuote Hinta € (ilman alv.) Hinta € (sis. alv.)
2200
Paikkatietojen kyselypalvelun minimimaksu
220,00 272,80

Avoimen rajapintapalvelun käyttöönotto

Saat rajapinnan maksutta käyttöösi Maanmittauslaitoksen avoimen rajapintapalvelun käyttöehtojen mukaisesti. Aineistot ovat Maanmittauslaitoksen avoimen tietoaineiston  Nimeä CC 4.0 -lisenssin alaisia. Väestötietojärjestelmän rakennusten osoitetietoja voi käyttää Nimeä 4.0 Kansainvälinen lisenssin mukaisesti.

Palvelun käyttö edellyttää API-avaimen liittämistä rajapinnan palvelupyyntöihin. API-avaimen saat käyttöösi rekisteröitymällä ja kirjautumalla Maanmittauslaitoksen OmaTili-palveluun. Tarkat ohjeet API-avaimien luomiseen ja hallintaan löydät Ohje API-avaimen käyttöön -sivulta.

Kun käytössäsi on API-avain, palvelun on saatavilla osoitteesta:  

https://avoin-paikkatieto.maanmittauslaitos.fi/geocoding/openapi.json 

 

Sopimusrajapintapalvelun käyttöönotto 

Jos haluat tehdä sopimuksen Geokoodauspalvelun käytöstä, saat samalla sopimuksella mahdollisuuden käyttää muitakin avoimia paikkatietojen kyselypalveluita. Sopimus on voimassa toistaiseksi.

Avoimien paikkatietojen kyselypalvelun sopimukseen kuuluvat, ja tällä hetkellä käytössä olevat  palvelut:

Avoimien paikkatietojen kyselypalvelun sopimukseen kuuluvat, mutta myöhemmin käyttöön tulevat palvelut:

Tiedotamme palvelujen liittämisestä sopimukselliseen rajapintapalveluun.

Jos olet kiinnostunut palvelusta, ota yhteyttä verkkopalveluiden asiakastukeen osoitteeseen verkkopalvelut@maanmittauslaitos.fi

Kun olet tehnyt sopimuksen ja saanut  käyttäjätunnuksen, palvelu on saatavilla osoitteesta:  https://sopimus-paikkatieto.maanmittauslaitos.fi/geocoding/openapi.json

 

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

Sopimuksiin ja käyttäjätunnuksiin liittyvää tukea saat osoitteesta verkkopalvelut@maanmittauslaitos.fi.

Mahdollisista häiriöistä ilmoitetaan sovellusinfossa. Palveluun tehtävistä muutoksista tiedotetaan Palvelutiedotteet -verkkosivuilla.

Sovellusten ja palveluiden tila

Tarkista sovellusten ja verkkopalveluiden tilanne ja mahdolliset häiriöt. Tietoja päivitetään ma–pe klo 8–16.15.

Verkkopalveluiden asiakastuki

Ota yhteyttä asiakastukeen: verkkopalvelut@maanmittauslaitos.fi tai 029 530 1119.

Ongelmia palvelun käytössä?