... | ... | @@ -4,16 +4,18 @@ El objetivo de este caso de uso es recopilar y publicar información en tiempo r |
|
|
|
|
|
Se persigue remitir a la plataforma las coordenadas x,y por parte del vehículo especial para permitir que sea detectado por otros vehículos más allá de la línea de visión directa.
|
|
|
|
|
|
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 ~~y la segunda a través de un servicio MQTT en tiempo real~~.
|
|
|
|
|
|
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*.
|
|
|
|
|
|
**Todo lo relacionado con MQTT está deshabilitado temporalmente.**
|
|
|
|
|
|
A continuación se muestran las URLs con las que se accede a cada funcionalidad:
|
|
|
|
|
|
| Modo | URL | Descripción |
|
|
|
| ----------- | ------------------------------------- | ------------------------------------------------------------------- |
|
|
|
| Publicación | https://pre.cmobility30.es/use-case-5 | Endpoint del entorno de integración de clientes para la publicación |
|
|
|
| Suscripción | mqtt://mqtt.pre.cmobility30.es:8883 | Endpoint del entorno de integración para la suscripción |
|
|
|
| ~~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.
|
|
|
|
... | ... | @@ -33,15 +35,15 @@ Este caso de uso dispone de una API REST para la publicación (envío) de los da |
|
|
|
|
|
> [Evento](publicacion/Evento)
|
|
|
|
|
|
## Suscripción
|
|
|
## ~~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. A continuación se pueden encontrar los detalles de esta:
|
|
|
~~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. A continuación se pueden encontrar los detalles de esta:~~
|
|
|
|
|
|
**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.~~
|
|
|
|
|
|
El protocolo admite un único patrón de mensajería, el patrón **Publicar-Suscribir** y cada mensaje es publicado en un tópico al que se debe suscribir para recibir la información.
|
|
|
~~El protocolo admite un único patrón de mensajería, el patrón **Publicar-Suscribir** y cada mensaje es publicado en un tópico al que se debe suscribir para recibir la información.~~
|
|
|
|
|
|
La suscripción al servicio de este caso de uso deberá ser al tópico:
|
|
|
~~La suscripción al servicio de este caso de uso deberá ser al tópico:~~
|
|
|
|
|
|
> usecase5/events
|
|
|
|
... | ... | @@ -64,33 +66,33 @@ En el tópico se publican los eventos en formato JSON. Aquí se puede ver un eje |
|
|
}
|
|
|
```
|
|
|
|
|
|
- actionId (texto): Identificador único del evento
|
|
|
- ~~actionId (texto): Identificador único del evento~~
|
|
|
|
|
|
- beaconId (texto): identificador único de la baliza (por ejemplo, la MAC)
|
|
|
- ~~beaconId (texto): identificador único de la baliza (por ejemplo, la MAC)~~
|
|
|
|
|
|
- beaconTypeId (número entero): identificador del tipo de baliza. 1 = Start, 2 = End, 3 = Intermediate, 4 = Unique
|
|
|
- ~~beaconTypeId (número entero): identificador del tipo de baliza. 1 = Start, 2 = End, 3 = Intermediate, 4 = Unique~~
|
|
|
|
|
|
- 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. La fecha debe finalizar con el caracter 'Z' que marca que está en UTC
|
|
|
- ~~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. La fecha debe finalizar con el caracter 'Z' que marca que está en UTC~~
|
|
|
|
|
|
- lon (número decimal): longitud de coordenadas de tipo WGS 84 donde se ha generado el evento
|
|
|
- ~~lon (número decimal): longitud de coordenadas de tipo WGS 84 donde se ha generado el evento~~
|
|
|
|
|
|
- lat (número decimal): latitud de coordenadas de tipo WGS 84 donde se ha generado el evento
|
|
|
- ~~lat (número decimal): latitud de coordenadas de tipo WGS 84 donde se ha generado el evento~~
|
|
|
|
|
|
- eventTypeId (número entero): identificador del tipo de evento. 1 = Activation, 2 = Actived, 3 = Deactivation, 4 = Forced deactivation
|
|
|
- ~~eventTypeId (número entero): identificador del tipo de evento. 1 = Activation, 2 = Actived, 3 = Deactivation, 4 = Forced deactivation~~
|
|
|
|
|
|
- speed (número decimal): velocidad en kilómetros por hora a la que se encuentra el elemento en el momento que envía el evento
|
|
|
- ~~speed (número decimal): velocidad en kilómetros por hora a la que se encuentra el elemento en el momento que envía el evento~~
|
|
|
|
|
|
- provinceId (número entero): identificador de la provincia donde se genera el evento según el [INE](https://www.ine.es/daco/daco42/codmun/cod_provincia_estandar.htm)
|
|
|
- ~~provinceId (número entero): identificador de la provincia donde se genera el evento según el [INE](https://www.ine.es/daco/daco42/codmun/cod_provincia_estandar.htm)~~
|
|
|
|
|
|
- road (número entero): nombre oficial de la carretera donde se genera el evento
|
|
|
- ~~road (número entero): nombre oficial de la carretera donde se genera el evento~~
|
|
|
|
|
|
- pk (número entero): punto kilométrico donde se genera el evento
|
|
|
- ~~pk (número entero): punto kilométrico donde se genera el evento~~
|
|
|
|
|
|
- direction (texto): dirección de la carretera donde se genera el evento. UP = Sentido ascendente, DOWN = Sentido descendente, UNKNOWN = Desconocido
|
|
|
- ~~direction (texto): dirección de la carretera donde se genera el evento. UP = Sentido ascendente, DOWN = Sentido descendente, UNKNOWN = Desconocido~~
|
|
|
|
|
|
Se puede encontrar más información y un ejemplo de conexión [aquí](https://gitlab.cs.cmobility30.es/dgt3.0_esp/general/-/wikis/MQTT).
|
|
|
~~Se puede encontrar 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.*
|
|
|
~~**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
|
|
|
|
... | ... | |