Page History

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äänlisä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.

1. Ensiasennuksen yhteydessätehtävätasetukset:

• 3D-Win versio 2023.0 tai uudempi, asennetaan ensimmäistä kertaa työasemalle (ei päivitetä vanhan version päälle), Käyttäjähakemistossa versionoletus server.ini -tiedosto

2. Versiopäivityksen yhteydessä tehtävät asetukset:

• 3D-Win versio 2023.0 tai uudempi päivitetään vanhan 3D-Win version päälle. Käyttäjähakemiston server.ini -tiedostoa ei ylikirjoiteta päivityksen yhteydessä.

• • Lisää* painikkeella saat OAPIF asetukset valikon. 
  • Lisää Nimi ja Osoite -kenttään kopioi haluamasi palvelun osoite. 
  • Käyttäjä "<api-key> " ja Salasana -kenttään liitä API-avain.
  • Valitse koordinaattijärjestelmäksi alasvetovalikosta Auto
  • Hae  -painkkeella yhdistää rajapintaan ja ohjelma näyttää OK.
  • Kohdetyyppi -valikosta valitse satunnainen taso ja kuittaa OK
  • OAPIF Haku -dialogissa näkyy kaikki Kohdedtyypit (lisäämällä ruksin Järjestä -kohtaan  listaa aakkosjärjestykseen)

Image Added

• 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.