Este caso de uso dispone de una API REST para la publicación (envío) de los datos existen dos tipos de publicadores:
-
Los Organizadores del Evento que utilizando las señales V2, indican la situación en tiempo real de la prueba.
-
Los dispositivos repartidos en la prueba, conos, que indican los diferentes cortes de carreteras que afectan a la prueba en cuestión.
Metodos requeridos para la integración con señales V2
Actualización de la información dinámica del progreso de un evento deportivo
El evento es la parte principal de esta API de ingesta de datos. Con este evento se podrá actualizar la información del evento deportivo. Con ella se actualizará la información recibida por las señales V2 de los coches escoltas situados en la cabeza y la cola del evento deportivo. La información se enviará con los siguientes campos en el formato siguiente:
Información sobre el endpoint:
-
Method: POST
-
URL: {baseUrl}/v1/tracking/event
-
Body:
{
"actionId": "CLI_235",
"beaconId": "cff92179-dc0a-47da-bd9e-5e9c5b14d251",
"beaconTypeId": 1,
"timestamp": "2021-03-15T13:34:00.000Z",
"lon" : "-7.009654361999935",
"lat" : "38.52736428400004",
"hdop" : 5,
"speed": 50
}
* = Campo requerido
-
(*) actionId (texto): identificador único del evento
-
(*) beaconId (texto): identificador único de la baliza (por ejemplo, la MAC)
-
(*) beaconTypeId (número entero): identificador del tipo de baliza. Posibles valores en /beaconTypes. 1 = Start, 2 = End. Los valores (3 = Intermediate y 4 = Unique) no aplican en este tipo de evento.
-
(*) 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.
-
(*) 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
-
(*) hdop (número entero): valor DOP para determinar la calidad de la información del GPS. Más información aquí
-
(*) 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
Nota: Para identificar un evento que requiere un seguimiento dinámico (tipo de seguimiento que requiere dos balizas), cada una deberá ser identificada con su respectiva posición en la prueba:
- Si la baliza está en el vehículo de cabeza, el valor del campo beaconTypeId será 1= Start.
- Si la baliza está en el vehículo de cola, el valor del campo beaconTypeId será 2= End.
Actualización de la información estática del progreso de un evento deportivo
El evento es la parte principal de esta API de ingesta de datos. Con este evento se podrá actualizar la información del evento deportivo. Con ella se actualizará la información recibida por las señales V2 a medida que se complete el evento. La información se enviará con los siguientes campos en el formato siguiente:
Información sobre el endpoint:
-
Method: POST
-
URL: {baseUrl}/v1/tracking/event
-
Body:
{
"actionId": "CLI_235",
"beaconId": "cff92179-dc0a-47da-bd9e-5e9c5b14d251",
"beaconTypeId": 4,
"timestamp": "2021-03-15T13:34:00.000Z",
"lon" : "-7.009654361999935",
"lat" : "38.52736428400004",
"hdop" : 5,
"speed": 50
}
* = Campo requerido
-
(*)actionId (texto): identificador único del evento
-
(*)beaconId (texto): identificador único de la baliza (por ejemplo, la MAC)
-
(*)beaconTypeId (número entero): identificador del tipo de baliza. El unicó posible valor es beaconType/ 4=Unique. El resto de valores no aplican para este método de seguimiento.
-
(*)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.
-
(*)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
-
(*)hdop (número entero): valor DOP para determinar la calidad de la información del GPS. Más información aquí
-
(*)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
Nota: Para identificar un evento que requiere un seguimiento estático (tipo de seguimiento que requiere una única baliza), la baliza deberá ser identificada con un valor del campo beaconTypeId de 4= Unique.
Metodos requeridos para la integración de conos conectados
Publicación de la ubicación de un cono
Los conos se utilizan para cortar las diferentes carreteras que hay en el perímetro de la prueba deportiva. El cono enviará su posicionamiento cada cierto periodo de tiempo. Una vez el cono se desactiva significa que la carretera ha quedado liberada y se puede restablecer la circulación por la misma.
Información sobre el endpoint:
-
Method: POST
-
URL: {baseUrl}/v1/cone/event
-
Body:
{
"actionId": "CLI_123",
"beaconId": "862506044003724",
"beaconTypeId": 4,
"timestamp": "2021-03-15T13:34:00.000Z",
"lat": 41.456123,
"lon": 1.928123,
"vehicleTypeId": 0,
"eventTypeId": 2,
"hdop": 1,
"deviceTypeId": 3,
"deviceUseTypeId": 3,
"speed": 0
}
(*)= Campo requerido
· (*)actionId (string): Identificador único del evento
· (*)beaconId (string): Identificador único de la baliza (por ejemplo, la MAC)
· (*)beaconTypeId (número entero): Identificador del tipo de baliza. El único posible valor es /beaconTypes. 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 15 segundos de antiguedad con respecto a la hora UTC y que no sea un timestamp a futuro.
· (*)lat (número decimal): latitud 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
· (*)vehicleTypeId (número entero): Identificador del tipo de vehículo. Para este caso de uso el único valor que aplica dentro de los posibles valores en /vehicleTypeId es 0= None .
· (*)eventTypeId (número entero): identificador del tipo de evento. Posibles valores en /eventTypes. 1 = Encendido, 2 = Activado, 3 = Apagado.
· (*)hdop: Valor DOP para determinar la calidad de la información del GPS. Más información aquí
· (*)deviceTypeId: Identificador del tipo de dispositivo desde el que se envía la información. El valor es /DeviceTypes. 3= Cono.
· (*)deviceUseTypeId: Identificador del tipo de uso del dispositivo que envía la información. deviceUseTypeId =3 para infraestructura
· (*)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
Requisitos cono
Con objeto de mantener la calidad de los mensajes se aplicarán los siguientes requisitos al contenido de los mensajes:
- La posición geográfica debe estar contenida en el territorio español
- La posición proporcionada por el GPS no debe tener un error mayor a 5 metros
- Se establece a continuación el orden, cantidad y frecuencia de los mensajes:
- Eventos de tipo Encendido, un único mensaje (opcional).
- Eventos de tipo Activado, tantos mensajes cómo dure la actividad de la baliza con una frecuencia de 10 minutos entre mensajes.
- Eventos de tipo Apagado, un único mensaje.