Caso de Uso 4
Bandeja de Salida
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:
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.
Tablas maestras
-
Los detalles de las tablas maestras y datos que pueden componer el evento. La API pone a disposición de los usuarios una serie de endpoints con los datos que componen el evento principal:
-
https://pre.cmobility30.es/bandejadesalida/v1/mastertables/categories
-
https://pre.cmobility30.es/bandejadesalida/v1/mastertables/modes
-
https://pre.cmobility30.es/bandejadesalida/v1/mastertables/geomtypes
-
https://pre.cmobility30.es/bandejadesalida/v1/mastertables/direction
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').
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