GTFS Schedule describe la oferta de transporte planificada. GTFS Realtime, a menudo llamado GTFS-RT, transmite información actualizada sobre el servicio. GBFS describe los servicios de movilidad compartida, en particular sus estaciones y los vehículos disponibles según los flujos publicados. Elija el formato según la pregunta que deba resolver su aplicación.
Estos formatos organizan los datos; no garantizan ni su disponibilidad en todas partes ni la calidad de cada flujo.
GTFS para representar la oferta planificada
Un conjunto GTFS Schedule reúne archivos tabulares que describen, entre otros, los operadores, las paradas, las líneas, los viajes y sus pasadas. Los calendarios indican los días afectados. Los archivos se enlazan mediante identificadores.Referencia GTFS Schedule.
Permite responder a preguntas como «¿dónde está esta parada?» o «¿qué paso está previsto para este servicio?». Para explotar un horario, debe interpretar el calendario y las relaciones entre los archivos.
Leer solo una lista de paradas no basta para reconstruir las pasadas. Inversamente, la posición de una parada puede ser útil sin mostrar horarios.
GTFS-RT para actualizar la información del servicio
GTFS Realtime puede proporcionar actualizaciones de viajes, posiciones de vehículos y alertas. Las actualizaciones de viajes afectan, entre otras cosas, a las pasadas y a los cambios de servicio. Los flujos usan Protocol Buffers, un formato de serialización estructurado.Introducción GTFS Realtime.
Un productor puede publicar algunas categorías sin facilitar todas las demás. La presencia de un flujo de posiciones no garantiza estimaciones para todas las paradas.
Para la interfaz, distinga la pasada planificada de la estimación actualizada. Nuestra guía horarios teóricos y tiempo real explica esta diferencia desde el punto de vista del usuario.
GBFS para la movilidad compartida
GBFS utiliza flujos JSON para describir un servicio de movilidad compartida. Según el sistema y la versión, pueden informar sobre las estaciones, su estado, los vehículos y otras características del servicio. La documentación distingue, en particular, la información de estación y los estados de disponibilidad.Documentación GBFS.
Separe en su aplicación las ubicaciones relativamente estables de los estados que evolucionan rápidamente. Conserve la versión del formato y la marca de tiempo pertinente al interpretar.
Un flujo de disponibilidad no es una API de reserva o desbloqueo. Ayuda a descubrir la oferta; la operación de alquiler corresponde al servicio en cuestión.
Comparar según el caso de uso
| Necesidad | Formato a examinar |
|---|---|
| Describir las paradas y las líneas planificadas | GTFS Schedule |
| Interpretar las pasadas previstas y los días de servicio | GTFS Schedule |
| Actualizar las pasadas o recibir información de servicio | GTFS-RT, según los flujos publicados |
| Localizar estaciones o vehículos de movilidad compartida | GBFS, según los datos publicados |
Ejemplo de diseño: un mapa muestra paradas de tranvía y estaciones de bicicletas. Usa datos estructurales para los lugares y estados actualizados para la disponibilidad de bicicletas. Las dos capas tienen diferentes necesidades de caché y actualización.
Prever los límites de cada fuente
Verifique las versiones, los campos opcionales, la cobertura y los derechos de uso. Un identificador solo tiene sentido en su contexto: dos productores pueden usar cadenas idénticas para entidades diferentes.
Prevea también los datos faltantes o caducados. Una lista vacía procedente de un flujo indisponible no debe presentarse como ausencia de servicio. Evite reemplazar silenciosamente una información desconocida por cero.
Usar los flujos directamente o una API
Una integración directa le deja la responsabilidad de recoger, validar e interpretar las fuentes. Una API puede ofrecer un contrato común, pero debe leer igualmente su cobertura, sus advertencias y sus condiciones.
Para un primer caso de uso ROOTE, consulte cómo buscar paradas cercanas con una API. Comience por la necesidad de su interfaz y luego verifique los campos realmente disponibles.
Leer extractos y elegir una arquitectura
En GTFS Schedule, un extracto de stop_times.txt vincula un viaje, una parada y un paso planificado. El ejemplo reducido a continuación es pedagógico: no constituye un conjunto completo GTFS y sus identificadores deben estar relacionados con trips.txt, stops.txt y los calendarios.
Para GTFS Realtime, busca la entidad útil: un TripUpdate puede actualizar un paso, una VehiclePosition describe una ubicación y una Alert transmite información de servicio. La posición de un vehículo no es automáticamente una estimación de llegada. El formato transmitido es Protocol Buffers; una representación JSON para diagnóstico no es el flujo binario de referencia.
En GBFS, station_information describe las estaciones mientras que station_status describe sus estados publicados. Los nombres de algunos contadores y los archivos disponibles cambian según la versión. El extracto JSON siguiente ilustra GBFS 2.3 y sus campos num_bikes_available y num_docks_available; verifica la versión antes de usar un ejemplo.
Un mapa de lugares puede comenzar con los datos estructurales. Una pantalla de próximos pasos requiere luego las actualizaciones correspondientes y un respaldo explícitamente planificado. Una pantalla de bicicletas disponibles debe gestionar contadores, condiciones de alquiler y una validez temporal. Estas tres pantallas no comparten automáticamente la misma política de caché.
# Extrait pédagogique de stop_times.txt
trip_id,arrival_time,departure_time,stop_id,stop_sequence
trip_demo,08:10:00,08:10:00,stop_demo,1
# Extrait pédagogique de station_status en GBFS 2.3
{
"station_id": "station_demo",
"num_bikes_available": 3,
"num_docks_available": 7,
"is_installed": true,
"is_renting": true,
"is_returning": true,
"last_reported": 1720000000
}Formatear la disponibilidad de bicicletas y su frescura
Elegir una API o un MCP para tu producto
Preguntas frecuentes
¿GTFS contiene automáticamente datos en tiempo real?
No. GTFS Schedule representa la oferta planificada; la información actualizada corresponde a otros flujos, entre ellos GTFS-RT.
¿GBFS permite desbloquear una bicicleta?
Describe el servicio y sus datos públicos. El alquiler se realiza mediante las capacidades que ofrezca el operador.
¿Un formato estándar garantiza una cobertura completa?
No. El formato define una estructura; la cobertura y la información publicada dependen de las fuentes.