... | ... | @@ -132,85 +132,27 @@ En el tópico se publican los eventos en formato JSON. Aquí se puede ver un eje |
|
|
]
|
|
|
```
|
|
|
|
|
|
Descripción de los campos para el caso de uso de eventos deportivos a través de la plataforma DGT 3.0. Publica la información geométrica del evento junto con sus carreteras, pk y horarios de paso:
|
|
|
|
|
|
**(*)= Campo que pueden no aparecer en el JSON publicado**
|
|
|
|
|
|
- **type** (string): identificador del Feature.
|
|
|
|
|
|
- **geometry**: Colección de coordenadas que representan el resultado de realizar el seguimiento de una prueba deportiva. Esta colección de coordenadas estará contenida en la colección representada por el campo _geom_ de este mismo documento JSON. De la colección de coordenadas de seguimiento que se publica la primera de la lista se corresponde con la ubicación del coche de cola, mientras que la última de la lista se corresponde con el coche de cabeza.
|
|
|
|
|
|
- **type**(string): identificador del tipo de geometría.
|
|
|
|
|
|
- **coordinates**: Colección de coordenadas del rutómetro.
|
|
|
|
|
|
- **properties**: Propiedades del schema para la publicación de eventos deportivos.
|
|
|
|
|
|
- **eventoId** (integer):Identificador del evento deportivo
|
|
|
|
|
|
- **etapaId** (integer): Identificador de la etapa que pertenece a un evento deportivo único definido por el campo _**idEvento**_.
|
|
|
|
|
|
- **objectid_1** (integer): Identificador del tramo que pertenece a una etapa única definida por el campo _**etapaId**_.
|
|
|
|
|
|
- **(*) objectid**(integer): Identificador del objeto según GIS.
|
|
|
|
|
|
- **ddtram_cod**(integer): Identificador oficial del tramo en BDC (Base de Datos de Carreteras)
|
|
|
|
|
|
- **ddcar_codi**(string): Identificador de la carretera en BDC (Base de Datos de Carreteras)
|
|
|
|
|
|
- **ddcar_deno**(string): Denominación de carretera en BDC (Base de Datos de Carreteras)
|
|
|
|
|
|
- **ddtram_den**(string): Denominación del tramo en base de datos de carreteras
|
|
|
|
|
|
- **ddtram_tip**(string):Tipología del titular del tramo en bases de datos de carreteras
|
|
|
|
|
|
- **ddtram_tit**(string): Nombre del titular del tramo en bases de datos de carreteras
|
|
|
|
|
|
- **ddtram_t_1**(string):Tipología del tramo en base de datos de carreteras
|
|
|
|
|
|
- **(*) ddtram_lon**(integer):Longitud total del tramo en base de datos de carreteras
|
|
|
|
|
|
- **pk_ini**(string): Punto kilométrico de inicio del tramo y oficial del tramo en base de datos de carreteras.
|
|
|
|
|
|
- **pk_fin**(string): Punto kilométrico de fin del tramo y oficial del tramo en base de datos de carreteras.
|
|
|
|
|
|
- **(*) dtipovian**(string): Tipología de la carretera en Bases de datos de carreteras
|
|
|
|
|
|
- **ddprov_pro**(string): Provincia del tramo en base de datos de carreteras
|
|
|
|
|
|
- **(*) ddcom_comu**(string): Comunidad autónoma del tramo en base de datos de carreteras
|
|
|
|
|
|
- **(*) color**(string): Color de vía segun GIS para mapamovilidad.es
|
|
|
|
|
|
- **(*) pkinigis**(integer): Punto kilométrico de inicio del tramo según el GIS.
|
|
|
|
|
|
- **(*) pkfingis**(integer): Punto kilométrico de fin del tramo según GIS.
|
|
|
|
|
|
- **(*) shape_leng**(numeric): Longitud de la forma según coordenadas
|
|
|
|
|
|
- **ddcar_carr**(string): Nomenclatura oficial de la carretera en base de datos de carreteras
|
|
|
|
|
|
- **pk_inicio_tram_etp**(integer): Punto kilométrico de inicio de ocupación del tramo etapa.
|
|
|
|
|
|
- **pk_fin_tram_etp**(integer): Punto kilométrico de fin de ocupación del tramo etapa.
|
|
|
|
|
|
- **tipo_vialidad**(string): Descripción de la vialidad por la que se ve afectado el tramo
|
|
|
|
|
|
- **cod_vialidad**(string): Código identificativo de la vialidad por la que se ve afectado el tramo
|
|
|
|
|
|
- **geom**(string): Colección de coordenadas que representan la ruta total del tramo sobre el que se está haciendo el seguimiento. De la colección de coordenadas de que se publica, la primera de la lista se corresponde con la ubicación donde comienza el evento, mientras que la última de la lista se corresponde con la ubicación donde este finaliza.
|
|
|
|
|
|
- **tsinicio**(ZonedDateTime): Fecha de inicio de la prueba.
|
|
|
|
|
|
- **tsfin**(ZonedDateTime): Fecha de fin de la prueba.
|
|
|
|
|
|
- **evento** (String): Denominación del evento resuelto en DGT
|
|
|
|
|
|
- **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.
|
|
|
A continuación se presenta una descripción de cada uno de los campos del JSON anterior. Dicho JSON, publica la información de una congestión concreta así como las velocidades recomendadas en diferentes puntos:
|
|
|
|
|
|
En el documento se publica una lista de carreteras afectadas en las que existe un atasco, cada una de ellas esta formada por un campo properties y recommendedSpeeds. Es decir, cada conjunto de estos dos campos referencia a una carretera diferente con recomendaciones de velocidad diferentes.
|
|
|
|
|
|
-**Properties:** Contiene información relativa a la zona afectada.
|
|
|
-**Lat:** Latitud donde comienza el atasco.
|
|
|
-**Lon:** Longitud donde comienza el atasco.
|
|
|
-**Timestamp(Fecha UTC)**: Fecha y hora en formato UTC del momento en el que el evento se ha generado.
|
|
|
-**Vialidad.**
|
|
|
-**RoadDescription:** Nombre de la carretera o carreteras que se ven afectadas.
|
|
|
-**Direction:** La dirección de la carretera sobre la que se aplica el algoritmo. Puede tener valores 1 (Ascendente) o 0 (Descendente).
|
|
|
-**AffectedLength:** Longitud, en metros, del tramo en el que actualmente hay una retención. Cuanto mayor sea esta distancia mayor será la distancia entre velocidades recomendadas.
|
|
|
-**RoadMaxSpeed:** Velocidad máxima de la vía, en Km/h.
|
|
|
-**RecommendedSpeeds:** Contiene las velocidades recomendadas en los distintos tramos.
|
|
|
-**Speed:** Velocidad recomendada.
|
|
|
-**kmStart:** Punto de inicio de la zona de recomendación. Representa la distancia desde el punto de origen en la que comienza la zona de velocidad recomendada.
|
|
|
-**kmEnd:** Punto de finalización de la zona de recomendación. Representa la distancia desde el punto de origen en la que finaliza la zona de velocidad recomendada.
|
|
|
|
|
|
## Errores
|
|
|
|
|
|
Todas las respuestas HTTP que no sean **200 – OK**, se pueden considerar **inválidas**. No obstante, determinados métodos de la API pueden responder con código **202 - ACCEPTED** junto con una descripción indicando el motivo de aceptación. Independientemente de si el código del mensaje es 202 o uno de error, el formato de la respuesta es como el siguiente ejemplo:
|
|
|
Todas las respuestas HTTP que no sean **200 – OK**, se pueden considerar **inválidas**. Independientemente del mensaje de error, el formato de la respuesta es como el siguiente ejemplo:
|
|
|
|
|
|
```json
|
|
|
{
|
... | ... | @@ -220,15 +162,6 @@ Todas las respuestas HTTP que no sean **200 – OK**, se pueden considerar **inv |
|
|
}
|
|
|
```
|
|
|
|
|
|
#### Respuestas parcialmente satisfactorias
|
|
|
|
|
|
- HTTP Status: **202 - Accepted**
|
|
|
|
|
|
| Code | Message |
|
|
|
| ---- | ---------------------------------------------------------------- |
|
|
|
| 27 | One more Beacon is expected in order to do the dynamic tracking |
|
|
|
|
|
|
|
|
|
La información relativa a los errores en este caso de uso se puede encontrar aquí. Estos errores tendrán tres categorías principales:
|
|
|
|
|
|
#### Error de Autentificación
|
... | ... | |