Nimistö (WFS 3.0) BETA

Palvelu tarjoaa Web Feature Service (WFS) -kyselyrajapinnan Maanmittauslaitoksen nimistörekisterin paikoille, paikannimille ja karttanimille.

Rajapintapalvelu on saatavilla osoitteesta: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/

Rajapintapalvelu perustuu WFS 3.0 standardiluonnokseen ja rajapinnan tekninen kuvaus on julkaistu Open API 3.0.1 spesifikaation mukaisena. Paikkatietokohteita voidaan hakea id-tunnisteilla, ominaisuustiedoilla ja suorakaiderajauksella (bbox). Seuraavia vastauksen tiedostomuotoja tuetaan:

  • GeoJSON (ensijainen tiedostomuoto WFS 3.0 palveluissa, soveltuu hyvin simple feature kohteiden esittämiseen, mutta myös complex feature kohteiden esittäminen mahdollista)
  • GML (taaksepäin yhteensopivuussyistä tuettu tiedostomuoto, tässä palvelussa GML 3.2.1)

Oletuskoordinaatisto WFS 3.0 ja GeoJSON spesifikaatioiden mukaisesti on WGS 84 maantieteelliset koordinaatit. Palvelu tukee myös ETRS-TM35FIN, ETRS-TM34..36 ja ETRS-GK19..31FIN projisoituja koordinaatistoja sekä ETRS89 maantieteellistä koordinaatistoa.

Tämä on palvelun BETA-versio, joka on saatavilla testikäyttöön avoimen rajapintayhteyden kautta ilman käyttäjätunnistusta. BETA-vaiheen aikana palvelun palvelutasoa ei ole taattu.

Osa kyselyparametreista ja paikkatietokohteiden ominaisuustiedoista on mallinnettu koodistoarvoina, joiden selitystekstit on julkaistu erillisen luettelopalvelun kautta.

Aineisto

Nimistön tietopalveluiden aineistolähde, Maanmittauslaitoksen nimistörekisteri on nimettyjen paikkojen ja tarkistettujen paikannimien sekä erimittakaavaisten karttanimistöjen valtakunnallinen tietovaranto. Nimistörekisterin suomen- ja ruotsinkieliset paikannimet tarkistetaan Kotimaisten kielten keskuksessa ja saamenkieliset Oulun yliopistossa. Nimettyjä paikkoja ja paikannimiä on noin 800 000. Karttanimistöjä ylläpidetään yhdeksässä mittakaavassa ja ne vastaavat Karttapaikan karttarastereita. Paikkojen sijaintitietona on lähellä sen keskipistettä ja joen tapauksessa sen suuta oleva piste. Paikat on luokiteltu hierarkkisesti yhdeksän paikanlajiteeman mukaan. Paikannimen kieli voi olla suomi, ruotsi, pohjoissaame, inarinsaame tai koltansaame. Kaikilla paikoilla ja paikannimillä on pysyvät yksilöivät tunnukset.

Tarkistettu nimistöaineisto ja siihen perustuvat tuotteet palvelevat esimerkiksi täsmällistä viestintää ja luotettavan nimitiedon tarvetta yleensä sekä paikkatietoinfrastruktuuria ja sen palveluiden kehittämistä.

Nimistön (WFS 3.0) aineisto päivittyy jatkuvasti.

Lisätietoa nimistörekisterin paikoista, paikannimistä ja karttanimistä sekä niiden aineistolähteistä löytyy tuotekuvauksesta ja Paikkatietohakemistossa julkaistuissa metatiedoissa

Tuotteet

Nimistön kyselypalvelutuotteita on neljä. Tuotteet Paikat, Paikannimet ja Paikannimet, yksinkertaistettu sisältävät nimettyjen paikkojen ja paikannimien tietoja. Tuote Karttanimet sisältää Maanmittauslaitoksen yhdeksän vakiokarttatuotteen karttanimistöt peruskartasta 1:25 000 Yleiskarttaan 1: 8 milj.

