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>

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