... | ... | @@ -6,7 +6,7 @@ Se utilizarán balizas V-2 para realizar el seguimiento de los eventos y conos c |
|
|
|
|
|
La información de balizamiento de los vehículos especiales que llega al usuario final dependerá de la implementación realizada por el agente/tercero que consume la información de la plataforma DGT 3.0 y la publica a través del sistema de información del vehículo, aplicación móvil u otros dispositivos.
|
|
|
|
|
|
La plataforma cuenta con dos funcionalidades diferenciadas para la **publicación (envío)** y para la **suscripción (recepción)** de información. La primera es a través de una API REST y la segunda a través de un servicio MQTT en tiempo real.
|
|
|
La plataforma cuenta con dos funcionalidades diferenciadas para la **publicación (envío)** y para la **suscripción (recepción)** de información. La primera es a través de una API REST del caso de uso y la segunda a través de un servicio MQTT en tiempo real. Además la información de cortes de vía se publicará por bandeja de salida.
|
|
|
|
|
|
Tanto la funcionalidad de publicación como de suscripción requieren de certificados de acceso distintos que deben ser solicitados y suministrados por DGT 3.0. Estos certificados, de no haber sido solicitados ya, se deberán solicitar a *[soporte@cmobility30.es](mailto:soporte@cmobility30.es)*.
|
|
|
|
... | ... | @@ -17,8 +17,6 @@ A continuación se muestran las URLs con las que se accede a cada funcionalidad: |
|
|
| Publicación | https://pre.cmobility30.es/use-case-10 | Endpoint del entorno de integración de clientes para la publicación (ciertos métodos de publicación serán accesibles para el consumo) |
|
|
|
| Suscripción | mqtt://mqtt.pre.cmobility30.es:8883 | Endpoint del entorno de integración para la suscripción |
|
|
|
|
|
|
A continuación se describen las dos funcionalidades.
|
|
|
|
|
|
## Publicación
|
|
|
|
|
|
Este caso de uso dispone de una API REST para la publicación (envío) de los datos por parte de las empresas que así lo deseen. En los siguientes apartados se pueden encontrar los detalles de esta:
|
... | ... | @@ -31,18 +29,15 @@ Este caso de uso dispone de una API REST para la publicación (envío) de los da |
|
|
|
|
|
> [Metodos de publicación](publicacion/Metodos)
|
|
|
|
|
|
**Nota:** *Algunos métodos de publicación para la obtención de información también podrán ser utilizados por los consumidores .*
|
|
|
|
|
|
## Suscripción
|
|
|
|
|
|
Este caso de uso también dispone de un servicio de suscripción (recepción) de datos por parte de las empresas que así lo deseen mediante el protocolo MQTT. Este caso de uso es solo para **los servicios de seguimiento de las pruebas o eventos deportivos**, si se desea la suscripción a la información de eventos de conos (cortes de carretera) se debe hacer a través de la interfaz de bandeja de salida que puede encontrarse en:
|
|
|
|
|
|
[Caso de uso 4. Panel de mensajes virtual](https://gitlab.cs.cmobility30.es/dgt3.0_esp/caso-de-uso-4)
|
|
|
Este caso de uso también dispone de un servicio de suscripción (recepción) de datos por parte de las empresas que así lo deseen mediante el protocolo MQTT. Este caso de uso es solo para **los servicios de seguimiento de las pruebas o eventos deportivos**, si se desea la suscripción a la información de eventos de conos (cortes de carretera) se debe hacer a través de la interfaz de bandeja de salida que puede encontrarse en el [Caso de uso 4. Panel de mensajes virtual.](https://gitlab.cs.cmobility30.es/dgt3.0_esp/caso-de-uso-4)
|
|
|
|
|
|
|
|
|
A continuación se pueden encontrar los detalles de la suscripción MQTT para este caso de uso 10 (Eventos deportivos):
|
|
|
|
|
|
**MQTT (MQ Telemetry Transport)** es un protocolo de mensajería que se usa como un método simple y liviano para transferir datos hacia/desde dispositivos de baja potencia.
|
|
|
**MQTT (MQ Telemetry Transport)** es un protocolo de mensajería que se usa como un método simple y liviano para transferir datos hacia/desde dispositivos de baja potencia. Puede ver más información y un ejemplo de conexión [aquí].(https://gitlab.cs.cmobility30.es/dgt3.0_esp/general/-/wikis/MQTT).
|
|
|
|
|
|
El protocolo admite un único patrón de mensajería, el patrón **Publicar-Suscribir**: cada mensaje es publicado en un tópico al que se debe suscribir para recibir la información.
|
|
|
|
... | ... | @@ -133,7 +128,7 @@ En el tópico se publican los eventos en formato JSON. Aquí se puede ver un eje |
|
|
]
|
|
|
```
|
|
|
|
|
|
Descripción de los campos para el CU de eventos deportivos a través de la plataforma DGT 3.0. Publica la información geométrica del evento junto con sus carreteras, pk y horarios de paso:
|
|
|
Descripción de los campos para el caso de uso de eventos deportivos a través de la plataforma DGT 3.0. Publica la información geométrica del evento junto con sus carreteras, pk y horarios de paso:
|
|
|
|
|
|
- **type** (string): identificador del Feature.
|
|
|
|
... | ... | @@ -211,13 +206,9 @@ Descripción de los campos para el CU de eventos deportivos a través de la plat |
|
|
|
|
|
- **timestamp** (Fecha UTC): Fecha y hora en formato UTC del momento en el que el evento se ha generado. Es necesario que sea de un máximo de 30 segundos de antiguedad con respecto a la hora UTC.
|
|
|
|
|
|
Ver más información y un ejemplo de conexión [aquí](https://gitlab.cs.cmobility30.es/dgt3.0_esp/general/-/wikis/MQTT).
|
|
|
|
|
|
**Nota:** *La información que se está publicando en el entorno de desarrollo es una simulación con información no real que va cambiando a lo largo del día, de forma que se pueda probar la interface de consumo.*
|
|
|
|
|
|
## Errores
|
|
|
|
|
|
Como se ha indicado anteriormente, todas las respuestas HTTP que no sean **200 – OK**, se pueden considerar **inválidas**. El formato de la respuesta de error es como el siguiente ejemplo:
|
|
|
Todas las respuestas HTTP que no sean **200 – OK**, se pueden considerar **inválidas**. El formato de la respuesta de error es como el siguiente ejemplo:
|
|
|
|
|
|
```json
|
|
|
{
|
... | ... | @@ -227,9 +218,7 @@ Como se ha indicado anteriormente, todas las respuestas HTTP que no sean **200 |
|
|
}
|
|
|
```
|
|
|
|
|
|
*Esto no aplica para el **Caso de Uso 10 - Eventos deportivos**. La información relativa a los errores en ese caso se puede encontrar aquí.
|
|
|
|
|
|
Estos errores tendrán tres categorías principales:
|
|
|
La información relativa a los errores en estee caso de uso se puede encontrar aquí. Estos errores tendrán tres categorías principales:
|
|
|
|
|
|
#### Error de Autentificación
|
|
|
|
... | ... | |