Skip to content

GTFS Data Sources

Transit feed data used by the syncc platform. The GTFS_SOURCE environment variable in apps/api-server/.env selects which city is loaded at startup.

Cochabamba
Format Standard GTFS (.txt files)
Source Trufi Association — open data, public GitHub repo
Loading Fetched live at api-server startup via HTTP
GTFS_SOURCE value cochabamba

Repository: trufi-association/trufi-gtfs-builder

Feed base URL:

https://raw.githubusercontent.com/trufi-association/trufi-gtfs-builder/main/examples/Bolivia-Cochabamba/out/gtfs

Files consumed by gtfs.service.ts:

File Content
stops.txt Stop names, lat/lng
routes.txt Route short/long names, agency
trips.txt Trip → route + shape mapping
stop_times.txt Stop sequences per trip
shapes.txt Route geometry (lat/lng sequences)
agency.txt Agency / syndicate names

The fallback stop index (cbba-stops.json, 360 KB) is bundled at apps/api-server/src/passenger/data/cbba-stops.json and used when the live fetch fails.

La Paz
Format GeoJSON (processed from raw route surveys)
Source Internal — not a public feed
Loading Read from bundled local file at api-server startup
GTFS_SOURCE value lapaz
Location in repo apps/api-server/src/passenger/data/lapaz-routes.geojson (9.2 MB)

The file lives in the monorepo alongside the application code. It doesn't change often, and keeping it bundled avoids a network dependency at startup (unlike the live Cochabamba fetch).

Future: data analysis of the La Paz feed is planned. When that work begins, this page will be updated with tooling, schema notes, and findings.

Environment variable reference

# apps/api-server/.env
GTFS_SOURCE=lapaz        # 'lapaz' | 'cochabamba'
CITY=lapaz               # controls map center in web-admin local dev

City config (map center, zoom, OSRM URL) is defined in:

apps/web-admin/src/environments/city.config.ts

Adding a new city

  1. Obtain the GTFS feed or processed GeoJSON for the city
  2. Add a loader branch in gtfs.service.ts under GTFS_SOURCE === 'newcity'
  3. Add the city entry to city.config.ts (center coords, zoom level)
  4. Set GTFS_SOURCE=newcity and CITY=newcity in the deployment .env