Saltar a contenido

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