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 , Rakennusten ja Kiinteistötietojen (avoin, ei sopimusta) kyselypalvelun käyttö edellyttää API-avainta (aktivointiohje myöhemmin tässä artikkelissa). Kiinteistötietojen kyselypalvelun

Sopimukseen perustuvan kiinteistötietojen rajapintapalveluiden (avoimet / luvanvaraiset ) 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 kyselypalveluKiinteistötietojen kyselypalvelusta
  • https://www.maanmittauslaitos.fi/palvelutiedotteet/kiinteistotietojen-kyselypalvelu-ogc-api-features-saatavilla-nyt-myos-avoimena (API-avain)
    • Avoin rajapintapalvelu pienimuotoiseen käyttöön. 
  • 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
    • Sopimukseen perustuvat, avoimet sekä luvanvaraiset rajapintapalvelut.
    • Sisältö sama kuin vanhassa WFS-palvelussa.

  
  

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/
• Kiinteistötietojen kyselypalvelu https://avoin-paikkatieto.maanmittauslaitos.fi/kiinteisto-avoin/simple-features/v3/

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 haku -dialogissa näkyy kaikki Kohdedtyypit (lisäämällä ruksin Järjestä -kohtaan  listaa aakkosjärjestykseen).

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

Allaolevassa kuvassa on vanhan Pernajan aineiston, Pernaja.xy.tdw lisäksi haettu Maastotietokannan kyselypalvelustatasot rakennus ja tieviiva, joista näkyy uusittu tielinjaus ja rakennukset Pernajassa.

Avoimesta Kiinteistötietojen kyselypalvelusta rajamerkin sijaintiedot sekä kiinteistörajan sijaintiedot.

Image Added