Open data file updating service - interface description

The Open data file updating service is an Atom feed that you can use to download files related to specific products that have been updated after any given date. The feed provides direct download links to the files. 

To use the service you need a user-specific identification key, which can be ordered by e-mail free of charge.

Order a user-specific identification key

The addresses used in the service have the following format:

File download service feed (product listing):
https://tiedostopalvelu.maanmittauslaitos.fi/tp/feed/mtp
The address above contains links to the product-specific feeds, with addresses of the following format: https://tiedostopalvelu.maanmittauslaitos.fi/tp/feed/mtp/<product identifier>/<product version>

Parameters

The following URL parameters can be passed on to the service:

Parameter Significance Compulsory? Example value
api_key Identification key Yes  
updated Date in ISO8601 format No 2012-05-12T00:00
crs Coordinate system No etrs-tm35fin, EPSG:3067
format File format as MIME type No image/jp2
offset Initial file following page offset No 1001
lang language

No

fi, sv, en

The parameter “updated” can be given as either a simple date or the time can be included as well. If the parameter has not been given, the response sent by the service includes all files that match the search terms of the product in question.

The service can return the information regarding 1000 files per search. If this limit is passed, subsequent files can be downloaded using the attribute “next” of the link element “rel” (rel=”next”), which is located below the “feed” element.

The following values can be used with the parameter “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

Reply messages by the service

The results of searches are shown as feeds that follow the Atom 1.0 standard, where each file is an entry. The value of the element “updated” of an entry is always the timestamp of the most recent update. The size of a file is shown as bytes in the attribute “length” of the link element and the filename is shown in the element “title”.

<feed>
  <title>Updating service feed for product Orthophoto, colour </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>

The orientation files of raster datasets are linked to the “entry” elements of the feed with the attribute rel=”related”: <link rel="related" href="//www.maanmittauslaitos.fi/%3Ca%20href%3D"https://tiedostopalvelu.maanmittauslaitos.fi/L4122F.tfw">https://tiedostopalvelu.maanmittauslaitos.fi/../L4122F.tfw"/>

Examples

A listing of available products and their file formats: https://tiedostopalvelu.maanmittauslaitos.fi/tp/feed/mtp/?api_key=<api-key>  

 A listing of all orthophotos in JPEG2000 format that have been modified 1.6.2012 or later:  https://tiedostopalvelu.maanmittauslaitos.fi/tp/feed/mtp/orto/ortokuva?updated=2012-06-01T00:00&form...

All files of the product Topographic map 1:250 000 in ESRI Shape file format: https://tiedostopalvelu.maanmittauslaitos.fi/tp/feed/mtp/maastokartta_250k/kaikki?format=application...