C

Caso de Uso 4

Panel de mensajes virtual.

Gracias al caso de uso 4 la Dirección General de Tráfico cuenta con una herramienta para poder publicar en cualquier punto kilométrico de cualquiera de las carreteras nacionales información que estime oportuna (advertirles de posibles peligros, publicación de zonas de bajas emisiones, activación de protocolos de bajas emisiones, dar recomendaciones en cualquier punto, tramo o área de la red viaria, etcétera)

En esta documentación se expone como las empresas integradoras pueden acceder y consumir esta información junto con la relativa publicada al caso de uso 1 (señales bandejadesalida/v16), caso de uso 2 (obras e incidencias) y el balizamiento de las pruebas deportivas del caso de uso 10 .

Requisitos previos para la conexión

  • Por motivos de seguridad, las conexiones serán nube a nube. La petición será realizada desde la nube de la empresa integradora y nunca desde los dispositivos directamente.

  • DGT 3.0 facilitará un certificado y añadirá la IP pública del servidor desde donde se realizarán las peticiones a una lista blanca.

  • Una vez obtenido lo anterior, se configurará un cliente en cualquier tipo de lenguaje o plataforma que sea capaz de realizar peticiones API REST (como por ejemplo Postman).

API REST

La API REST está alojada en el siguiente dominio:

https://pre.cmobility30.es/bandejadesalida/

Publicación desde la plataforma

Para publicar información la plataforma dispone una API REST que se utiliza según se describe a continuación

Identificación en el servicio

Para llevar a cabo las operaciones del API es necesario obtener un token de sesión que caducará de forma aleatoria a lo largo de la misma.

General · (cmobility30.es)

Tablas maestras

El formato será:

{
    "errorCode": 0,
    "errorDesc": "OK",
    "data": [
        {
            "id": 1,
            "name": "Punto"
        }
    ]
}

Obtener eventos

En este endpoint se va a obtener toda la información publicada relativa a los casos de uso 1 (señales bandejadesalida/v16), caso de uso 2 (obras e incidencias), caso de uso 4 (publicación por parte DGT Paneles de Mensaje Variables Virtuales) que se encuentren activas en cada momento y el balizamiento de pruebas deportivas del caso de uso 10 (el atributo pmvMsg tendrá el valor 'Restriccion por evento deportivo').

https://pre.cmobility30.es/bandejadesalida/v1/events

Es un endpoint de tipo GET

Ejemplo de respuesta:

{
    "errorCode": 0,
    "errorDesc": "OK",
    "data": [
        {
            "pmvGeomWkt": "POINT(3.1896238 39.954075)",
            "pmvId": 120148781,
            "pmvMsg": "General",
            "pmvImg": "P50O",
            "pmvType": 1,
            "pmvProv": 37,
            "pmvRoad": "N-630a",
            "pmvPk": 322.0,
            "pmvPkIni": 0.0,
            "pmvPkFin": 0.0,
            "pmvDirection": 1,
            "pmvCategory": 0,
            "pmvMode": 1,
            "pmvProvFin": 0,
            "pmvRoadFin": 0,
            "pmvEvent": 0,
            "gid": "GUID_Suc_3009137_3009137"
        }
    ]
}

El significado de los campos es el siguiente:

Atributo Descripción
pmvGeomWkt Localización en formato WKT
pmvId Identificador interno del evento
pmvMsg Texto del mensaje
pmvImg Identificación del icono correspondiente a la señal de tráfico
pmvType Tipo de evento
pmvProv Código INE de la provincia donde se produce el evento
pmvRoad Etiqueta de la carretera donde se produce el evento
pmvPk PK donde se produce el evento, si es puntual
pmvPkIni PK inicial del evento si es un tramo
pmvPkFin PK final del evento si es un tramo
pmvDirection Dirección del kilometraje
pmvCategory Categoría del evento
pmvMode Modo del evento
pmvProvFin Código INE de la provincia final donde se produce el evento en caso de tramos
pmvRoadFin Etiqueta de la carretera final donde se produce el evento en caso de tramo
pmvEvent Tipo de evento
gid Identificador del evento en el sistema LINCE

Se debe disponer del certificado para acceder.

NAP - DATEXII

Mediante la operación GET al endpoint /bandejadesalida/v1/nap es posible la obtención de todas los eventos que se publican en el National Access Point de España que tiene bajo su responsabilidad DGT. El conjunto de datos devueltos sigue el estándar DATEXII

<?xml version="1.0" encoding="UTF-8"?>
<d2LogicalModel modelBaseVersion="1.0" xsi:schemaLocation="http://datex2.eu/schema/1_0/1_0 http://datex2.eu/schema/1_0/1_0/DATEXIISchema_1_0_1_0.xsd" xmlns="http://datex2.eu/schema/1_0/1_0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <exchange>
        <supplierIdentification>
            <country>es</country>
            <nationalIdentifier>dgt</nationalIdentifier>
        </supplierIdentification>
    </exchange>
    <payloadPublication xsi:type="_0:SituationPublication" lang="es" xmlns:_0="http://datex2.eu/schema/1_0/1_0">
    .....................
    .....................
    </payloadPublication>
</d2LogicalModel>

SRT - DATEXII

Mediante la operación GET al endpoint /bandejadesalida/v1/srtievents es posible la obtención de todas los eventos que se publican en la Bandeja de Salida que no se publican en el National Access Point de España que tiene bajo su responsabilidad DGT. El conjunto de datos devueltos sigue el estándar DATEXII. Actualmente esos eventos son los relacionados con Coche detenido (V-16) y Vehículos de asistencia en carretera