Skip to content

Digiroad interfaces

Digiroad data has a WMS viewing interface and a WFS download interface, which enable efficient data transfer from Digiroad administrators to data users, municipal employees, public service providers and companies.

Information is updated to the WMS and WFS interfaces every weekend from Digiroad's database. TN-ITS change information is published daily.

Our interfaces are in the development phase, so please feel free to send us feedback on both functionalities and possible errors in the material via the Finnish Transport Infrastructure Agency's Feedback service or directly to the Digiroad operator at [email protected]

The symbols of Finnish traffic signs can be freely downloaded to the QGIS GIS program from the Finnish Transport Infrastructure Agency's image library. Service and download instructions for downloading the symbols.

WMS VIEWING INTERFACE

Digiroad's WMS viewing interface allows you to view Digiroad's different data types and use them for visualization in applications or maps. The interface currently contains all Digiroad's data types, as well as the road link's feature information on the geometry of the design and construction phase.
We are happy to receive feedback on both the visualization methods of the WMS interface and the material itself.

WMS interfaces can be viewed, for example, in Paikkatietoikkuna, in the Finnish Transport Infrastructure map service called Suomen Väylät and in the Digiroad map window. The WMS interface (Web Map Service) is an interface that returns spatial data as a map image. The data can be viewed, but its appearance cannot be changed, nor can spatial data queries be made on it. However, the WMS services of Digiroad data include the possibility to make info queries to the data with the info tool of the GIS program.

Digiroad open WMS (new) (metadata): 

https://avoinapi.vaylapilvi.fi/vaylatiedot/digiroad/ows?service=wms&request=getCapabilities

WFS DOWNLOAD INTERFACE

Digiroad's WFS direct order interface allows you to download data from the area you want to use locally, for example with geospatial software. Currently, the recommended regional division for charging is the municipal level. The size of the entire Digiroad data in Finland is very large, so we recommend downloading small areas at a time to optimize the performance of the interface. The interface is also not designed to be used directly in applications and we recommend downloading data locally.

If you need access to data from a larger area, the Finnish Transport Infrastructure Agency's material service allows you to download the latest publication of the entire dataset as usual. The data can be downloaded as a Geopackage covering the whole of Finland or as a shape file divided into regions.
 

The WFS interface is recommended to be used by the division of municipalities into municipalities, and material downloaded from the WFS interface (Web Feature Service) can be utilized like any other spatial data layer.
The data can be queried, for example, with QGIS software with SQL search:

SELECT * FROM DESIRED DATA TYPE WHERE DESIRED DATA TYPE. MUNICIPALITY CODE=eg. 179
    or
SELECT * FROM HALUTTUTIETOLAJI WHERE HALUTTUTIETOLAJI.KUNTAKOODI=eg. 179

Replace the DESIRED data type with the data type name in the interface and 179 (Municipality number) of the desired municipality. 

Please note that line-like data types are very heavy, and in large municipalities the connection may be slow.

Digiroad open WFS (new) (metadata): 

https://avoinapi.vaylapilvi.fi/vaylatiedot/digiroad/ows?service=wfs&request=getCapabilities

 

Connect to an interface with QGIS software

1. Create a new WFS connection

2. Enter the name you want for the connection

3. Copy the WFS-URL into the field. You can get the necessary address by copying the link above.

4. Press OK. The interface does not need identification. 
 

 

5. Add a new WFS layer by navigating to layer --> 
6. Add layer --> 
7. Add WFS-layer

 

8. In the drop-down list, find the connection you named, and press Connect. Select one desired data type from the list that appears.

9. Limit the data to an individual municipality by clicking "Build query"

10. Copy the municipality boundary query in SQL language into the field, for example: SELECT * FROM DR_VALAISTU_TIE WHERE DR_VALAISTU_TIE. MUNICIPALITY CODE=95 . This query returns the Illuminated Road data type from the City of Helsinki area. N.B! In step 8, the data type you select must be in place of the data type in the SQL query for the query to pass. To change the data type, press the cancel button to cancel the query and select the data type you want.

 

TN-ITS CHANGE INTERFACE

