Use Case 13 is dedicated to information related to the protection in real time of cyclists circulating on the road network.
Within the DGT 3.0 platform, the following is implemented:
-
An interface that allows providers to send information in real time about their users who are riding bicycles on national roads
-
Publication of validated information through the outbox interface so that any third party authorized by DGT can consume the real-time location of cyclists to inform users of their applications / vehicles
-
The implementation of a logic to validate the information received to avoid problems derived from the inaccuracy of the GPS of the devices when sending their position and incorrect reception of the data.
All requests made to the API must be sent to the following URL (URL base):
Publication
To publish information, a REST API is available:
- General details for making a request:
- The details of the master tables and data that can compose the event:
- The structure of the event can be seen here:
Subscription
The service subscription part of use case 13 will be done using the MQTT protocol.
MQTT (MQ Telemetry Transport) is a messaging protocol used as a simple and lightweight method to transfer data to / from low-power devices.
The protocol supports a single messaging pattern, the Publish-Subscribe pattern: each message is published on a topic that must be subscribed to in order to receive the information.
Subscription to the service of this use case must be through the topic:
usecase13/events
See more information and a connection example here.