|
|
A continuación se muestra la información relativa al cosumo de eventos semafóricos
|
|
|
El **caso de uso 8** está dedicado a la distribución de información semafórica entre los productores de este tipo de información y los consumidores, a través de la plataforma DGT 3.0.
|
|
|
|
|
|
Los servicios que implementan esta arquitectura permiten el intercambio de datos de forma síncrona y asíncrona. Los primeros se utilizarán para el envío de información estática afectada por pocos cambios, como la topología de los cruces. Los segundos se necesitan para el envío de información dinámica, relacionada con el estado de los cruces y cambios de fase de los semáforos.
|
|
|
|
|
|
Todas las peticiones que se realicen a la API deben ser enviadas a la siguiente URL (URL base):
|
|
|
|
|
|
> https://bandejadesalida-dev.cmobility30.es:8443
|
|
|
|
|
|
## Publicación
|
|
|
|
|
|
Para **publicar** información se dispone una API REST con los siguientes métodos disponibles:
|
|
|
|
|
|
**getAvailableAreas** (GET)
|
|
|
|
|
|
Permite obtener el listado de las áreas disponibles en el sistema. Solo se devolverán las dadas de alta en el momento de la consulta.
|
|
|
|
|
|
> https://bandejadesalida-dev.cmobility30.es:8443/urbanTrafficLights/1.0/getAvailableAreas
|
|
|
|
|
|
**getTopology** (POST)
|
|
|
|
|
|
Permite descargar la última topología en vigor para una zona geográfica determinada o planeada.
|
|
|
|
|
|
> https://bandejadesalida-dev.cmobility30.es:8443/urbanTrafficLights/1.0/getTopology
|
|
|
|
|
|
* Los detalles generales para realizar una petición:
|
|
|
|
|
|
> [General · (cmobility30.es)](https://gitlab.cmobility30.es/dgt3.0_esp/general/-/wikis/home)
|
|
|
|
|
|
* Los detalles de las tablas maestras y datos que pueden componer el evento:
|
|
|
|
|
|
> [Tablas Maestras](/dgt3.0_esp/caso-de-uso-5/-/wikis/publicacion/Tablas-Maestras)
|
|
|
|
|
|
* Información relativa al evento que se debe enviar:
|
|
|
|
|
|
> [Evento](/dgt3.0_esp/caso-de-uso-5/-/wikis/publicacion/Evento)
|
|
|
|
|
|
## Suscripción
|
|
|
|
|
|
La parte de suscripción al servicio del caso de uso 8 se hará mediante el protocolo MQTT.
|
|
|
|
|
|
**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**: 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 mediante los siguientes tópicos de entrada o salida:
|
|
|
|
|
|
• Entrada: Recibirán los mensajes desde el SIS.
|
|
|
|
|
|
in/1.0/incidences/areaCode/
|
|
|
in/1.0/status/areaCode/
|
|
|
in/1,0/trafficLighst/areaCode/
|
|
|
in/1.0/topology/deregister/areaCode/
|
|
|
|
|
|
• Salida: Publicarán mensajes accesibles a los CIS.
|
|
|
|
|
|
out/1.0/incidences/infraestructure/
|
|
|
out/1.0/incidences/trafficLighst/areaCode/
|
|
|
out/1.0/status/areaCode/
|
|
|
out/1,0/topology/register/areaCode
|
|
|
out/1,0/trafficLighst/areaCode/
|
|
|
|
|
|
Ver más información y un ejemplo de conexión [aquí](https://gitlab.cmobility30.es/dgt3.0_esp/general/-/wikis/MQTT).
|
|
|
|
|
|
#### Información Disponible:
|
|
|
|
|
|
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.
|
|
|
|
|
|
Para más información relativa al consumo de eventos semafóricos se puede consultar la siguiente documentación:
|
|
|
|
|
|
[20190520_Definición_de_protocolos_e_interfaces__para_la_recogida_y_distribución_de_información_semafórica_v.0.5.pdf](uploads/9ca8c8b8b0dcac4742c6f9e08719c939/20190520_Definición_de_protocolos_e_interfaces__para_la_recogida_y_distribución_de_información_semafórica_v.0.5.pdf)
|
|
|
|
... | ... | |