Skip to content
This repository has been archived by the owner on Aug 27, 2024. It is now read-only.

Commit

Permalink
Add fare requirements (#4)
Browse files Browse the repository at this point in the history
This changes add requirements for all fares features
  • Loading branch information
Sergiodero authored May 7, 2024
1 parent 2cc785e commit 1d78461
Showing 1 changed file with 32 additions and 0 deletions.
32 changes: 32 additions & 0 deletions docs/getting_started/features/fares.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ GTFS allows to preciely model a wide variety of fare structures used by differen

Fare Products lists the types of tickets or fares (i.e. single-trip fare, monthly pass, transfer fees, etc.) offered by a transit agency to access a service. Fare Products serve as a foundation for modeling an agency's fare structure, and they are linked to the transit service through mechanisms outlined in `fare_leg_rules.txt`. The association of Fare Products to various travel conditions, such as routes, areas, and times, determines the fare costs for individual travel segments and transfers.

**Pre-requirement**:

- [Base features](/getting_started/features/base)

| Files included | Fields included |
|----------------------------------|-------------------|
|[fare_products.txt](/schedule/reference/#fare_productstxt)|`fare_product_id`, `fare_product_name`, `amount`, `currency`, `fare_media_id` |
Expand Down Expand Up @@ -37,6 +41,10 @@ Fare Products lists the types of tickets or fares (i.e. single-trip fare, monthl

Fare Media defines the supported media that can be used to hold and/or validate a fare product. This refers to physical or virtual containers such as a paper ticket, a rechargeable transit card or even contactless payment with credit cards or smartphones.

**Pre-requirement**:

- [Base features](/getting_started/features/base)

| Files included | Fields included |
|----------------------------------|-------------------|
|[fare_media.txt](/schedule/reference/#fare_mediatxt)|`fare_media_id`, `fare_media_name`, `fare_media_type`|
Expand Down Expand Up @@ -73,6 +81,11 @@ Fare Media defines the supported media that can be used to hold and/or validate

Route-Based Fares is used to assign different fares for specific groups of routes, such as special fares for express services or differentiating fares between a Bus Rapid Transit service versus traditional bus services.

**Pre-requirements**:

- [Base features](/getting_started/features/base)
- [Fare Products feature](/getting_started/eatures/fares/#fare-products)

| Files included | Fields included |
|----------------------------------|-------------------|
|[routes.txt](/schedule/reference/#routestxt)|`network_id`|
Expand Down Expand Up @@ -147,6 +160,11 @@ Route-Based Fares is used to assign different fares for specific groups of route

Time-based Fares is used to assign fares for specific time-of-day or day-of-week, such as peak and off-peak fares and/or weekend fares.

**Pre-requirements**:

- [Base features](/getting_started/features/base)
- [Fare Products feature](/getting_started/eatures/fares/#fare-products)

| Files included | Fields included |
|----------------------------------|-------------------|
|[fare_leg_rules.txt](/schedule/reference/#fare_leg_rulestxt)|`fare_product_id`, `from_timeframe_group_id`, `to_timeframe_group_id`|
Expand Down Expand Up @@ -182,6 +200,11 @@ Time-based Fares is used to assign fares for specific time-of-day or day-of-week

Zone-Based Fares is used to represent zone-based systems where a specific fare applies when traveling from one particular zone to another. A zone is defined by a group of stops.

**Pre-requirements**:

- [Base features](/getting_started/features/base)
- [Fare Products feature](/getting_started/eatures/fares/#fare-products)

| Files included | Fields included |
|----------------------------------|-------------------|
|[fare_leg_rules.txt](/schedule/reference/#fare_leg_rulestxt)|`fare_product_id`, `from_area_id`, `to_area_id`|
Expand Down Expand Up @@ -225,6 +248,11 @@ Zone-Based Fares is used to represent zone-based systems where a specific fare a

## Fares Transfers

**Pre-requirements**:

- [Base features](/getting_started/features/base)
- [Fare Products feature](/getting_started/eatures/fares/#fare-products)

Fares Transfers is used to define rules applicable when transferring between legs (or individual travel segments). This allows to model the total cost of a multi-leg travel journey, accounting for special transfer policies, such as free transfers for a specific time limit, or applying fare discounts based on legs already traveled.

| Files included | Fields included |
Expand Down Expand Up @@ -260,6 +288,10 @@ Fares Transfers is used to define rules applicable when transferring between leg

Fares v1 is a legacy alternative to other Fares features described above. It allows to model basic fare information such as fare pricing, payment methods transfers and zone-based fares using the `fare_rules.txt` and `fare_attributes.txt` files. While simpler to produce, it's less capable or modeling more complex fare structures and may be deprecated with sufficient endorsement of other Fare features (that are part of what is called Fares v2).

**Pre-requirement**:

- [Base features](/getting_started/features/base)

| Files included | Fields included |
|----------------------------------|-------------------|
|[stops.txt](/schedule/reference/#stopstxt)|`zone_id`|
Expand Down

0 comments on commit 1d78461

Please sign in to comment.