Digiroad interfaces

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

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.

 

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.

 

 

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.

 

 

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