Actualizaciones de viaje

Las actualizaciones de viaje representan fluctuaciones en el horario. Esperamos recibir actualizaciones de viaje para todos los viajes que has programado, que sean aptos para tiempo real. Estas actualizaciones brindarían un horario de llegada o salida previsto para las paradas a lo largo de la ruta. Las actualizaciones de viaje también pueden prever escenarios más complejos en los cuales se cancelen o agreguen viajes al programa, o incluso se redirijan.

Recordatorio: En GTFS, un viaje es una secuencia de dos o más paradas que tienen lugar a una hora específica.

Debe haber como máximo una actualización de viaje para cada viaje programado. En caso de que no haya ninguna actualización de viaje para un viaje programado, se concluirá que no hay datos en tiempo real disponibles para el viaje. El consumidor de datos no debe asumir que el viaje se está realizando a horario.

Actualizaciones de horario de paradas

Una actualización de viaje comprende una o más actualizaciones a los horarios de parada del vehículo, que se conocen como StopTimeUpdates. Pueden proporcionarse para horarios de paradas pasados y futuros. Tienes permitido brindar horarios de parada pasados, pero no es obligatorio que los brindes. Cuando lo hagas, ten en cuenta que no debes proporcionar una actualización pasada si se refiere a un viaje todavía no programado para haber terminado (es decir, que finalizó antes de lo programado), ya que, de lo contrario, se concluirá que no hay actualización de ese viaje.

Cada StopTimeUpdate está vinculada a una parada. Normalmente, esto se puede hacer usando un GTFS stop_sequence o un GTFS stop_id. Sin embargo, en caso de que estés suministrando una actualización para un viaje sin un trip_id de GTFS, debes especificar el stop_id ya que stop_sequence no tiene valor. El stop_id todavía debe hacer referencia a un stop_id en GTFS.

La actualización puede proporcionar un horario exacto para la llegada o la salida en una parada en StopTimeUpdates mediante StopTimeEvent. Esto debe contener un horario absoluto o un retraso (es decir, una compensación desde el horario programado en segundos). El retraso solo se puede utilizar en caso de que la actualización de viaje se refiera a un viaje de GTFS programado, en contraposición con un viaje basado en la frecuencia. En este caso, el horario debe ser igual al horario programado + el retraso. También debes especificar la incertidumbre de la predicción junto con StopTimeEvent, que se analiza más detalladamente en la sección Incertidumbre más abajo en la página.

Para cada StopTimeUpdate, la relación de programación predeterminada es programada. (Ten en cuenta que es diferente de la relación de programación para el viaje). Puedes cambiarla a omitida si la parada no se va a utilizar o a sin datos si solo tienes datos en tiempo real para parte del viaje.

Las actualizaciones se deben clasificar por stop_sequence (o stop_id, en el orden en que tienen lugar en el viaje).

Si faltan una o más paradas a lo largo del viaje, la actualización se propaga a todas las paradas subsiguientes. Esto significa que, en caso de no haber otra información, al actualizar un horario de parada para una cierta parada, se cambiarán todas las paradas subsiguientes.

Ejemplo 1

Para un viaje con 20 paradas, una StopTimeUpdate con retraso de llegada y retraso de salida de 0 (StopTimeEvents) para la stop_sequence de la parada actual, significa que el viaje está exactamente a horario.

Ejemplo 2

Para la misma instancia de viaje, se proporcionan tres StopTimeUpdates:

  • retraso de 300 segundos para la stop_sequence 3
  • retraso de 60 segundos para la stop_sequence 8
  • retraso de duración no especificada para la stop_sequence 10

Esto se interpretará como:

  • las stop_sequences 3,4,5,6,7 tienen un retraso de 300 segundos.
  • las stop_sequences 8,9 tienen un retraso de 60 segundos.
  • las stop_sequences 10,..,20 tienen un retraso desconocido.

Descriptor de viajes

La información suministrada por el descriptor de viajes depende de la relación de programación del viaje que estás actualizando. Hay una cantidad de opciones que puedes configurar:

Programado Este viaje se está ejecutando de acuerdo con un programa de GTFS o se asemeja lo suficiente como para seguir estando asociado a él.
Agregado Este viaje no estaba programado y se ha agregado. Por ejemplo, para hacer frente a la demanda o reemplazar un vehículo averiado.
Sin programar Este viaje se está ejecutando y nunca se asocia con un programa. Por ejemplo, si no hay programa y los autobuses operan en un servicio de traslados.
Cancelado Este viaje se programó pero ahora se eliminó.
De reemplazo Este viaje reemplaza una parte del programa estático.

Si el selector de viaje identifica una cierta instancia de viaje, entonces solo se reemplaza esa instancia. Si el selector identifica una ruta, entonces se reemplazan todos los viajes de la ruta. El reemplazo solo se aplica a la porción del viaje suministrada. Por ejemplo, considera una ruta que atraviesa A,B,C,D,E,F y un viaje de reemplazo que proporciona datos para las paradas A,B,C. Entonces, los horarios de parada para las paradas D,E,F se siguen tomando del programa estático.

Un feed puede suministrar varios viajes de reemplazo. En este caso, la parte del programa estático que se reemplaza es lo que definen todos los viajes. Normalmente, todos los viajes de reemplazo deben corresponder a la misma ruta o a instancias individuales de viaje.




En la mayoría de los casos, debes proporcionar el trip_id del viaje programado en GTFS con el que se relaciona esta actualización. En caso de que no puedas vincular esta actualización con un viaje en GTFS, puedes brindar un route_id de GTFS, y una fecha y hora de inicio para el viaje. Generalmente, este es el caso de los viajes agregados, sin programar y de algunos tipos de viajes de reemplazo.

Incertidumbre

La incertidumbre se aplica tanto al horario como al valor de retraso de una StopTimeUpdate. La incertidumbre especifica, en términos generales, el error esperado en retraso verdadero como un entero en segundos (pero ten en cuenta que, el significado estadístico preciso todavía no está definido). Es posible que la incertidumbre sea 0, por ejemplo, para los trenes conducidos bajo control de horarios por computadora.

Como ejemplo, un autobús de larga distancia que tiene un retraso estimado de 15 minutos y llega a su siguiente parada con una ventana de error de 4 minutos (es decir, +2/-2 minutos) tendrá un valor de Incertidumbre de 240.