Explotación¶
Lo que ocurre durante el servicio: el avance real de las expediciones, las diferencias respecto al teórico y la supervisión en línea.
trip-events¶
Evento de expedición — un hecho fechado ocurrido durante una expedición: paso por una parada, salida, llegada, cambio de estado. El dispositivo transmite estos eventos a medida que avanza el servicio.
No se expone ningún identificador propio: un evento se sitúa por su expedición, su fecha y su marca de tiempo.
Estos eventos no se exponen en lectura. El desarrollo real de una expedición se consulta mediante el seguimiento de expedición, los pasos observados mediante el historial y la diferencia con los horarios mediante la puntualidad.
trip-updates¶
Modificación de expedición — una diferencia respecto al teórico decidida por el operador: parada suprimida, parada desplazada, parada añadida, expedición desviada o anulada. La modificación no reescribe el GTFS: se superpone al teórico durante un periodo determinado y se repercute en la difusión a los viajeros.
Identificador <trip_update_id>. Una modificación se aplica a una expedición y a un intervalo de fechas; los desvíos son un caso particular, identificado como tal.
Estas modificaciones se introducen desde las aplicaciones de Pysae y no se publican en el spec público. Su efecto, en cambio, es visible para los viajeros a través de los flujos GTFS-RT y SIRI.
trip-tracking¶
Seguimiento de expedición — la restitución de cómo se desarrolló una expedición: a qué hora pasó el vehículo por dónde y con qué diferencia respecto al horario previsto. Es la vista consolidada de la ejecución, la que se exporta para analizar el servicio prestado.
No tiene identificador propio: un seguimiento se refiere a una expedición y a su fecha.
| Endpoint | Función |
|---|---|
GET /api/v4/groups/<group_id>/stats/trip-tracking |
Agrega el seguimiento sobre un periodo |
GET /api/v4/groups/<group_id>/export/trip-tracking |
Exporta el detalle en formato CSV |
vehicle-movements¶
Movimiento de vehículo — un desplazamiento del vehículo vinculado a la explotación, incluso fuera de expedición comercial: posicionamiento hasta el inicio de la expedición, regreso a la cochera, recorrido en vacío. Estos movimientos completan las expediciones para restituir el uso completo del vehículo.
Identificador <vehicle_movement_id>. Un movimiento puede vincularse a un bloque, la secuencia de expediciones encadenadas por un mismo vehículo.
| Endpoint | Función |
|---|---|
GET /api/v4/groups/<group_id>/vehicle-movements |
Lista los movimientos de un periodo |
GET /api/v4/groups/<group_id>/blocks/<block_id>/vehicle-movements |
Proporciona los movimientos de un bloque |
vehicle-exploitation¶
Explotación del vehículo — la restitución de la actividad de un vehículo durante un periodo: lo que ha realizado, cuándo y sobre qué distancias. Sirve para el seguimiento de la flota y para los intercambios con los sistemas de gestión de flotas.
No tiene identificador propio: el dato se obtiene por vehículo y por periodo.
| Endpoint | Función |
|---|---|
GET /api/v4/groups/<group_id>/export/vehicle-exploitation |
Exporta la actividad de los vehículos en formato CSV |
danger-zones¶
Zona peligrosa — un punto de la red señalado a los conductores por requerir una vigilancia especial: paso estrecho, salida difícil, zona con alta siniestralidad. El dispositivo avisa al conductor al aproximarse.
Identificador <danger_zone_id>. Una zona se define por un punto geográfico, un radio y el mensaje mostrado.
| Endpoint | Función |
|---|---|
GET /api/v4/groups/<group_id>/danger-zones |
Lista las zonas declaradas en la red |