Muutostietopalvelun rajapintakuvaus

Tiedostopalvelun muutostietopalvelulla voit hakea ATOM-syötteenä tuoteversioittain antamasi ajankohdan jälkeen päivitetyt tiedostot. Syöte tarjoaa suorat latauslinkit tiedostoihin.

Palvelun käyttämiseen tarvitset käyttäjäkohtaisen tunnisteavaimen, jonka voit tilata sähköpostitse maksutta.

Käyttäjäkohtaisen tunnisteavaimen tilaus >>

Palvelu on tarjolla myös joillekin maksullisille, käyttörajoitetuille tuotteille. Silloin api_key-parametriä ei käytetä vaan palveluun tunnistaudutaan http basic auth -tunnistautumisella. Asiakaskohtaiset tunnukset on toimitettu silloin aineistotilauksen yhteydessä asiakastuesta.

Palvelun osoitteet ovat muotoa:

Tiedostopalvelusyöte (tuotelistaus):

Avoin data:

https://tiedostopalvelu.maanmittauslaitos.fi/tp/feed/mtp

Edellinen sisältää linkit varsinaisiin tuotesyötteisiin, joiden osoitteet ovat:

https://tiedostopalvelu.maanmittauslaitos.fi/tp/feed/mtp/<tuotetunniste>/<tuoteversio>

Maksullinen/käyttörajoitettu data:

https://tiedostopalvelu.maanmittauslaitos.fi/tp/kara/feed/mtp

Edellinen sisältää linkit varsinaisiin tuotesyötteisiin, joiden osoitteet ovat:

https://tiedostopalvelu.maanmittauslaitos.fi/tp/kara/feed/mtp/<tuotetunniste>/<tuoteversio>

Kyselyt ja esimerkit

Parametrit

Palvelulle voidaan välittää seuraavia URL-parametreja:

Parametri	Merkitys	Pakollinen?	Esimerkki arvosta
api_key	Tunnisteavain	Kyllä
updated	Päivämäärä ISO8601 muodossa	Ei	2012-05-12T00:00
crs	Koordinaattijärjestelmä	Ei	etrs-tm35fin, EPSG:3067
format	Tiedostomuoto MIME-tyyppinä	Ei	image/jp2
offset	Sivutuksen aloitustiedosto	Ei	1001
lang	Kieli	Ei	fi, sv, en

Ajankohta voidaan antaa updated-parametrissa joko pelkkänä päivänä tai kellonajan kanssa. Jos parametria ei ole annettu, palvelun palauttama vastaus sisältää kaikki tuotteen hakuehtoja vastaavat tiedostot.

Palvelu palauttaa yhdellä haulla maksimissaan 1000:n tiedoston tiedot. Jos raja ylittyy, liitetään vastauksen feed-elementin alle link-elementti rel=”next”-attribuutilla, jolla voi hakea seuraavat tiedostot.

Tiedostomuotona (format-parametri) voidaan käyttää seuraavia arvoja:

Tiedostomuoto	MIME-tyyppi
LAZ	application/x-laz
TIFF	image/tiff
PNG	image/png
GML	application/gml%2Bxml
ESRI shape	application/x-shapefile
MapInfo mif	application/x-mapinfo-mif
JPEG2000	image/jp2
ascii grid	application/x-ascii-grid
ascii xyz	application/x-ascii-xyz
TXT	text/plain

Palvelun palauttamat vastaukset

Tulosformaatti on ATOM 1.0 standardin mukainen syöte, jossa jokainen tiedosto on oma entrynsä. Entryn updated-elementin arvo on aina tiedoston päivitysaika. Tiedoston koko ilmastaan tavuina link-elementin length-attribuutissa ja tiedoston nimi title-attribuutissa.

<feed>

<title>Muutostietopalvelusyöte tuotteelle Ortoilmakuva, väriorto</title>

..

<entry>

    <title>L4122F.jp2</title>

    <link href="//www.maanmittauslaitos.fi/%3Ca%20href%3D"https://tiedostopalvelu.maanmittauslaitos.fi/tp/lataus/%3Capi-key%3E/1/L4122F.jp2api_key=tunniste">https://tiedostopalvelu.maanmittauslaitos.fi/tp/lataus/<api-key>/tuotteet/../1/L4122F.jp2api_key=tun..."

length="191694290" rel="alternate" type="image/jp2"/>

    <updated>2012-06-13T00:21:19+03:00</updated>

    <id>https://www.nls.fi/tuotteet/orto/etrs-tm35fin/mara_v_25000_50/2012/L41/02m/1/L4122F.jp2</id>

</entry>

..

</feed>

Rasteriaineistojen orientointitiedostot linkitetään syötteen entry-elementteihin rel="related"-attribuutilla:

<link rel="related" href="//www.maanmittauslaitos.fi/%3Ca%20href%3D"https://tiedostopalvelu.maanmittauslaitos.fi/L4122F.tfw">https://tiedostopalvelu.maanmittauslaitos.fi/../L4122F.tfw"/>

Esimerkkejä

Haetaan listaus saatavilla olevista tuotteista ja näiden tiedostomuodoista:

https://tiedostopalvelu.maanmittauslaitos.fi/tp/feed/mtp/?api_key=1s8so0nmpmnuspiud66uemonkb

Haetaan listaus kaikista 1.6.2016 jälkeen muokatuista ortokuvista JPEG2000-tiedostomuodossa: https://tiedostopalvelu.maanmittauslaitos.fi/tp/feed/mtp/orto/ortokuva?updated=2016-06-01T00:00&format=image/jp2&api_key=1s8so0nmpmnuspiud66uemonkb

Haetaan kaikki Maastokartta 1: 250 000 tuotteen tiedostot ESRI Shape-tiedostomuodossa: https://tiedostopalvelu.maanmittauslaitos.fi/tp/feed/mtp/maastokartta_250k/kaikki?format=application...