• Fast reading and writing of GTFS feeds
• Supports extended GTFS route types
• Header-only
• C++17
• Tested on GCC and Clang
• STL-compatible containers

• Working with GTFS feeds
• How to use library
• Used third-party tools
• Contributing
• Resources

The library implements reading and writing static transit data in GTFS - General Transit Feed Specification. It provides main class gtfs::Feed for working with GTFS feeds and classes for each of 17 GTFS entities: Route, Stop, Pathway, Translation and others. GTFS csv files are mapped to the corresponding C++ classes. Every GTFS entity can be accessed through gtfs::Feed.

📌 Example of providing gtfs::Feed the feed path, reading it and working with GTFS entities such as stops and routes:

Feed feed("~/data/SFMTA/");
if (feed.read_feed() == ResultCode::OK)
{
	Stops stops = feed.get_stops();
	std::cout << stops.size() << std::endl;

	Route route = feed.get_route("route_id_1009");
	if (route)
	{
		std::cout << route->route_long_name << std::endl;
	}
}

GTFS feed can be wholly read from directory as in the example above or you can read GTFS files separately. E.g., if you need only shapes data, you can avoid parsing all other files and just work with the shapes.

📌 Example of reading only shapes.txt from the feed and working with shapes:

Feed feed("~/data/SFMTA/");
if (feed.read_shapes() == ResultCode::OK)
{
	Shapes all_shapes = feed.get_shapes();
	Shape shape = feed.get_shape("9367");
}

Methods of the Feed class for working with agencies:

Read agencies from the corresponding csv file.

Result read_agencies()

Get reference to Agencies - std::vector of Agency objects.

const Agencies & get_agencies()

Find agency by its id. This method returns std::optional so you should check if the result is std::nullopt.

std::optional<Agency> get_agency(const Id & agency_id)

Add agency to the feed.

void add_agency(const Agency & agency)

Add agency to the feed by filling agency object fields with parsed csv values. row is std::map with csv column titles as keys ans csv row items as values.

Result add_agency(ParsedCsvRow const & row)

📌 There are similar methods for all other GTFS entities for getting the list of entities, finding and adding them. For some of them additional methods are provided. For example, you can find all the stop times for current stop by its id:

StopTimes get_stop_times_for_stop(const Id & stop_id)

Or you can find stop times for the particular trip:

StopTimes get_stop_times_for_trip(const Id & trip_id, bool sort_by_sequence = true)

• For including the library in your own project: just_gtfs is completely contained inside a single header and therefore it is sufficient to copy include/just_gtfs/just_gtfs.h to your include pathes. The library does not have to be explicitly build.
• For running library tests: Clone just_gtfs with git clone --recursive or run git submodule update --init --recursive --remote after cloning. In the just_gtfs project directory build the project and run unit tests:

cmake .
make
ctest --output-on-failure --verbose

The library makes use of the C++17 features and therefore you have to use appropriate compiler version.

• For including as a submodule: use branch "for-usage-as-submodule" which consists of a single header.

• doctest for unit testing.

Please open a Github issue with as much of the information as you're able to specify, or create a pull request according to our guidelines.

GTFS reference in Google GitHub repository

GTFS reference on Google Transit API