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)

Palvelun versio v1 on poistettu käytöstä lokakuussa 2023.

Tuotteet on kuvattu tarkemmin teknisessä kuvauksessa:

Tekninen kuvaus, versio v2 

Palvelun versio v1 on poistettu käytöstä lokakuussa 2023.

Tekninen kuvaus, versio v2 

 

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 235,40 € / vuosi (291,90 / vuosi, sis alv 24 %).

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

Ylläpitomaksu kattaa seuraavat palvelut:

  1. Kiinteistötietojen kyselypalvelu (OGC API Features) 
  2. Geokoodauspalvelu (REST)
  3. Rakennusten kyselypalvelu (OGC API Features)
  4. Nimistön kyselypalvelu (OGC API Features)
  5. Maastotietokannan kyselypalvelu (OGC API Features)
Hakumäärä (hakuja vuodessa)Ylläpitomaksu(euroa vuodessa)
 Ilman Alv:aALV 24 %
20 000235,40 €291,90 €
50 000341,33 €423,25 €
100 000494,34 €612,98 €
200 000694,43 €861,09 €
500 0001 094,61 €1 357,32 €
1 000 0001 541,87 €1 911,92 €
2 000 0002 177,45 €2 700,04 €
5 000 0003 436,84 €4 261,68 €
10 000 0004 872,78 €6 042,25 €
20 000 0006 885,45 €8 537,96 €
Tuote Hinta € (ilman alv.) Hinta € (sis. alv.)
2200
Paikkatietojen kyselypalvelun minimimaksu
235,40 291,90

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

Verkkopalveluiden asiakastuki palvelee sopimuksiin ja käyttölupiin liittyvissä asioissa. Ota yhteyttä asiakastukeen verkkopalvelut@maanmittauslaitos.fi tai 029 530 1119.

Ongelmia palvelun käytössä?