Tekninen kuvaus Maastotietojen kyselypalvelu (OGC API Features) BETA

Yleistä

Maastotietojen kyselypalvelu (OGC API Features) on OGC API Features-rajapintastandardiin perustuva rajapintapalvelu aineistolähteenään Maanmittauslaitoksen Kansallinen maastotietokanta (KMTK). 

Avoin rajapintayhteys on 3.6.2026 alkaen saatavilla BETA-versiona.

Avoimen rajapintayhteyden käyttö edellyttää API-avaimen liittämistä kaikkiin rajapintapyyntöihin. Myös kaikki alla mainitut osoitteet vaativat API-avainta. Voit rekisteröidä ja ylläpitää omaa API-avaintasi ohjeiden mukaisesti.

Rajapintaosoitteet

Rajapintapalvelu on saatavilla osoitteesta: https://open-api-geospatial.nls.fi/api/topodb/open-data/features/v1

Käytä tätä osoitetta OGC API Features-rajapintakutsujen juuriosoitteena. Lisäksi osoite toimii myös selailtavana rajapinnan etusivuna.

Muut tekniset kytkeytymistiedot palvelun avoimeen rajapintayhteyteen:

Paikkatietokohteet-sivun kautta tulee tarjolle lista palvelun tarjoamista tuotteista eli paikkatietokohteista (Open API Features rajapinnassa collection). Klikkaamalla paikkatietokohteen linkkiä pääset tarkastelemaan sen tukemia koordinaatistoja, kyselyparametreja ja paikkatietokohteen skeemaa.

Kyselypalvelun aineistolähteenä on Maanmittauslaitoksen Kansallinen maastotietokannan aineistot, jotka kuuluvat avoimen datan lisenssin piiriin. Palvelun aineistoa ei ajantasaisteta BETA-vaiheessa.

Palveluun liittyvät koodistot on talletettu Suomi.fi-koodistoihin.

Kehitettäessä OGC API Features -asiakassovelluksia kannattaa ensin tutustua viralliseen standardiin.

Paikkatietokohteiden skeemat

Yhden paikkatietokohteen skeeman haku: https://open-api-geospatial.nls.fi/api/topodb/open-data/features/v1/collections/road_link/schema

Skeema-haun vastaus sisältää mm. linkit Suomi.fi-koodiston selitteisiin "x-codelist-uri".

Esimerkkihaut palveluun

Yhden road_link -paikkatietokohteen haku json-muodossa: https://open-api-geospatial.nls.fi/api/topodb/open-data/features/v1/collections/road_link/items/268?f=json

Kohteiden (road_link) haku BBOX-rajauksella json-muodossa:

https://open-api-geospatial.nls.fi/api/topodb/open-data/features/v1/collections/road_link/items?bbox=24.62574005825445,61.487233704755134,24.817142493557185,61.51663746563259&f=json
 

BETA-versio 0.1, julkaisu 2026-06-03

  • Palvelua kehitetään jatkuvasti ja palvelussa on tällä hetkellä tiedossa olevia puutteita mm. HTML-käyttöliittymässä.
Olet estänyt evästeet. Jos haluat antaa palautetta tästä sivusta, hyväksy kävijämittaus- ja analytiikkaevästeet.