TN-ITS interface has been updated to the new CEN/TS 17268:2018 standard, TN-ITS standard. Changes in the Digiroad data are published once a day at the TN-ITS interface. Changed information is transmitted to end users as dataset XML files in accordance with TN-ITS CEN TS 17268:2018, where the location is indicated as generated by the OpenLR library.

The advantage of the TN-ITS interface is the speed and ease of data processing, as instead of downloading the entire data, it is possible to access the changed objects directly. 

In addition to the interface service, changed information is shared as a file compilation through the Finnish Transport Infrastructure Agency's material service.

Available TN-ITS interfaces

Returns current data for TN-ITS:
https://avoinapi.vaylapilvi.fi/tnits/public/download/queryDataSets

 

Introduction to the interface


/download/queryDataSets

Returns a list of existing datasets in chronological order from oldest to newest.

Datasets are individual change messages that list all changes in Digiroad's data types during the time period defined by the dataset (a more detailed list of the data types provided by the interface can be found under the main heading "TN-ITS: GET /download/readDataSet - Individual dataset dataset" below).

Authentication


The use of the interface does not require authentication.

Parameters


lastValidDataSetID (optional): The url of the most recently retrieved dataset encoded id. If configured, search lists all datasets created after the specified dataset. Otherwise, returns a listing of all existing datasets.

Return values


HTTP-200 (OK):
XML format from oldest to newest time-ordered listing of available datasets. A single dataset is defined by the "RestDatasetRef" element, which is assigned by the "xlink:href" attribute to the location of the url dataset.

<RestDatasetRefList xmlns="http://www.ptvag.com/tnits/dataexchange/rest" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xlink="http://www.w3.org/1999/xlink" xsi:schemaLocation="http://www.ptvag.com/tnits/dataexchange/rest https://avoinapi.vaylapilvi.fi/tnits/public/schemas/api/TN-ITS.xsd">
    <RestDatasetRef xlink:href="https://avoinapi.vaylapilvi.fi/tnits/public/download/readDataSet?dataSetID=%2BQBW3IlFSIWYYPDwF4Vc%2FQAAAYBOyKC7AAABgFPuEls%3D"/> <!-- Linkki yksittäiseen datasettiin (luotu 23.4.2022) -->
    <RestDatasetRef xlink:href="https://avoinapi.vaylapilvi.fi/tnits/public/download/readDataSet?dataSetID=%2BQBW3IlFSIWYYPDwF4Vc%2FQAAAYBT7hJbAAABgFkUbEQ%3D"/> <!-- Linkki yksittäiseen datasettiin (luotu 24.4.2022) -->
    <RestDatasetRef xlink:href="https://avoinapi.vaylapilvi.fi/tnits/public/download/readDataSet?dataSetID=%2BQBW3IlFSIWYYPDwF4Vc%2FQAAAYBZFGxEAAABgF46yZ4%3D"/> <!-- Linkki yksittäiseen datasettiin (luotu 25.4.2022) -->
</RestDatasetRefList>

 

HTTP error responses:


HTTP 400 (BadRequest) if

•    An internal error occurs while processing the request.
Other possible mistakes

