Transitland Atlas

An open catalog of transit/mobility data feeds and operators.

This catalog is used to power the canonical Transitland platform, is available for distributed used of the transitland-lib tooling, and is open to use as a "crosswalk" within other transportation data systems.

[!NOTE]

Transitland Atlas is now released under the CC-BY license. When using Transitland Atlas in your own projects, please include a link to this repo or to www.transit.land

Table of contents:

• Feeds
• How to Add a New Feed
• Opinionated DMFR file format
• How to Update an Existing Feed
• Operators
• Onestop IDs
• Enriching Transitland Atlas with external reference data
• License

Feeds

Public mobility/transit data feeds cataloged in the Distributed Mobility Feed Registry format.

Includes feeds in the following data specifications (specs):

• GTFS
• GTFS Realtime
• GBFS - automatically synchronized from https://github.com/MobilityData/gbfs/blob/master/systems.csv
• MDS - automatically synchronized from https://github.com/openmobilityfoundation/mobility-data-specification/blob/main/providers.csv

How to Add a New Feed

1. Check if a ./feeds file exists with the domain name for the feed URL. (ex. http://bart.gov -> bart.gov.dmfr.json)

1. Propose a new Onestop ID for the feed (see below)

1. Add the appropriate URL to static_current
2. Add license and/or authorization metadata if you are aware of it.
3. Open a PR. Feel free to add any questions as a comment on the PR if you are uncertain about your DMFR file.
4. GitHub Actions (continuous integration service) will run a basic validation check on your PR and report any errors.
5. A moderator will review and comment on your PR. If you don't get a response shortly, feel free to ping us at [email protected]

For more information on what can go into a DMFR file, see the DMFR documentation.

Opinionated DMFR file format

The Atlas repository enforces an opinionated DMFR format that extends the standard DMFR JSON schema. This format enforces:

• Consistent JSON indentation
• Consistent key ordering
• A trailing line break at the end of the file (this is a change as of March 2025)

How to Update an Existing Feed

1. Find the DMFR file containing the feed.
2. Update the URLs and other properties for that feed

1. Edit the file and open the PR as described above.

Operators

Operators describe, annotate, and group data from different feed data sources. For example, o-9q9-actransit describes a transit operator, Alameda-Contra Costa Transit District, which pulls from two different data sources (one GTFS-RT, one static GTFS) and adds additional metadata such as a US National Transit Database ID.

Operators can exist in the top-level operators property if a DMFR file, or nested within a feed. An operator defined in the top-level operators property requires an associated_feeds value to connect the operator with data sources. When an operator is nested within a feed, there is an implicit association that all GTFS agencies contained in that file are associated with that operator, which helps reduces complexity and maintenance.

The key properties for an operator are:

• onestop_id: A Onestop ID value for this operator, starting with o-
• name: A formal name for the operator, such as Bay Area Rapid Transit
• short_name: A simpler, colloqial name for an operator, such as BART
• tags: A set of key,value string pairs that provide additional metadata and references
• website: A URL to find more information about this operator
• associated_feeds: An array of feed association objects; for each entry, feed_onestop_id is required and gtfs_agency_id is optional

Onestop IDs

Every feed and operator record in the Atlas repository is identified by a unique Onestop ID. Onestop IDs are meant to be globally unique (no duplicates in the world) and to be stable (no change over time).

To simplify the process of creating Onestop IDs, we now allow two different variants:

• a three-part Onestop ID includes an entity prefix, a geohash, and a name. For example: f-9q9-bart
• a two-part Onestop ID includes just the entity prefix and a name. For example: f-banning~pass~transit

Rules for Onestop IDs in this repository:

• Feeds start with f- and operators start with o-
• Geohash part is optional
• Name can include any alphanumeric characters in UTF-8
• The only separation or punctuation character allowed in the name component is a tilde (~)

Enriching Transitland Atlas with external reference data

We welcome help from the community to expand Transitland Atlas by reviewing external reference datasets, including:

• NTD GTFS Weblinks

License

Unless otherwise indicated, data files and scripts in this repository are made available under the Creative Commons Attribution 4.0 International Public License. This license allows you to:

1. use this data for commercial, educational, or research purposes and be able to trust that it's cleanly licensed
2. duplicate data, as long as you mention (attribute) this source
3. use this data to create analyses and derived data (such as geocoding), without needing to provide attribution