Uppdateringstjänsten för avgiftsfri data - beskrivning av gränssnittet

Med hjälp av Uppdateringstjänsten för avgiftsfri data kan du genom ett Atom-flöde ladda ned de filer som har uppdaterats efter en valfri tidpunkt för respektive produktversion. Flödet erbjuder direkta nedladdningslänkar till filerna.

För att kunna använda tjänsten kan du beställa den användarspecifika identifikationsnyckeln till din e-post utan avgift.

Beställning av en användarspecifik identifikationsnyckel

Adresserna i tjänsten har följande format:

Filtjänstflöde (produktförteckning): https://tiedostopalvelu.maanmittauslaitos.fi/tp/feed/mtp

Det ovanstående innehåller länkarna till de egentliga produktflödena som har följande adresser: https://tiedostopalvelu.maanmittauslaitos.fi/tp/feed/mtp/<produktidentifierare>/<produktversion>

Förfrågningar och exempel

Parametrar

Följande URL-parametrar kan förmedlas till tjänsten:

Parameter	Betydelse	Obligatorisk?	Exempel på värde
api_key	Identifikationsnyckel	Ja
updated	Datum i formatet ISO8601	Nej	2012-05-12T00:00
crs	Koordinatsystem	Nej	etrs-tm35fin, EPSG:3067
format	Filformat enligt standarden MIME	Nej	image/jp2
offset	Inledande fil på ny sida	Nej	1001
lang	Språk	Nej	fi, sv, en

I parametern ”updated” kan tidpunkten meddelas som ett enkelt datum eller ett datum med klockslag. Om denna parameter inte anges, innehåller svaret från tjänsten alla de filer som motsvarar produktens sökvillkor.

Men en sökning ger tjänsten uppgifterna för högst 1000 filer. Om gränsen överskrids, kan de följande filerna hämtas med hjälp av link-elementets rel=”next”-attribut, som läggs till svaret under feed-elementet.

Följande värden kan användas som filformat (parametern format):

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

Svar från tjänsten

Resultatformatet är ett flöde som följer standarden Atom 1.0 och där varje fil utgör ett entry. Värdet på det update-element som tillhör ett entry är alltid filens uppdateringstidpunkt. Filens storlek anges i byte i link-elementets length-attribut och filnamnet anges i title-attributet.

<feed>

<title>Flöde från Uppdateringstjänsten för produkten Ortofoto i färg</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>

Orientationsfilerna för rastermaterial länkas till flödets entry-element med rel=”related”-attributet:

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

Exempel

Sökning på en lista av alla tillgängliga produkter och deras filformat: https://tiedostopalvelu.maanmittauslaitos.fi/tp/feed/mtp/?api_key=<api-key>

Sökning på en lista av alla ortofoton i filformatet JPEG2000 som har bearbetats efter 1.6.2012: https://tiedostopalvelu.maanmittauslaitos.fi/tp/feed/mtp/orto/ortokuva?updated=2012-06-01T00:00&form...

Sökning av produktens Terrängkarta 1:250 000 filer i filformatet ESRI Shape: https://tiedostopalvelu.maanmittauslaitos.fi/tp/feed/mtp/maastokartta_250k/kaikki?format=application...