gtfs

GTFS - A type-safe GTFS library for Gleam

This library provides complete support for parsing and working with GTFS (General Transit Feed Specification) data, including:

GTFS Static: Schedule data (routes, stops, trips, times, etc.)
GTFS Realtime: Live updates (trip updates, vehicle positions, alerts)

Quick Start - Static Feed

import gtfs/static/feed

pub fn main() {
  // Load a GTFS feed from a directory
  let assert Ok(feed) = feed.load_from_directory("./gtfs_data")

  // Access the data
  let routes = feed.routes
  let stops = feed.stops
}

Quick Start - Realtime Feed

import gtfs/realtime/feed as rt_feed

pub fn handle_realtime(data: BitArray) {
  let assert Ok(feed) = rt_feed.decode(data)

  // Get all trip updates
  let trip_updates = rt_feed.get_trip_updates(feed)

  // Get all vehicle positions
  let vehicles = rt_feed.get_vehicle_positions(feed)

  // Get all alerts
  let alerts = rt_feed.get_alerts(feed)
}

Module Structure

Static (Schedule Data)

gtfs/static/feed - Load and query GTFS Static feeds
gtfs/static/types - All GTFS Static type definitions
gtfs/static/validation - Feed validation utilities

Realtime (Live Updates)

gtfs/realtime/feed - Decode and query GTFS Realtime feeds
gtfs/realtime/types - All GTFS Realtime type definitions
gtfs/realtime/decoder - Protocol Buffer decoder

Common

gtfs/common/types - Shared types (Date, Time, Coordinate, etc.)
gtfs/common/time - Time parsing and manipulation utilities
gtfs/common/geo - Geographic utilities (distance, polylines, etc.)

Types

Agency

</>

pub type Agency =
  types.Agency

Alert

</>

pub type Alert =
  types.Alert

Calendar

</>

pub type Calendar =
  types.Calendar

CalendarDate

</>

pub type CalendarDate =
  types.CalendarDate

Color

</>

pub type Color =
  types.Color

Coordinate

</>

pub type Coordinate =
  types.Coordinate

Date

</>

pub type Date =
  types.Date

ExceptionType

</>

pub type ExceptionType =
  types.ExceptionType

Feed

</>

pub type Feed =
  feed.Feed

FeedEntity

</>

pub type FeedEntity =
  types.FeedEntity

FeedHeader

</>

pub type FeedHeader =
  types.FeedHeader

FeedMessage

</>

pub type FeedMessage =
  types.FeedMessage

LanguageCode

</>

pub type LanguageCode =
  types.LanguageCode

LocationType

</>

pub type LocationType =
  types.LocationType

Position

</>

pub type Position =
  types.Position

Route

</>

pub type Route =
  types.Route

RouteType

</>

pub type RouteType =
  types.RouteType

ShapePoint

</>

pub type ShapePoint =
  types.ShapePoint

Stop

</>

pub type Stop =
  types.Stop

StopTime

</>

pub type StopTime =
  types.StopTime

Time

</>

pub type Time =
  types.Time

Timezone

</>

pub type Timezone =
  types.Timezone

Trip

</>

pub type Trip =
  types.Trip

TripDescriptor

</>

pub type TripDescriptor =
  types.TripDescriptor

TripUpdate

</>

pub type TripUpdate =
  types.TripUpdate

VehicleDescriptor

</>

pub type VehicleDescriptor =
  types.VehicleDescriptor

VehiclePosition

</>

pub type VehiclePosition =
  types.VehiclePosition