Medición¶
Lo que se obtiene de la explotación una vez prestado el servicio: las distancias, la regularidad, la afluencia y el registro conservado de todo ello.
trip-km¶
Kilómetros recorridos — la distancia realizada, desglosada por expedición, por vehículo o por periodo. Sirve para la facturación por kilómetro, el seguimiento contractual y el dimensionamiento de la flota.
Sin identificador propio: el dato se obtiene por periodo y por ámbito.
| Endpoint | Función |
|---|---|
GET /api/v4/groups/<group_id>/stats/trip-km |
Agrega los kilómetros de un periodo |
GET /api/v4/groups/<group_id>/export/trip-km |
Exporta el detalle en formato CSV |
Los kilómetros en vacío, recorridos fuera de expedición comercial, figuran en el servicio de conducción; consulte duties.
punctuality¶
Puntualidad — la medida de la diferencia entre el horario previsto y la hora de paso real, agregada sobre un periodo. Es el indicador de calidad del servicio que más siguen las autoridades de transporte.
Sin identificador propio: el dato se obtiene por periodo y por ámbito.
| Endpoint | Función |
|---|---|
GET /api/v4/groups/<group_id>/stats/punctuality |
Agrega la puntualidad de un periodo |
GET /api/v4/groups/<group_id>/export/punctuality |
Exporta el detalle en formato CSV |
La medida se basa en los horarios teóricos (consulte stop-times) y en los pasos observados.
Un paso que un dispositivo telemático realizó antes de que su letrero mostrara la línea, reconstruido una vez mostrada la línea, no se cuenta ni en el agregado ni en la exportación. Permanece en el historial de pasos; el flujo de la expedición (trip-details-feed) lo indica con headsign_missing: true.
passenger-counts¶
Recuento de viajeros — el número de subidas y bajadas registrado en las paradas, por expedición. Procede de los sistemas de recuento embarcados y sirve para dimensionar la oferta.
Sin identificador propio: el dato se obtiene por periodo y por ámbito.
| Endpoint | Función |
|---|---|
GET /api/v4/groups/<group_id>/stats/passenger-counts |
Agrega la afluencia de un periodo |
GET /api/v4/groups/<group_id>/export/passenger-counts |
Exporta el detalle en formato CSV |
stats¶
Estadísticas — la familia transversal de los endpoints de agregación y exportación. No es una entidad en el sentido de las demás entradas: la etiqueta reúne los resultados calculados sobre las entidades anteriores, en dos formas constantes: un agregado bajo /stats/ y una exportación CSV bajo /export/.
| Endpoint | Función |
|---|---|
GET /api/v4/groups/<group_id>/stats/vehicles-used |
Cuenta los vehículos empleados en un periodo |
GET /api/v4/groups/<group_id>/stats/daily-devices |
Cuenta los dispositivos activos por día |
GET /api/v4/groups/<group_id>/vehicle-amount |
Proporciona el número de vehículos del grupo |
Las ocho exportaciones CSV de la especificación datahub (expediciones, conductores, vehículos, alertas, puntualidad, kilómetros, seguimiento de expedición, recuento de viajeros) constituyen la vía recomendada para alimentar un almacén de datos. Se describen en los ejemplos de recogida.
history¶
Historial — la conservación de lo ocurrido, más allá de la ventana de tiempo real: eventos transmitidos por los dispositivos, horarios observados en las paradas, GTFS vigente en las fechas correspondientes, kilómetros registrados. Es la fuente que hay que consultar para reconstruir una jornada pasada.
Sin identificador propio: el historial se consulta por ámbito y por periodo.
| Endpoint | Función |
|---|---|
GET /api/v4/groups/<group_id>/history/events |
Lista los eventos transmitidos por los dispositivos |
GET /api/v4/groups/<group_id>/history/stop-times |
Proporciona los pasos observados en las paradas (filtro opcional event: arrival o departure) |
GET /api/v4/groups/<group_id>/history/gtfs-active |
Proporciona el GTFS vigente en una fecha |
GET /api/v4/groups/<group_id>/devices/<device_id>/history |
Reconstruye la actividad de un dispositivo |
Los horarios observados que se conservan aquí no deben confundirse con los horarios previstos, que pertenecen a la referencia teórica; consulte stop-times.
Un cambio de expedición no constituye un paso por una parada. Los pasos de la nueva expedición se registran a partir de sus propios datos de parada; los de la expedición anterior se conservan.