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.

Geokoodauspalvelu sopii karttapalvelujen hakutoiminnallisuuksien toteutukseen. Palvelussa ei ole käyttörajoituksia.

Sopimus vai avoin rajapintapalvelu?

Palvelu tarjotaan sekä maksuttomasti avoimena rajapintapalveluna että sopimukseen perustuvana rajapintapalveluna. Sopimuspalvelusta peritään voimassa olevan hinnaston mukaista hakumääräperusteista ylläpitomaksua. Tarkemmat hintatiedot 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ä sekä tarkemmat tiedot Ota käyttöösi kohdasta.

Sopimukseen perustuvassa rajapintapalvelussa Maanmittauslaitos varmistaa käyttäjille palvelun toimivuuden ja saatavuuden. Palvelulle tarjotaan myös käyttöönoton tukea. Palvelun käyttöön tarvitaan käyttäjätunnus ja salasana. Lue tarkemmat tiedot Ota käyttöösi kohdasta.

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

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

Geokoodauspalvelu hyödyntää seuraavia paikkatietoaineistoja geokoodauksen ja käänteisen geokoodauksen aineistolähteenä:

Tuotteet on kuvattu tarkemmin teknisessä kuvauksessa.

Palvelun tarkempi tekninen kuvaus.

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 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:

  • Geokoodauspalvelu

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(at)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ä?