GTFS Realtime

GTFS Realtime (also known as GTFS-rt) is an extension to GTFS, in which public transport agencies share real-time vehicle locations, arrival time predictions, and alerts such as detours and cancellations via Protocol Buffers web server.[1]

GTFS Realtime
Example of GTFS Realtime Visualisation of LA Metro
Filename extension
.pb
Initial release27 September 2011 (2011-09-27)
Latest release
2.0
22 February 2023 (2023-02-22)
Type of formatTransit realtime data format
Extended fromProtocol Buffers
StandardDe facto standard
Open format?Yes, CC BY 3.0
Websitegtfs.org/realtime/

History

On 22 August 2011, a first version of GTFS-rt was released.[2]

In July 2012, Google Maps began showing alerts from GTFS-rt.[3]

On August 30, 2021, an experimental feed, Shapes, was released. Shapes has the ability to update route shapes in real time to reflect detour, as route updates are either reflected by referencing an existing shape_id or by defining in real time a new shape as an encoded polyline.

Standard

The GTFS Realtime specification is defined by a .proto file hosted by Google.[4] Data is serialized into raw bytes by the server and then deserialized by a client. Officially supported GTFS-rt binding libraries have been built in .NET, Java, Javascript, Python, and Go. Unofficial libraries have been written in other languages, such as Rust.

There are currently three official feed type defined in the standard, TripUpdates, VehiclePositions, and Alerts. Shapes is the fourth feed type and is currently experimental.

Agencies supporting GTFS-Realtime typically provide separate urls for the three separate feed types, and may choose to only provide some of the feeds. Unlike GTFS Static, some agencies may require developers to request an API key via email or a web form.

Developers then write programs to periodically fetch an agency's web API over HTTP, typically every few seconds to minutes. There is no standard for streaming GTFS Realtime data.

Trip updates

In the GTFS Specification, a trip refers to an operator driving a fixed-route vehicle from the start of the route to the end. A new trip is started for when the vehicle turns around at the end of its route.

The Trip Update feed allows maps to show the departure or arrival times of vehicles, and allows routing algorithms to update their directions.[5]

This feed contains an array of Trip Updates. Each trip update enumerates a description of a trip (trip id, route id, start and stop time, direction), last updated time, may include an associated vehicle number and route number, and contains an array of StopTimeUpdate. The StopTimeUpdate can define past, current, and future stop times, delays, and cancellations. The stop id references the static feed the agency provides.

Vehicle positions

Vehicle Positions are sometimes shown on mapping applications to aid users in tracking the location of buses.[6] This feed contains an array of VehiclePositions. Like Trip Updates, each VehiclePosition can also contain a basic description of the trip, such as its trip id, start and stop times, route number, and relationship to the schedule. The VehiclePosition also contains the current latitude and longitude of the vehicle, and can also include bearing, odometer, and speed. Finally, it can also contain information on how crowded the bus is, known as occupancy status, and status of road congestion experienced by the vehicle.

Alerts
MTA Subway GTFS-rt Alerts being posted on Transit App

Alerts can be shown to mapping application users to alert them of detours, cancellations, or other service changes.[7] This feed contains an array of Alerts. Alerts typically don't update as often as Vehicle Positions or Trip Updates. Each Alert stores the cause (such as labour strike or a mechanical fault) of an incident, along with its effect (reduced service, detour, stop cancellation, etc.). Alerts also contain detailed headers, descriptions, urls, images, and a list of routes or stops affected (known as the Informed Entity). Alerts also contain beginning and expiration times, known as Active Periods.

References
  1. "Reference - General Transit Feed Specification". gtfs.org. Retrieved 2023-07-31.
  2. "Revision history | Realtime Transit". Google for Developers. Retrieved 2023-07-31.
  3. Jul 31, John Del SignorePublished; Jul 31, 2012Modified; 2012Share (2012-07-31). "Google Maps Now Features Alerts On Subway Service Changes". Gothamist. Retrieved 2023-08-07.
  4. "transit/gtfs-realtime/proto/gtfs-realtime.proto at master ยท google/transit". GitHub.
  5. "Provide realtime trip information with TripUpdates - Transit Partners Help". support.google.com. Retrieved 2023-08-07.
  6. "Vehicle Positions | Realtime Transit". Google for Developers. Retrieved 2023-08-07.
  7. "Service Alerts | Realtime Transit". Google for Developers. Retrieved 2023-08-07.
This article is issued from Wikipedia. The text is licensed under Creative Commons - Attribution - Sharealike. Additional terms may apply for the media files.