OAPIF haku (OGC API Features), uusi paikkatietojen rajapintapalvelu

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

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 kyselypalvelu

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)

• 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ä -kenttään lisätä merkkijono <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.

Ensiasennuksen yhteydessä tehtävät asetukset:

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

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ä kirjoitetaan merkkijono<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).

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 kyselypalvelusta tasot rakennus ja tieviiva, joista näkyy uusittu tielinjaus ja rakennukset Pernajassa.

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

OGC API rajapintojen formaattimuuntimet

Versiosta 2023.2 alkaen Geotiff, GeoJson, GPKG ja JP2 -formaatit löytyvät oletuksena Muuntimet -listauksesta ohjelman ensiasennuksessa. Ohjelmaversion päivityksen yhteydessä käyttäjähakemistoa ei ylikirjoiteta, jonka vuoksi muuntimet tulee lisätä erikseen Tuonti -toiminnolla. 

convert_2023_2.ini  uusille muuntimille: 

• Vektoritiedostojen lukuun GeoTiff korkeusmalleja varten.

• Vektoritiedostojen lukuun GeoJSON ja GPKG Maanmittauslaitoksen aineistoja varten.

• Rasterikuvien lukuun JP2-muunnin Maanmittauslaitoksen ortokuvia varten

• Maastomallien kirjoitukseen GeoTiff korkeusmalleja varten.

• (Uusi Xsite Manage Asbuilt CSV lukee oikein Managen uuden CSV-muodon, ei tarvita rajapinnoissa! )

Tiedosto - Formaatit -Vektoritiedosto

Tuonti -painikkeella voit lukea liitteenä olevan convert_2023_2.ini -tiedoston.

• Muuntimet Geotiff, GeoJson, GPKG, JP2 ja Xsite Manage Asbuilt CSV on lisätty lukupuolelle.

• Geotiff lisätty kirjoituspuolelle.

• Toiminto osaa lisätä samalla kertaa muuntimet oikean tiedostyypin mukaisesti niin luku- kuin kirjoituspuolelle!

Mikäli convert_2023_2.ini -tiedoston tuonnin yhteydessä on jo samanniminen formaatti olemassa, nimeää ohjelma uudelleen formaatin antamalla nimen loppuun 2.

• Virheilmoituksen kuittaaminen OK-painikkeella jatkaa tuonnin loppuun.

• Voit poistaa listalta uudelleen nimetyn formaatin Poista -painikkeella

Liitteet: