GTFS Realtime

Revision History

October 2024

• Clarification and small changes for Trip Modifications. See discussion.

March 2024

• Adopted Trip-Modifications. See discussion.

November 2022

• Added support for DELETED trips. See discussion.

July 2022

• Add cause_detail and effect_detail. See discussion
• Added ability to specify a wheelchair_accessible value in a TripUpdate.VehicleDescriptor. See discussion.

September 2021

• Feature/image in alerts. See discussion.

August 2021

• Add GTFS-NewShapes as experimental. See discussion.

April 2021

• Add departure_occupancy_status to TripUpdate. See discussion.

February 2021

• Clarification of GTFS Realtime occupancy descriptions. See discussion.

September 2020

• Support multi-car crowding. See discussion.

April 2020

• Support stop assignments. See discussion.

July 2020

• Support DUPLICATED trips. See discussion.
• Alert tts_header_text, tts_description_text no longer experimental. See discussion.
• Label GTFS-RT ADDED trips as not fully specified. See discussion.

April 2020

• Mark SeverityLevel as final. See discussion.
• Add occupancy_percentage. See discussion.

March 12, 2020

• Recommend providing TripUpdate predictions for the next trip in block. See discussion.

August 2019

• Document that trip_updates are not required to occur in feed in block-order. See discussion.
• Add StopTimeUpdate.ScheduleRelationship UNSCHEDULED value. See discussion.

May 2019

• Add accessibility issue alert effect. See discussion.

February 2019

• Add NO_EFFECT effect option for GTFS-realtime service alert. See discussion.
• Add new optional field SeverityLevel to Service Alerts feed. See discussion.
• Add new optional fields for Text-to-Speech functionality in Service Alerts feed. See discussion.

April 2018

• Remove requirement for stop_time_update arrival AND departure for SCHEDULED trips. See discussion.

August 2017

• Define semantic cardinality for GTFS-realtime fields. See discussion.

January 30, 2015

• Added Protocol Buffer extension namespace to all remaining GTFS-realtime messages that didn't already have one (such as FeedMessage and FeedEntity).

January 28, 2015

• Added experimental field delay to TripUpdate (discussion).

January 16, 2015

• Update description of TripDescriptor.start_time.

January 8, 2015

• Defined experimental enum OccupancyStatus.
• Added experimental field occupancy_status to VehiclePosition (discussion).

May 22, 2014

• Updated description of ScheduleRelationship enum in StopTimeUpdate message (discussion).
• Removed REPLACEMENT from ScheduleRelationship enum values in TripDescriptor message (discussion).

Oct 12, 2012

• Added timestamp field to TripUpdate message.

May 30, 2012

• Added specific details about Extensions to the specification.

November 30, 2011

• Added Protocol Buffer extension namespace to key GTFS-realtime messages to facilitate writing extensions to the spec.

October 25, 2011

• Updated documentation to clarify that alert, header_text and description_text are both plain-text values.

August 20, 2011

• Updated documentation to clarify semantics of the TimeRange message.

August 22, 2011

• Initial version.