3. OGC API – STANDARDIEN
RAKENNE
INSPIRE-koulutus 9.3.2020 3
4. OGC API COMMONS JA TAUSTAA
● OGC:n rajapintastandardeja lähdettiin uusimaan muutama vuosi sitten
● Tavoitteena luoda palveluita, joita on helppo käyttää ja jotka noudattaa
samoja periaatteita kuin muut web-palvelut
● Työ aloitettiin kyselypalveluista, ja työnimeksi valittiin WFS 3.0 (BETA)
○ Tämän perusteella MML:ssa toteutettiin nykyiset BETA-palvelut
(Maastotietokohtee, Nimistö, KMTK rakennukset)
● Kesällä 2019 kokoonnuttiin hackathoniin, jossa keskusteltiin tarpeista
uudistaa myös muita rajapintateknologioita (WMS, WMTS, WCS, WPS,..) ja
todettiin että näillä on yhteisiä osia - syntyi OGC API Commons
○ Tämän myötä WFS 3 työnimi muunnettiin OGC API Features
INSPIRE-koulutus 9.3.2020 4
6. OGC API CORE STANDARDIT
● Tavoitteena mahdollisimman pelkistetty standardi, joka määrittää vain välttämättömät
ominaisuudet
● Tavoitteena, että sovelluskehittäjä osaisi käyttää 15 minuutissa.
● Esimerkiksi Features osalta tässä esim.
○ CRS vain WGS84
○ suositellaan käyttämään formaatteja GeoJSON ja HTML
● Lisäominaisuudet määritellään extension eli lisäosissa
INSPIRE-koulutus 9.3.2020 6
7. OGC API EXTENSIONS
● Lisäominaisuuksien määritys pyritään tekemään lisäosissa
○ Esim. Features osalta työn alla olevien lisäosien työskentelytilat GitHubissa:
https://github.com/opengeospatial/ogcapi-features/tree/master/extensions
■ crs - koordinaatistojen määrittely
■ cql - vapaat kyselyt
■ transactions - kohteiden lisäys ja poisto rajapinnan kautta
● Modulaarisuus mahdollistaa sen, että standardointiprosessissa voidaan
keskittyä yhteen osioon kerrallaan. Muutokset lisäosiin ei vaadi koko
standardin uusintaa.
INSPIRE-koulutus 9.3.2020 7
9. OGC API - FEATURES PART 1: CORE
• Hyväksytty ja julkaistu syksyllä 2019
http://docs.opengeospatial.org/is/17-069r3/17-069r3.html
• Määrittelee OGC API mukaisen kyselypalvelun
• MML:n julkaisemat kyselyrajapinnat julkaistaan tämän mukaisesti
INSPIRE-koulutus 9.3.2020 9
10. MML OGC API FEATURES
PALVELUT
INSPIRE-koulutus 9.3.2020 10
11. MML JULKAISEMAT OGC API
FEATURES PALVELUT
• KMTK Rakennukset
• Nimistö
• Maastotiedot (BETA, WFS 3.0, tuotannollinen kevät 2020)
• Osoitteet (BETA)
• INSPIRE AU ja SU (Alternative encoding for GeoJSON) (BETA)
• Myöhemmin tulossa
• INSPIRE Alternative encoding BU, AD
• KMTK Hydrografia, Maasto
11INSPIRE-koulutus 9.3.2020
12. AVOIMET RAJAPINNAT / API-AVAIN
• Rajapinnat ovat avoimia ja maksuttomia
• Käyttääkseen rajapintoja käyttäjän on luotava itselleen API-avaimen MML:n Omatili-
palvelussa
• https://www.maanmittauslaitos.fi/rajapinnat/kartat-ja-paikkatieto/avoimet-
rajapintapalvelut
12INSPIRE-koulutus 9.3.2020
13. RAJAPINTOJEN KÄYTTÖ
• QGIS-ohjelmistoon on kehitetty tuki OGC API Features -palveluille
• Tuki on versiossa 3.12.0, joka julkaistiin 21.2.2020
13INSPIRE-koulutus 9.3.2020
14. MML OGC API FEATURES
RAKENNUKSET
INSPIRE-koulutus 9.3.2020 14
15. OGC API RAKENNUKSET
KANSALLINEN TIETOTUOTE
• Tietovarastona KMTK-tietokanta
• Tässä vaiheessa tietokannassa on vain MML MTJ-järjestelmään (nykyinen Maastotietokanta)
tallennetut rakennukset.
• Ominaisuustietona pysyvä KMTK-id, muutospäivämärät ja lähdejärjestelmän id
• KMTK-tietokannan päivitysten yhteydessä rakennuksille tuodaan PRT sitä mukaan kuin linkitys
etenee MML:n perusparannustyönä
• Myöhemmin keväällä avataan palvelu, jonka kautta kunnat voivat tallentaa rakennuksensa
KMTK:an
• Tämän myötä aineisto alkaa paranemaan
15INSPIRE-koulutus 9.3.2020
18. MML FEATURES RAKENNUKSET
ESIMERKKEJÄ
• https://avoin-paikkatieto.maanmittauslaitos.fi/buildings/features/v1/
• Tietoa palvelusta
• https://avoin-paikkatieto.maanmittauslaitos.fi/buildings/features/v1/collections
• Tietoa palvelun tarjoamista tuotteista
• https://avoin-paikkatieto.maanmittauslaitos.fi/buildings/features/v1/collections/buildings
• Tietoa yhdestä tietokokoelmasta (collection, tuote)
• https://avoin-paikkatieto.maanmittauslaitos.fi/buildings/features/v1/collections/buildings/items?limit=1
• Yksi kohde
• Sisältää linkin tietokokoelman seuraavaan kohteeseen:
• https://avoin-
paikkatieto.maanmittauslaitos.fi/buildings/features/v1/collections/buildings/items?next=MDo1NDc5NDMz&li
mit=
18Kirjautuminen API-avaimella, ks. dia 12 INSPIRE-koulutus 9.3.2020
19. INSPIRE ALTERNATIVE ENCODING
FOR GEOJSON
• Määrittelyt eivät tulevaisuudessa tule ylhäältä annettuna. Odotetaan, että jäsenmaat
tekevät niitä itse
• INSPIRE on tehnyt taustatyön siitä, miten INSPIRE-vaatimukset voitaisiin täyttää OGC
API Features palveluilla
• Osoitteille on tehty määrittelyt: https://github.com/INSPIRE-
MIF/2017.2/blob/master/GeoJSON/ads/simple-addresses.md
• MML on luonut määrittelyt AU ja SU palveluille
• Ks. Lassi Lehdon ja Sampo Savolaisen esitys SU/AU pilottirajapinnoista
• Toistaiseksi on auki, miten näitä jäsenmaiden tuottamia määrittelyitä sovitetaan yhteen
eri maiden välillä
19INSPIRE-koulutus 9.3.2020
20. INSPIRE ALTERNATIVE ENCODING
FOR GEOJSON BUILDINGS
• MML:lla on tavoitteena luoda Alternative Encoding Rakennuksille 2020 aikana
• Tietotuotteen Alternative Encoding määrittely
• OGC API Features palvelun kehitys ja julkaisu
• MMM on linjannut, että tällainen palvelu täyttäisi INSPIREn asettamat velvollisuudet
kyselypalveluille
• Mikäli kunnat tallentavat aineistonsa KMTK-tietovarastoon, niin MML tarjoaa kyseisen
kyselypalvelun heidän puolestaan
20INSPIRE-koulutus 9.3.2020