https://github.com/mobilitydata/gtfs_diff
Specification of the GTFS Diff
https://github.com/mobilitydata/gtfs_diff
Last synced: 9 months ago
JSON representation
Specification of the GTFS Diff
- Host: GitHub
- URL: https://github.com/mobilitydata/gtfs_diff
- Owner: MobilityData
- License: apache-2.0
- Created: 2023-05-02T13:24:00.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-06-20T21:41:43.000Z (over 2 years ago)
- Last Synced: 2024-05-01T21:57:22.648Z (almost 2 years ago)
- Size: 116 KB
- Stars: 6
- Watchers: 11
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Authors: AUTHORS.md
Awesome Lists containing this project
README
# GTFS Diff : A specification to list differences between GTFS files
## Goal
GTFS Diff aims at providing a universal and unified way to list differences between two GTFS files. It is designed to be easily understandable by humans, but also easily produced and processed by computers.
## Context
[transport.data.gouv.fr](transport.data.gouv.fr) is the French National Access Point for mobility data. It is operated by the French Ministry of Transportation. The platform gives access to a variety of mobility data, including a number of GTFS files.
It happens frequently that companies or individuals using this data modify it. For example to correct spelling mistakes in a stop name, add color to routes or wheelchair information.
Every time a GTFS file is updated by the producer with a recent schedule, those corrections need to be applied again. We lack a universal way to list a series of modifications with the corresponding explanations about the change.
It also happens that data users share their enhanced GTFS file on our platform. We then lack a way to easily understand the changes they made. If two users share their own modified version of a GTFS, we lack a way to merge their respective changes into a single file.
It is also hard for reusers to review the changes made to a given GTFS file by its official producer, making it harder to understand the impact of the changes on their systems.
## Resources
- the [GTFS Diff specification](specification.md)
- [Online tool](https://transport.data.gouv.fr/tools/gtfs_diff) to generate a GTFS Diff on transport.data.gouv.fr
- [Source code](https://github.com/etalab/transport-site/blob/b6bdd7749192e52bccb9ecbb33e436b56c9fd693/apps/transport/lib/transport/gtfs_diff.ex) of the implementation (in Elixir)
## Acknowledgements
This project was initially created by the [French National Access Point](https://transport.data.gouv.fr/) to ease communication between data producers and reusers and to monitor changes made by data producers over time in their GTFS feeds.
In June 2023, MobilityData and the French NAP announced a partnership to maintain and further improve the GTFS Diff specification.