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.
| Endpoint | Función |
|---|---|
GET /api/v4/groups/<group_id>/trip-updates/search |
Busca las modificaciones vigentes |
PUT /api/v4/groups/<group_id>/trip-updates |
Registra una modificación |
GET /api/v4/groups/<group_id>/deviations |
Lista los desvíos |
POST /api/v4/groups/<group_id>/deviations/<trip_update_id>/duplicate |
Duplica un desvío en otro periodo, tras comprobar que sigue siendo aplicable al GTFS actual |
Para un desvío definido por un shape, la etiqueta indica las cabeceras de la expedición que atiende más paradas en ese shape dentro del GTFS aplicable al desvío. En caso de empate, se toma como referencia la expedición con el trip_id más pequeño.
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 |