Jokaisesta tuotteesta on kuvattu vastaussanoman rakenne ja sisältö UML-kaaviona sekä attribuutit mahdollisine koodistoineen. Koodistoissa selitetään attribuuttien arvoina käytetyt koodit suomeksi, ruotsiksi ja englanniksi. Erilaisia käyttötapauksia valaisevia kyselyesimerkkejä löytyy tältä sivulta alempana kohdassa Esimerkkejä.

Tuote Kuvaus Tiedot
Paikat Tuotteen tietoyksikkö on nimetty paikka. Paikan tietoja ovat mm. sijainti ja paikanlaji sekä paikan kaikki nimet ominaisuustietoineen (mm. tarkistettu kirjoitusasu ja kieli). UML-kaavio / Luokat ja attribuutit
Paikannimet Tuotteen tietoyksikkö on paikannimi. Paikannimen tietoja ovat mm. tarkistettu kirjoitusasu ja kieli, mahdolliset rinnakkaisnimet sekä kyseisen nimetyn paikan tiedot (mm. sijainti ja paikanlaji).  UML-kaavio / Luokat ja attribuutit
Paikannimet, yksinkertaistettu Tuote vastaa Paikannimet-tuotetta ilman rinnakkaisnimiä. UML-kaavio / Luokat ja attribuutit
Karttanimet Tuotteen tietoyksikkö on karttanimi. Karttanimen tietoja ovat mm. karttanimiteksti ja sen sijoittelu- ja typografiatiedot sekä tärkeimmät kyseisen paikannimen ja nimetyn paikan tiedot. Tuotteen tietojen avulla on mahdollista tuottaa MML:n karttatuotteita vastaava karttanimistö. UML-kaavio / Luokat ja attribuutit

Rajapinnan kyselypalvelutuotteet

Tämän WFS 3.0-rajapintapalvelun tarjoamat kyselypalvelutuotteet:

Tuote

Esimerkkikohteita

FeatureCollection tunniste (WFS 3.0)

FeatureType

Paikat GeoJSONGML places Place
Paikannimet GeoJSONGML placenames PlaceName
Paikannimet, yksinkertaistettu GeoJSONGML placenames_simple PlaceNameSimple
Karttanimet GeoJSONGML mapnames MapName

Koodistot on julkaistu luettelopalvelussa ja niitä käytetään sekä hakuparameteissa että vastausten paikkatietokohteiden ominaisuuksissa (koodistoarvojen käännökset kattavasti vain suomeksi, osassa koodistoja myös ruotsin- ja englanninkieliset käännökset):

Nimi suomeksi

Nimi englanniksi

Koodilistat

Paikanlaji PlaceType fin, swe, eng
Paikanlajikuvaus PlaceTypeDescription fin, swe, eng
Paikanlajiteema PlaceTypeCategory fin, swe, eng
Paikanlajiryhma PlaceTypeGroup fin, swe, eng
Paikanlajialaryhma PlaceTypeSubgroup fin, swe, eng
Kunta Municipality finsweeng
Seutukunta SubRegion finsweeng
Maakunta Region finsweeng
Mittakaavarelevanssi ScaleRelevance finsweeng
Kieli Language finsweeng
KielenVirallisuus LanguageOfficiality finsweeng
KielenValtaasema LanguageDominance finsweeng
PaikannimenLahde PlaceNameSource finsweeng
PaikannimenStatus PlaceNameStatus finsweeng
Karttatuote MapProduct finsweeng
Mittakaavaluokka ScaleClass finsweeng
TekstinAakkoslaji TextCase finsweeng
TekstinKirjasintyyppi TextFont finsweeng
TekstinVari TextColour finsweeng
TekstinHarvennus TextSpacing finsweeng
TekstinEnsisijaisuus TextPreference finsweeng
TuoteTapahtumaLaji ProductEventType fin, swe, eng

