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

Addition of event_based_trips.txt to specification #527

Draft
wants to merge 1 commit into
base: master
Choose a base branch
from
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions gtfs/spec/en/reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@ This document defines the format and structure of the files that comprise a GTFS
- [route_networks.txt](#route_networkstxt)
- [shapes.txt](#shapestxt)
- [frequencies.txt](#frequenciestxt)
- [event_based_trips.txt](#event_based_tripstxt)
- [transfers.txt](#transferstxt)
- [pathways.txt](#pathwaystxt)
- [levels.txt](#levelstxt)
Expand Down Expand Up @@ -634,6 +635,24 @@ Primary key (`trip_id`, `start_time`)
| `headway_secs` | Positive integer | **Required** | Time, in seconds, between departures from the same stop (headway) for the trip, during the time interval specified by `start_time` and `end_time`. Multiple headways may be defined for the same trip, but must not overlap. New headways may start at the exact time the previous headway ends. |
| `exact_times` | Enum | Optional | Indicates the type of service for a trip. See the file description for more information. Valid options are:<br><br>`0` or empty - Frequency-based trips.<br>`1` - Schedule-based trips with the exact same headway throughout the day. In this case the `end_time` value must be greater than the last desired trip `start_time` but less than the last desired trip start_time + `headway_secs`. |


### event_based_trips.txt

File: **Optional**

Primary Key: `trip_id`

[Event_based_trips.txt](#event_based_tripstxt) identifies trips whose times are coupled to an event's happening (e.g. the conclusion of a concert or sporting event), and are thus variable in nature.

| Field Name | Type | Presence | Description |
| ------ | ------ | ------ | ------ |
| `trip_id` | Foreign ID referencing `trips.trip_id` | **Required** | Identifies a trip to be governed by an event's end time. |
| `event_end_approximate` | Time | **Required** | Expected time at which the event will end, upon which the special event trips would be based. |
| `event_end_earliest` | Time | Optional | Earliest event end time for which this trip could run. |
| `event_end_latest` | Time | Optional | Latest event end time for which this trip could run. |
| `event_fares` | Enum | Optional | Specifies the fare policy in place for the specified trip.<br>`0` or empty - uses default fare rules<br>`1` - uses special fare policy |


### transfers.txt

File: **Optional**
Expand Down