Mobility Database API v1.2

[emmambd]

Describe the problem

1. Users need to be able to easily access data quality information about each feed and dataset. This data quality information comes from the Canonical GTFS Schedule Validator. This will reduce the time and effort required from consumers to evaluate and integrate transit data into applications and services.

2. Users need to know how they can query the new search endpoint, which has been developed to support search functionality in the Mobility Database website.

Associated user stories:

As a map app developer, I want to retrieve a quality report for a specific GTFS feed, so that I can assess its reliability before integration.

As a transit agency data producer, I need to review quality reports for our GTFS feeds, to identify and correct issues affecting data accuracy.

As a data consumer, I want to search for a mix of transit provider, location and name information so I can the information I want quicker and more precisely.

Proposed solution

Data quality flow

A user can query /gtfs_feeds and return

• A validation report exists
• The total count of unique notices grouped by severity, to see at a glance if there are problems with a feed

They can then look at an individual dataset associated with the feed and return

• Validation report fetch date
• The total count of unique notices
• The list of notice names grouped by severity
• The HTML report link
• The JSON report link

Search endpoint flow

A user can query search and return a mix of gtfs and gtfs realtime feeds, based on location, feed name, and transit provider criteria. How to search is clear to them and the operations included are included in the documentation.

Alternatives you've considered

No response

Additional context

No response