Skip to content

Feed Entities

GTFS Realtime supports three distinct types of realtime data, that can be combined witin a single realtime feed. Summaries are given below, with full documentation given in the relevant section.

Trip Updates

"Bus X is delayed by 5 minutes"

Trip updates represent fluctuations in the timetable. We would expect to receive trip updates for all trips you have scheduled that are realtime-capable. These updates would give a predicted arrival or departure for stops along the route. Trip updates can also provide for more complex scenarios where trips are canceled, added to the schedule, or even re-routed.

More about Trip Updates...

Service Alerts

"Station Y is closed due to construction"

Service alerts represent higher level problems with a particular entity and are generally in the form of a textual description of the disruption.

They could represent problems with:

  • Stations
  • Lines
  • The whole network
  • etc.

A service alert will usually consist of some text which will describe the problem, and we also allow for URLs for more information as well as more structured information to help us understand who this service alert affects.

More about Service Alerts...

Vehicle Positions

"This bus is at position X at time Y"

Vehicle position represents a few basic pieces of information about a particular vehicle on the network.

Most important are the latitude and longitude the vehicle is at, but we can also use data on current speed and odometer readings from the vehicle.

More about Vehicle Position updates...

Trip Modifications

"These trips are affected by a detour on certain days"

Trip modifications are used to describe detours which affect a set of trips.

A trip modification can cancel certain stops, adjust the timing for trips, provide a new shape that trips will take and provide the location of temporary stops along the way.

More about Trip Modifications...

Historical remark on feed types

Early versions of GTFS Realtime Specification required each feed to only contain single type of entities. An example tool to convert from merged to the feed-per-type schema is located in the Bliksem Labs gtfsrt-examples GitHub repository.