Yhteensopivuus ja tuotteet

Kehitettäessä WFS 3.0 asiakassovelluksia kannattaa ensin tutustua WFS 3.0 standardardiluonnokseen.

Tämä WFS 3.0 palvelu on yhteensopiva standardiluonnoksen kanssa lukuunottamatta seuraavia poikkeuksia ja laajennuksia:

  • laajennus (epävirallinen): laajennettu koordinaatistotuki bbox-suorakaiderajauksissa (crs-bbox parametri) ja vastauksien geometrioissa (crs parametri)

Tuetut yhteensopivuusluokat (conformance classes):

https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/conformance

Palvelun tarjoamat tuotteet (collections) ja tuetut koordinaatistot: 

https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections

Open API kuvaukset

Open API 3.0.1 kuvauksessa on kerrottu tarkemmin kuinka palvelusta voidaan hakea metatietoa ja nimistörekisterin mukaisia paikkatietokohteita WFS 3.0 mukaisilla palvelupyynnöillä:

https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/api

Open API-kuvaus saatavina myös generoituna HTML-sivuna.

 

Luettelopalvelun Codelist API tarjoaa myös indeksisivun jossa on lueteltu palvelun käyttämät koodilistat. Lisätietoa koodilistojen ja koodien selitteiden hakemisesta Open API 3.0.1 kuvauksesta:

https://beta-paikkatieto.maanmittauslaitos.fi/catalogue/openapi.json

https://beta-paikkatieto.maanmittauslaitos.fi/catalogue/openapi.yaml

Open API-kuvaus saatavina myös generoituna HTML-sivuna.

 

WFS 3.0 palvelun käyttäminen

Tässä on lyhyt ohje kuinka käyttää WFS 3.0 rajapintapalvelua, esimerkkitapauksena tuote Paikannimet. Luonnollisesti vastaavat kyselyt mahdollisia myös muille palvelun tuotteille. Open API kuvauksessa on kuvattu tarkemmin eri tuotteille mahdolliset palvelupyynnöt ja niiden hakuparametrit.

 

Paikkatietokohteen haku tunnisteella

Oletuksena vastaus on GeoJSON-muotoista: 

https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames/items/PN_40889621 

Sama kysely, vastaus GML 3.2.1-muotoisena:

https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames/items/PN_40889621.gml 

 

Vastausten sivutus

WFS 3.0 rajapinnan mukaisesti toteutettuna palvelussa on hyvä tuki paikkatietokohteiden kokoelmien sivutukselle. Esimerkiksi seuraava kysely palauttaa osajoukon paikannimien kokoelmasta eli ensimmäiset 100 kohdetta:

https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames/items?limit=100 

Vastauksena tulee siis nuo 100 kohdetta sekä myös linkki seuraaviin 100 kohteeseen, esim.:

https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames/items?limit=100&minId=40000102

Tämä puolestaan palauttaa linkin sitä seuraavaan osajoukkoon jne.

 

Koordinaatistot ja suorakaiderajaukset

Oletuksena BBOX-suorakaiderajaus ja vastauksena palautettavien paikkatietokohteiden geometriat sisältävät WGS 84 koordinaatteja (CRS80), esimerkiksi:

https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames/items?bbox=22.15,63.45,22.2,63.5

Rajaaminen ETRS-TM35FIN koordinaateilla (EPSG:3067) onnistuu lisäämällä bbox-crs parametri (joka ei ole osa WFS 3.0 standardiluonnoksen core-osioita):

https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames/items?bbox=490000,6904000,492000,6906000&bbox-crs=http://www.opengis.net/def/crs/EPSG/0/3067

Edellinen esimerkki palauttaa vastauksen paikkatietokohteiden geometriat edelleen WGS 84 koordinaatteina. Jos myös vastaus halutaan projisoida toiseen koordinaatistoon, niin tähän voi käyttää crs parametria (myöskään ei osa WFS 3.0 standardiluonnoksen core-osioita):

