Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add rider_category_id to fare_products.txt #371

Open
isabelle-dr opened this issue Mar 8, 2023 · 1 comment · May be fixed by #511
Open

Add rider_category_id to fare_products.txt #371

isabelle-dr opened this issue Mar 8, 2023 · 1 comment · May be fixed by #511
Labels
Change: Addition New function proposed to the specification. Extension: GTFS-Fares Issues and Pull Requests that focus on GTFS-Fares Extension GTFS Schedule Issues and Pull Requests that focus on GTFS Schedule Status: Discussion Issues and Pull Requests that are currently being discussed and reviewed by the community.

Comments

@isabelle-dr
Copy link
Collaborator

isabelle-dr commented Mar 8, 2023

Context

rider_categories.txt is a key component of the GTFS Fares-v2 proposal and a primary key of fare_product.txt.
Example: flat fare but free for children (STS, Sherbrooke, Canada)

fare_product_id amount currency rider_category_id
STS_flat_fare 0 CAD children
STS_flat_fare 3.3 CAD

There are still questions about the rider_category.txt table fields, but we believe the rider_category_id field in fare_products.txt is stable. It could take months before we adopt Rider Categories in GTFS, based on the priorities list we've defined with the community.

Proposition

Adopt fare_products.rider_category_id right now, and adopt rider_categories.txt in a further iteration.
rider_category_id is currently produced at least by:

  • Interline (source)
  • San Diego Metropolitan Transit System (dataset)
  • Maryland DOT (source)
  • Cal-ITP (50+ agencies)

... and consumed by Open Trip Planner (cc @leonardehrenfried to confirm).

Advantages

It might sound like it doesn't add much value to add this field alone without further information about what the rider category is, but there are still some pros:

  1. Make the fare_products.txt design more clear (see Improve definition of Fare Products #367 for more context).
  2. Increase the "usefulness" of the adopted portion of Fares v2, make producers aware that it exists and this is the way to represent it.
  3. Mitigate the risk of ending up with this type of data that would need to be updated when we adopt Rider Categories. This is not technically invalid data, but it's not how the fare_products.txt was designed and forces to have duplication that could be avoided in fare_leg_rules.txt.
fare_product_id amount currency
adult_fare 3.3 CAD
children_fare 0 CAD

Alternatives considered

Adopt Rider Categories all at once.

I'd like to have general thoughts there; if we collectively think this is useful, I can open a PR for this.

@isabelle-dr isabelle-dr added the GTFS Schedule Issues and Pull Requests that focus on GTFS Schedule label Mar 8, 2023
@emmambd emmambd added the Extension: GTFS-Fares Issues and Pull Requests that focus on GTFS-Fares Extension label May 10, 2023
Copy link

This issue has been automatically marked as stale because it has not had recent activity. It may be closed manually after one month of inactivity. Thank you for your contributions.

@github-actions github-actions bot added the stale label May 10, 2024
@eliasmbd eliasmbd added Status: Stale Issues and Pull Requests that have remained inactive for 30 calendar days or more. and removed stale labels Jun 10, 2024
@tzujenchanmbd tzujenchanmbd added Status: Discussion Issues and Pull Requests that are currently being discussed and reviewed by the community. Change: Addition New function proposed to the specification. and removed Status: Stale Issues and Pull Requests that have remained inactive for 30 calendar days or more. labels Aug 22, 2024
@tzujenchanmbd tzujenchanmbd linked a pull request Oct 16, 2024 that will close this issue
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Change: Addition New function proposed to the specification. Extension: GTFS-Fares Issues and Pull Requests that focus on GTFS-Fares Extension GTFS Schedule Issues and Pull Requests that focus on GTFS Schedule Status: Discussion Issues and Pull Requests that are currently being discussed and reviewed by the community.
Projects
None yet
Development

Successfully merging a pull request may close this issue.

5 participants
@isabelle-dr @emmambd @tzujenchanmbd @eliasmbd and others