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