https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames/items?bbox=490000,6904000,492000,6906000&bbox-crs=http://www.opengis.net/def/crs/EPSG/0/3067&crs=http://www.opengis.net/def/crs/EPSG/0/3067

Tuettujen koordinaatistojen tunnisteet on lueteltu:

https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections 

 

Rajaus ominaisuustiedoilla

Tämä esimerkki hakee municipality-parametria käyttäen yhden kunnan (837 = Tampere) kaikki paikannimet 100 kohteen osajoukoissa, ensimmäinen erä:

https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames/items?municipality=837&limit=100

Useamman kunnan paikannimet voidaan hakea yhdellä kyselyllä listaamalla kuntakoodit pilkulla erotettuna (jolloin arvojen käsittely toimii OR-operaation mukaisesti, tässä esimerkissä siis "418 tai 837 tai 980"):

https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames/items?municipality=418,837,980&limit=100

Eri parametrien välinen käsittely tapahtuu AND-operaattorin mukaisesti. Alla oleva kysely rajaa sekä kuntakoodilla (municipality-parametri) että paikannimen kirjoitusasulla (spelling_case_insensitive-parametri, tässä wildcard-hakuna), ja palauttaa kaikki paikannimet Tampereelta, joiden aakkoslajeja erottamaton kirjoitusasu alkaa sanalla "tammer":

https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames/items?municipality=837&spelling_case_insensitive=tammer*

Edellinen kysely palauttaa 5 paikannimikohdetta sisältäen mm. "Tammerkoski" ja "Tammerfors". Kun kyselyyn lisätään vielä paikanlajirajaus käyttäen placeType-parametria (tässä esimerkissä koodiarvo 2020115, joka tarkoittaa paikanlajia "Koski"), niin vastaus palauttaa täsmälleen yhden kohteen ("Tammerkoski"):

https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames/items?municipality=837&spelling_case_insensitive=tammer*&placeType=2020115

 

Lisää hakuesimerkkejä eri käyttötapauksiin sovitettuna alempana kohdassa Esimerkkejä.

 

BETA-julkaisu 2019-03

Kyselyesimerkkejä, tuote Paikat

Paikka, jonka paikka-id on 10342733 (Helsinki, Helsingfors, kunta).

GeoJSON: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/places/items?crs=http://www.opengis.net/def/crs/EPSG/0/3067&placeId=10342733

GML: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/places/items.gml?crs=http://www.opengis.net/def/crs/EPSG/0/3067&placeId=10342733

Paikka, jonka nimi on Ivalon lentoasema.

GeoJSON: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/places/items?crs=http://www.opengis.net/def/crs/EPSG/0/3067&name.spelling_case_insensitive=ivalon%20lentoasema

GML: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/places/items.gml?crs=http://www.opengis.net/def/crs/EPSG/0/3067&name.spelling_case_insensitive=ivalon%20lentoasema

Kaikki kunnat. Hakutulosten lukumäärä on kuntien lukumäärä.

GeoJSON: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/places/items?crs=http://www.opengis.net/def/crs/EPSG/0/3067&placeType=4010125

GML: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/places/items.gml?crs=http://www.opengis.net/def/crs/EPSG/0/3067&placeType=4010125

Lapin maakunnan kaupunkialueet ja taajamat sekä niiden osat.

GeoJSON: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/places/items?crs=http://www.opengis.net/def/crs/EPSG/0/3067&placeType=3010105,3020105&region=19

GML: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/places/items.gml?crs=http://www.opengis.net/def/crs/EPSG/0/3067&placeType=3010105,3020105&region=19

Vesistökohteet, joiden nimi esiintyy MML:n 1:1 milj. ja sitä pienempimittakaavaisissa kartoissa.

GeoJSON: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/places/items?crs=http://www.opengis.net/def/crs/EPSG/0/3067&placeTypeCategory=2&scaleRelevance=1000000,2000000,4500000,8000000

