Receiving and sending messages
NAP uses DATEX II protocol in versions 3.4, 3.5, and 3.7. 2 operating modes have been implemented:
- Push on Occurrence – in this mode NAP sends messages after changes in difficulties to the given address
- Client Pull – in this mode the client can download the whole content of current difficulties set.
In both modes, the call proceeds with the WebService protocol. Use of Push on Occurrence is the preferred mode of operation. Client Pull mode is intended for use after the registration, after a longer pause in the work of receiving software or in the case of recovering the work after failure.
Receiving information – Push on Occurrence
NAP attempts sending a message about difficulties immediately after receiving information about it. Every occurrence of a new difficulty will result in NAP attempt to contact registered data recipients.
Downloading all available information – Client Snapshot Pull
Data recipient can download all information about difficulties by means of one call. The use of this method involves some restrictions.
The D2Light mechanism applies only to the Situations profile. Additional method of situations data downloading is "D2Light" mode. Data Recipient can download all information about difficulties.
D2Light interface implementation was made according to https://docs.datex2.eu/v3.4/downloads/d2light.html. JSON Schema of the response matches JSON Situation Publication Schema Definition mapping.
DATEX II DATA PROFILES
| Data profile | WSDL | Exemplary requests | DATEX II version |
|---|---|---|---|
| Situations | wsdl.zip | Example | 3.4 |
| Alternative fuels | wsdl-paliwa.zip | Static Dynamic |
3.5 |
| VMS – Variable Message Signs | wsdl-vms.zip | Static Dynamic |
3.7 |
| Parking | wsdl-parkingi.zip | Static Dynamic |
3.7 |
| Traffic Regulation | wsdl-przepisy.zip | Example 1 Example 2 |
3.7 |
| Traffic Management | wsdl-szr.zip | Example | 3.7 |
| Traffic State | wsdl-warunki.zip | Static Dynamic |
3.7 |
EXEMPLARY CLIENT WEBSERVICE
Files to download with exemplary clients can be found below: