Caso de Uso 8
Punto central de difusión
Este caso de uso está deprecado.
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 (Mensajes MAPEM). 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):
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:
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í.
Información Disponible:
La información que se está publicando en el entorno de desarrollo es eal que va cambiando a lo largo del día, de forma que se pueda probar la interface de consumo. Esta información contiene los mensajes SPAT.
Para más información relativa al consumo de eventos semafóricos se puede consultar la siguiente documentación:
20190609_Propuesta_de_diseño_de_interfaces_para_información_de_topología.pdf