GML: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/places/items.gml?crs=http://www.opengis.net/def/crs/EPSG/0/3067&placeTypeCategory=2&scaleRelevance=1000000,2000000,4500000,8000000

 

Kyselyesimerkkejä, tuote Paikannimet

Paikannimi, jonka paikannimi-id on 40342733 (”Helsinki”, kunta)

GeoJSON https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames/items?crs=http://www.opengis.net/def/crs/EPSG/0/3067&placeNameId=40342733

GML https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames/items.gml?crs=http://www.opengis.net/def/crs/EPSG/0/3067&placeNameId=40342733

Kaikki kunnannimet. Hakutulosten lukumäärä on kunnannimien lukumäärää eri kielillä.

GeoJSON: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames/items?crs=http://www.opengis.net/def/crs/EPSG/0/3067&placeType=4010125

GML: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames/items.gml?crs=http://www.opengis.net/def/crs/EPSG/0/3067&placeType=4010125

Kunnannimet, joiden kieli on kunnan enemmistökieli. Hakutulosten lukumäärä on kuntien lukumäärä.

GeoJSON: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames/items?crs=http://www.opengis.net/def/crs/EPSG/0/3067&placeType=4010125&languageDominance=1

GML: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames/items.gml?crs=http://www.opengis.net/def/crs/EPSG/0/3067&placeType=4010125&languageDominance=1

Hirviaiheiset saarien tai luotojen sekä saari- ja luotoryhmien nimet.

GeoJSON: rajapintakutsu (sisältää ? ja * merkkejä)

GML: rajapintakutsu (sisältää ? ja * merkkejä)

Korkeintaan kolmikirjaimiset ruotsinkieliset luonnonpaikkojen nimet.

GeoJSON: rajapintakutsu (sisältää ? ja * merkkejä)

GML: rajapintakutsu (sisältää ? ja * merkkejä)

Vähintään 30-kirjaimiset suomenkieliset luonnonpaikkojen nimet.

GeoJSON: rajapintakutsu (sisältää ? ja * merkkejä)

GML: rajapintakutsu (sisältää ? ja * merkkejä)

 

Kyselyesimerkki, tuote Paikannimet, yksinkertaistettu

Paikannimi, jonka paikannimi-id on 40342734 (”Helsingfors”, kunta)

GeoJSON: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames_simple/items?crs=http://www.opengis.net/def/crs/EPSG/0/3067&placeNameId=40342734 

GML: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/placenames_simple/items.gml?crs=http://www.opengis.net/def/crs/EPSG/0/3067&placeNameId=40342734  

 

Kyselyesimerkkejä, tuote Karttanimet

Yleiskartan 1:4,5 milj. karttanimet, koko Suomi.

GeoJSON: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/mapnames/items?crs=http://www.opengis.net/def/crs/EPSG/0/3067&mapProduct=K4500  

GML: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/mapnames/items.gml?crs=http://www.opengis.net/def/crs/EPSG/0/3067&mapProduct=K4500 

Peruskartan 1:25 000 karttanimet TM35-karttalehden M5214G alueella.

Haku palauttaa karttanimet, joiden karttatekstin vasen alakulma osuu hakuikkunaan.

GeoJSON: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/mapnames/items?crs=http://www.opengis.net/def/crs/EPSG/0/3067&bbox-crs=http://www.opengis.net/def/crs/EPSG/0/3067&bbox=542000,6822000,548000,6828000&mapProduct=K0025 

GML: https://beta-paikkatieto.maanmittauslaitos.fi/geographic-names/wfs3/v1/collections/mapnames/items.gml?crs=http://www.opengis.net/def/crs/EPSG/0/3067&bbox-crs=http://www.opengis.net/def/crs/EPSG/0/3067&bbox=542000,6822000,548000,6828000&mapProduct=K0025