•    The TN-ITS interface has been implemented using the AWS API Gateway. Possible API Gateway error messages are listed on the AWS website (https://docs.aws.amazon.com/apigateway/latest/api/CommonErrors.html ).

Content-type:


application/xml

 

Versions:


2022-03 Initial

 

Examples:


Example 1. (Invite to prod environment): List all existing datasets.

curl https://avoinapi.vaylapilvi.fi/tnits/public/download/queryDataSets

Example of return value content and structure: queryDataSets-example1.xml

Example 2. (Call to prod environment): Lists only datasets created after the dataset (id: %2BQBW3IlFSIWYYPDwF4Vc%2FQAAAYBT7hJbAAABgFkUbEQ%3).

curl https://avoinapi.vaylapilvi.fi/tnits/public/download/queryDataSets?lastValidDataSetID=%2BQBW3IlFSIWYYPDwF4Vc%2FQAAAYBT7hJbAAABgFkUbEQ%3D

Example of return value content and structure: queryDataSets-example2.xml
 

Returns data from a single dataset:
https://avoinapi.vaylapilvi.fi/tnits/public/download/readDataSet

Interface introduction:


/download/readDataSets

Returns the contents of the questioned dataset. Dataset includes additions, edits and deletions of data types that have occurred in Digiroad during a certain time period. The content of the change message has been implemented in accordance with TN-ITS CEN TS 17268.

Datasets are generated automatically once a day.

N.B!  The interface uses redirects, which is why redirects must be enabled in the query. (See chapter Return values; HTTP-302)

The implementation includes change data for the following data types:

  • Speed limits
  • Maximum Allowed data types:
    • Maximum authorized length of the vehicle or combination of vehicles
    • Maximum permissible width of the vehicle
    • Maximum authorized vehicle height
    • Maximum permissible mass on the axle of the vehicle
    • Maximum authorized mass of the vehicle
    • Maximum authorized mass of the vehicle combination
  • Forced stop
  • Barrier constructions
  • Crosswalk
  • Vehicle-specific limit
  • Warning signs

Authentication:


The use of the interface does not require authentication.

Parameters


dataSetID: The URL of the dataset you want to query is the encoded id whose content you want to retrieve. The encoded ids of the URL of the available change messages can be retrieved using the dataset listing call (in the main header above: TN-ITS: GET /download/queryDataSets - Current data), which returns the full URLs for reading the datasets as an xml listing.

Return values


HTTP-302 (Found): Redirects the queryer to the file location using the location header. A dataset is an unordered listing in XML format of changes that have occurred during the time period specified in the dataset.

<RoadFeatureDataset xmlns="http://spec.tn-its.eu/schemas/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:gml="http://www.opengis.net/gml/3.2" xmlns:xlink="http://www.w3.org/1999/xlink" xsi:schemaLocation="http://spec.tn-its.eu/schemas/ http://spec.tn-its.eu/schemas/TNITS.xsd">
    <metadata>
        <Metadata>
            <!-- Datasetin id -->
            <!-- Muodostuu muutosten hakuajoista (alku ja loppu) sekä datasetin tarjoajan Väyläviraston uuid tunnuksesta -->
            <datasetId>+QBW3IlFSIWYYPDwF4Vc/QAAAYBOyKC7AAABgFPuEls=</datasetId>
            <!-- Datasetin luontiaika UTC-muodossa -->
            <datasetCreationTime>2022-04-23T00:59:12.859Z</datasetCreationTime>
        </Metadata>
    </metadata>
    <!-- Datasetin tyyppi "update" pitää sisällään päivitystietoa (vain tämä käytössä tällä hetkellä). Toinen mahdollinen arvo "snapshot" kuvaa datan tietyn hetkistä tilannetta vrt. irrotus -->
    <type>Update</type>
    <!-- Pitää sisällään yksittäisen muutoksen tiedot. Voi olla joko tyhjä <roadFeatures /> tai näitä voi olla useampi ( 0..* ) -->
    <!-- Tarkemmin yksittäisien tietolajien muutossanoman sisällöstä löytyy alasivuilta -->
    <roadFeatures />
</RoadFeatureDataset>


HTTP error responses:

HTTP 400 (BadRequest) if

•    dataSetID parameter missing or invalid

Other possible mistakes

•    The TN-ITS interface has been implemented using the AWS API Gateway. Possible API Gateway error messages are listed on the AWS website (https://docs.aws.amazon.com/apigateway/latest/developerguide/supported-gateway-response-types.html).

Content-type:


application/xml

Versions:


2022-03 Initial

Example:


Example: (Call to prod environment): Retrieves the contents of the dataset (id: "+QBW3IlFSIWYYPDwF4Vc/QAAAYBOyKC7AAABgFPuEls=" url encoded: "%2BQBW3IlFSIWYYPDwF4Vc%2FQAAAYBOyKC7AAABgFPuEls%3D").

curl -L https://avoinapi.vaylapilvi.fi/tnits/public/download/readDataSet?dataSetID=%2BQBW3IlFSIWYYPDwF4Vc%2FQAAAYBOyKC7AAABgFPuEls%3D

An example of the content and structure of return value:
%2BQBW3IlFSIWYYPDwF4Vc%2FQAAAYBOyKC7AAABgFPuEls%3D.xml