3D-Win / Työkalut / Verkkopalvelut
Artikkelin toiminnot 3D-Win 2023 alkaen
Julkaistu 04.10.2022
3D-Winin verkkopalveluihin on lisätty versiosta 2023.0 alkaen OAPIF haku -toiminto, jolla voidaan hakea Maanmittauslaitoksen (MML) tuottamia OGC API Features -rajapinnan palveluita. Maastotietokannan, Nimistön ja Rakennusten kyselypalvelun käyttö edellyttää API-avainta (aktivointiohje myöhemmin tässä artikkelissa). Kiinteistötietojen kyselypalvelun aktivointi edellyttää erillistä sopimusta MML:n kanssa.
Lisätietoa MML:n verkkosivuilta
- Maastotietokannan kyselypalvelu https://www.maanmittauslaitos.fi/maastotietokannan-kyselypalvelu (API-avain)
- Vektorimuotoista dataa kohdeluokista, esimerkiksi tiet, rakennukset, hallintorajat, maankäyttö, vesistö ja korkeussuhteet
- Nimistön kyselypalvelu https://www.maanmittauslaitos.fi/nimiston-kyselypalvelu-ogc-api (API-avain)
- Paikannimi- ja karttanimitietoja
- Rakennusten kyselypalvelu https://www.maanmittauslaitos.fi/rakennusten-kyselypalvelu (API-avain)
- Kansalliseen maastotietokantaan (KMTK) tallennetut kuntien ja MML:n rakennustiedot
- Kiinteistötietojen kyselypalvelusta https://www.maanmittauslaitos.fi/kiinteistotietojen-kyselypalvelu-ogc-api (Käyttäjätunnus ja salasana)
- Kiinteistörajat, kiinteistötunnukset ja rajamerkit sekä mm. määräalan keskeisiä tietoja.
OAPIF haku
Maanmittauslaitoksen OAPIF-palvelun avoimet osoitteet:
- Maastotietokannan kyselypalvelu https://avoin-paikkatieto.maanmittauslaitos.fi/maastotiedot/features/v1/
- Nimistön kyselypalvelu https://avoin-paikkatieto.maanmittauslaitos.fi/geographic-names/features/v1/
- Rakennusten kyselypalvelu https://avoin-paikkatieto.maanmittauslaitos.fi/buildings/features/v1/
3D-Win versiossa 2023.0 on lisätty oletuksena OAPIF-hakuun Maanmittauslaitoksen tuottama Maastotietokannan kyselypalvelu osoitetietoineen.
- Rajapinnan käyttö vaatii API-avaimen liittämistä palvelupyyntöihin. Wiki-artikkelista löytyy ohje API-avaimen luomiseen Maanmittauslaitoksen sivuilla.
- OAPIF-asetuksissa tulee Käyttäjä -kentään lisätä <api-key> ja Salasana -kenttään luotu API-avain
- Hae-painikkeella luot yhteyden rajapintaan ja ohjelma ilmoittaa OK.
- Kuittaa kertaalleen OK-painikkeella.
- OAPIF-hakudialogissa näkyy maastotietokannan haettavat kohdetyypit.
- Asetukset tarvitsee määritellä kertaalleen.
- OAPIF-haku käyttää GeoJSON-formaattia, jonka tulee olla määritelty lukumuuntimissa.
- Versiosta 2023.0 alkaen GeoJSON löytyy oletuksena Muuntimet -listauksesta ohjelman ensiasennuksessa. Ohjelmaversion päivityksen yhteydessä käyttäjähakemistoa ei ylikirjoiteta, jolloin muunnin tulee olla määritelty allaolevan kuvan mukaisesti.
- Tarvittaessa voit lisätä GeoJSON-muuntimen lisäämällä funktiolistauksesta GDALOGR-muuntimen, Muut ja Formaatin alasvetovalikosta GeoJSON.
MML:n Maastotietokannan kyselypalvelun kohteille voidaan määritellä tason nimen mukaisella koodi-tunnuksella oma piirtovärinsä.
- Liitteenä MTK-koodit.dat kooditiedosto, missä on esimerkin omaisesti kuvassa näkyville kohteille piirtoväri sekä pistemäisen kohteen symbolit.
- Mikäli haetaan useita kohdetyyppejä kerralla, luetaan ne satunnaisessa järjestyksessä elementtilistaan. Isoimmat alueet tulee elementtilistassa siirtää listan ylimmäisiksi, jolloin ne eivät peitä alleen pienempiä alueita.
- Elementtilistan alimmainen tiedosto piirretään näytölle päällimmäiseksi ja ylin alimmaiseksi.
Huomioitavaa on, että Maastotietokannan kyselypalvelusta luetut korkeuskäyrätiedot ja korkeusarvot ovat N60 -korkeusjärjestelmän mukaisia arvoja.
