Google Transit y GTFS Realtime: referencia y diferencias

En esta página, se describen las principales diferencias entre la implementación de GTFS Realtime y la de Google Transit de dichas especificaciones en las siguientes áreas:

Especificaciones oficiales omitidas: Estos campos forman parte de las GTFS oficiales. Google Transit transfiere estos datos sin errores, pero no los utiliza de manera proactiva.
Interpretación diferente: Estos campos incluyen las partes de las GTFS oficiales que Google Transit interpreta de manera diferente de su definición proporcionada en las GTFS.
Compatibilidad experimental: Estos campos son experimentales en la implementación de Google Transit. Si deseas implementar un nuevo campo experimental, comunícate con el equipo de Google Transit.
Extensión compatible con Google Transit: Esta extensión no forma parte de las GTFS oficiales. Entre las extensiones compatibles con Google Transit, se incluyen aquellas tanto públicas como específicas de dicha herramienta. Cualquier socio puede enviar esta información a Google Transit en su feed.

Transporte público de Realtime

En las siguientes secciones, se documentan las principales diferencias entre las GTFS oficiales y la implementación del feed de transporte público de Realtime de Google Transit.

Especificaciones oficiales omitidas en feeds de Realtime

Algunas especificaciones omitidas son experimentales. Para obtener más información, ve a gtfs.org.

En la tabla 1, se mencionan todos los campos definidos en las GTFS que Google Transit omite en los feeds de Realtime.

**Tabla 1.** Campos oficiales omitidos en los feeds de Realtime
Mensaje	Campo definido en las GTFS que se omite	Tipo de campo
Mensaje `Alert`	`image`	TranslatedImage
Mensaje `Alert`	`image_alternative_text`	TranslatedString
Mensaje `Alert`	`severity_level`	Enum
Mensaje `Alert`	`tts_description_text`	Protocolo
Mensaje `Alert`	`tts_header_text`	Protocolo
Mensaje `CarriageDetails`	`id`	Cadena
Mensaje `CarriageDetails`	`occupancy_percentage`	int32
Mensaje `Position`	`bearing`	Número de punto flotante
Mensaje `Position`	`odometer`	Doble
Mensaje `Position`	`speed`	Número de punto flotante
Mensaje `Shape`	`encoded_polyline`	Cadena
Mensaje `Shape`	`shape_id`	Cadena
Mensaje `StopTimeUpdate` (en `TripUpdate`)	`arrival.uncertainty`	int32
Mensaje `StopTimeUpdate` (en `TripUpdate`)	`stop_time_properties`	Protocolo
Mensaje `TripUpdate`	`trip_properties`	Protocolo
Mensaje `TripUpdate`	`vehicle`	VehicleDescriptor
Mensaje `VehicleDescriptor`	`license_plate`	Cadena
Mensaje `VehicleDescriptor`	`wheelchair_accessible`	WheelchairAccessible
Mensaje `VehiclePosition`	`congestion_level`	Enum
Mensaje `VehiclePosition`	`current_status`	VehicleStopStatus
Mensaje `VehiclePosition`	`current_stop_sequence`	uint32
Mensaje `VehiclePosition`	`multi_carriage_details.id`	Cadena
Mensaje `VehiclePosition`	`occupancy_percentage`	uint32
Mensaje `VehiclePosition`	`stop_id`	Cadena

Interpretación diferente en feeds de Realtime

Aunque Google Transit acepta determinados campos de las GTFS, los interpreta de manera diferente.

En la tabla 2, se mencionan los campos definidos en las GTFS que se utilizan en los feeds de Realtime y que Google Transit considera opcionales o condicionalmente obligatorios. Para los campos opcionales, la tabla muestra si Google Transit admite o no los valores enum.

**Tabla 2.** Campos de feeds de Realtime que se interpretan de forma diferente
Nombre del archivo	Campo definido en las GTFS	Tipo de campo	¿Es obligatorio para Google Transit?	Detalles de la implementación de Google Transit
Mensaje `StopTimeUpdate` (en `TripUpdate`)	`stop_id`	Cadena	Condicionalmente obligatorio	Cuando se proporciona una cadena de `stop_id`, esta debe cumplir una de las siguientes condiciones: La cadena de `stop_id` debe ser la misma que la del archivo `stops.txt` del feed GTFS correspondiente. Si se utiliza una cadena de `stop_id` diferente, la cadena de `stop_id` proporcionada debe ser del mismo nivel o de un nivel más bajo que el de la cadena de `stop_id` original proporcionada en las GTFS estáticas. También se debe proporcionar el campo `stop_sequence` correspondiente.
Mensaje `StopTimeUpdate`	`schedule_relationship`	Enum	Opcional	Google Transit admite los siguientes valores enum: `SCHEDULED` `SKIPPED` `NO_DATA`
Mensaje `TripDescriptor`	`schedule_relationship`	Enum	Opcional	Google Transit no admite los siguientes valores enum: `DUPLICATED` `CANCELED`, cuando no sea para registros de `TripUpdate` Google admite los siguientes valores enum: `SCHEDULED` `UNSCHEDULED` `ADDED` `CANCELED`, siempre que sea para registros de `TripUpdate`

Compatibilidad experimental en feeds de Realtime

Si necesitas asistencia para integrar nuevos campos experimentales, comunícate con Google Transit.

Extensiones compatibles con Google Transit en feeds de Realtime

En el momento de la publicación de este artículo, ninguno de los campos corresponde a esta categoría. Si necesitas ayuda, comunícate con Google Transit.