Entidades de feed

GTFS Realtime admite tres tipos distintos de datos en tiempo real: actualizaciones de viaje, alertas de servicio y posiciones de vehículos. Google Transit recomienda que cada feed en tiempo real contenga solo un tipo de entidad. Si corresponde, también recomendamos que las empresas separen el feed de tiempo real en subtipos de entidades, según el tipo de ruta, la empresa y otros criterios.

Por ejemplo, la entidad de actualizaciones de viaje puede tener una subcategoría según el tipo de ruta. Por lo tanto, si una empresa necesita proporcionar información actualizada de viaje para todos sus servicios de transporte público, puede incluir las actualizaciones de servicio de autobús en un feed y las de servicio de metro en otro feed.

Para evitar un punto único de fallo, separa el feed de tiempo real en tipos únicos y porciones más pequeñas. Si los feeds están separados, el hecho de que una parte pudiese tener datos incorrectos no afectará todo el feed.

Para convertir un feed combinado de tiempo real en un esquema de feed por tipo, usa esta herramienta de ejemplo.

En las siguientes secciones, se documentan los tres tipos de feed de GTFS Realtime.

Actualizaciones de viaje

Ejemplo: "El autobús X tiene una demora de 5 minutos".

Las actualizaciones de viaje ofrecen información sobre los cambios en el horario. Esperamos recibir actualizaciones de viaje para todos los viajes que programes que puedan mostrarse en tiempo real. Estas actualizaciones brindan un horario de llegada o salida previsto para las paradas a lo largo de la ruta. Las actualizaciones de viaje también pueden brindar información en situaciones más complejas, por ejemplo, cuando se cancelan o agregan viajes al horario, o incluso cuando se modifica la ruta.

Para obtener más información, consulta Actualizaciones de viaje.

Alertas de servicio

Ejemplo: "La estación Y está cerrada por tareas de construcción".

Las alertas de servicio representan los problemas de índole más general que puede sufrir una entidad en particular. Suelen constar de un texto que describe el inconveniente. Para recopilar datos más estructurados que nos ayuden a comprender a quién afecta la alerta de servicio, también aceptamos URLs.

Algunos ejemplos de alertas de servicio son problemas con las estaciones, las líneas o toda la red.

Para obtener más información, consulta Alertas de servicio.

Posiciones de vehículos

Ejemplo: "Este autobús se encuentra en la posición X a la hora Y".

La posición de un vehículo ofrece datos básicos sobre un vehículo específico de la red. Los datos más importantes son la latitud y longitud de la posición del vehículo, pero también podemos usar los datos sobre las lecturas actuales del odómetro y el velocímetro del vehículo.

Para obtener más información, consulte Posiciones del vehículo.