Trips & Schedules

Trips represent scheduled transit service along a route. Each trip defines the specific sequence of stops served at particular times. Trip data is imported from GTFS source feeds as part of each feed version.

Trips

Trips are trips.txt entities imported from GTFS. A trip represents a single journey along a route at a specific time. Multiple trips typically operate on the same route throughout a service day, with each trip serving the same or similar stop sequences.

Key trip attributes include:

  • Trip headsign: The destination or direction displayed to riders (e.g., "Downtown" or "Airport")
  • Direction: Binary indicator (0 or 1) for travel direction, typically outbound vs. inbound
  • Block: Groups trips operated by the same vehicle, enabling transfer time calculations
  • Shape: Geographic path the vehicle travels (see route geometries)

Stop Times & Schedules

Stop times define when a trip serves each stop along its route. This data comes from stop_times.txt in GTFS feeds.

Each stop time includes:

  • Arrival and departure times: When the vehicle arrives at and departs from each stop. If specific times are not provided for a stop, Transitland interpolates times between designated "timepoint" stops before and after.
  • Stop sequence: The order in which stops are visited
  • Pickup and drop-off types: Whether passengers can board, alight, or both at each stop
  • Timepoint: Indicates if the time is exact or approximate

Service Dates

Trip schedules operate on specific dates defined by service calendars:

  • Regular service: Defined in calendar.txt with weekly patterns and date ranges
  • Exceptions: Defined in calendar_dates.txt for holidays, special events, or service changes

Service dates vs. calendar dates: GTFS uses a "service date" concept where a service day can extend past midnight. For example, a late-night trip departing at 1:00 AM on Saturday morning is often considered part of Friday's service date. This allows transit agencies to represent their operational day, which may not align with calendar days.

Frequency-Based Service

Some routes operate on headway-based schedules rather than fixed times. This is defined in frequencies.txt, indicating that vehicles depart at regular intervals (e.g., every 10 minutes) rather than specific scheduled times.

Real-Time Updates

Transitland enriches static trip schedules with real-time data from GTFS Realtime feeds. See the Alerts concept page for information about how real-time trip updates, vehicle positions, and service alerts are made available through the API.

Querying Schedule Data via Transitland

For detailed information about querying schedule data through the Transitland APIs, see: