Tool to create public transit frequency visualizations using Transitland.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

WARNING: This branch depends on changes to the Transitland Ruby client gem that have not yet been pushed to A Gemfile will be provided once the library changes have been published. For now, the client can be cloned and installed locally.

New York City Transit Frequency Visualization

This script and library uses the Transitland Datastore to create a transit frequency visualization for the five boroughs of New York City. The results are visible in index.html using Mapbox.

Run Instructions

No gems are required, so simply run ruby run.rb.


Two GeoJSON files are produced for each run, one for subway routes and one for bus (and a few ferry) routes for the date, time, and location specified in run.rb. The output follows the Mapbox simplestyle-spec for ease of display.

The four GeoJSON files that are called by new_york.html are in the output directory. GitHub uses Mapbox, so the intended styling can be seen when previewing these files in GitHub.


The TransitlandAPIReader uses a local caching mechanism to store the JSON results of queries to the Transitland Datastore. A JSON file is created on your local system for each API 'endpoint' and is reused when queried on future runs, given that endpoint's requested options are the same.

Potential Improvements

  • The TransitlandAPIReader class could be generalized into a gem with a decent test suite, similar to one Transitland used to maintain.
  • The run.rb script could take a job spec input to produce GeoJSON files for multiple days and cities in a single run.
  • The Mapbox front-end could be used to visualize any arbitrary transit system’s GTFS shape data. This would likely be done using a live Ruby on Rails back-end, rather than the offline Ruby script I am currently using.


Please contact Tyler at or file a GitHub Issue with any ideas or suggestions.