Tiempo real¶
El tiempo real tiene una sola fuente —el dispositivo del conductor— y dos salidas: la supervisión del lado del operador y la información a los viajeros del lado del público.
La cadena, del vehículo al viajero¶
- El dispositivo del conductor transmite su posición y el avance de la expedición que realiza.
- La API deduce de ello el avance real: paradas atendidas, adelanto-retraso, posición sobre el trazado.
- Estos elementos alimentan los flujos normalizados que consumen los planificadores de viaje y las pantallas.
Cada etapa puede leerse en la API, pero no en el mismo lugar ni con la misma actualidad: la posición de un vehículo se consulta en el instante, mientras que el rastro de lo que ha ocurrido se consulta en el historial.
Sin dispositivo, no hay tiempo real¶
Esta es la dependencia que debe recordarse: una expedición cuyo dispositivo no está en servicio no se sigue. Sigue prevista en el referencial, pero ningún dato realizado la concierne: ni posición, ni adelanto-retraso, ni paso por las paradas.
El dispositivo conoce la expedición que realiza en un instante dado, designada por el triplete descrito en la página anterior. También indica su estado de conexión, lo que permite distinguir un vehículo detenido de un vehículo que ha dejado de transmitir.
| Endpoint | Función |
|---|---|
GET /api/v4/groups/<group_id>/devices |
Lista los dispositivos y su estado actual |
GET /api/v4/groups/<group_id>/devices/online |
Lista los dispositivos conectados en este momento |
GET /api/v4/groups/<group_id>/vehicle-movements |
Proporciona los desplazamientos, incluidos los realizados fuera de expedición comercial |
Un llamante no autenticado recibe una respuesta reducida en la lista y el detalle de los dispositivos: se conservan la posición, el rumbo, la actualidad, la línea/expedición y la ocupación, mientras que se retiran los campos reservados al operador y se excluyen los dispositivos archivados.
Lo que se difunde a los viajeros¶
Dos formatos normalizados difunden el mismo estado de la red, con dos formalismos distintos. La elección depende de lo que espera el consumidor, no de lo que prefiere Pysae.
| Formato | Utilizado por | Ver |
|---|---|---|
| GTFS-RT | Planificadores de viaje, aplicaciones para viajeros | gtfs-rt |
| SIRI | Sistemas europeos de información a los viajeros, autoridades de transporte | siri |
| Endpoint | Función |
|---|---|
GET /api/v4/groups/<group_id>/gtfs-rt |
Proporciona el flujo GTFS-RT del grupo |
GET /api/v4/groups/<group_id>/siri |
Proporciona el flujo SIRI del grupo |
Estos flujos son un producto, no una fuente: agregan el referencial, las posiciones de los dispositivos, las alertas y las modificaciones de expedición. Por tanto, una discrepancia observada en un flujo se diagnostica remontándose a aquella de estas entradas que la contiene.
En los TripUpdate GTFS-RT, una salida observada permanece asociada a la parada abandonada,
incluso cuando el vehículo se dirige directamente a una parada posterior.
Una evolución del retraso no desplaza esa salida ya observada. Mientras no se
conozca ninguna salida, el horario publicado sigue siendo una estimación basada en el retraso
actual, incluso para la parada en la que el vehículo sigue estacionado.
En las posiciones GTFS-RT, position.bearing indica el rumbo en grados en sentido
horario desde el norte: 0° corresponde al norte y 90° al este. Cuando se
conoce, el rumbo se normaliza en [0, 360) tanto en el flujo completo como en el flujo
de posiciones, en binario y en JSON. Un rumbo desconocido permanece ausente; 0° indica un
rumbo conocido hacia el norte.
Las perturbaciones¶
Dos objetos distintos alimentan la parte de «perturbación» de los flujos, y no deben confundirse:
- una alerta es un mensaje destinado a los viajeros: obras, evento, parada no atendida;
- una modificación de expedición es un cambio del servicio en sí: parada suprimida, expedición desviada. En el flujo GTFS-RT, se publica a la vez como
TripUpdate(paradas omitidas, retraso) y como entidadTripModifications(paradas de sustitución, trazado modificado).
Una misma perturbación real suele dar lugar a ambos: el servicio cambia y se anuncia.
Una parada de sustitución que el GTFS estático no contiene —una parada creada para el
desvío, o una parada existente atendida en otro lugar— se publica en el flujo como una
entidad Stop que acompaña a la TripModifications, con un identificador propio con el prefijo
rt-stop:. Este identificador designa la posición descrita por el desvío, y solo esa:
nunca reutiliza el identificador de la parada del GTFS estático, de modo que una parada
desplazada para ciertas expediciones permanece sin cambios para todas las demás.
Y después¶
El tiempo real dice lo que hacen los vehículos. Queda por saber quién los conduce y según qué organización: ese es el objeto de la página Explotación.