gtfs.yml

---
- id: feedinfo
  name: feed_info.txt
  helpContent: The file contains information about the feed itself, rather than the services that the feed describes. GTFS currently has an agency.txt file to provide information about the agencies that operate the services described by the feed. However, the publisher of the feed is sometimes a different entity than any of the agencies (in the case of regional aggregators). In addition, there are some fields that are really feed-wide settings, rather than agency-wide.
  fields:
  - name: "feed_id"
    required: false
    inputType: TEXT
    columnWidth: 12
    helpContent: "The feed_id field contains the feed_id which should uniquely identify the GTFS feed within trip planning applications and ideally be universally unique among public transit operators."
  - name: "feed_publisher_name"
    required: true
    inputType: TEXT
    columnWidth: 12
    helpContent: "The feed_publisher_name field contains the full name of the organization that publishes the feed. (This may be the same as one of the agency_name values in agency.txt.) GTFS-consuming applications can display this name when giving attribution for a particular feed's data."
  - name: "feed_publisher_url"
    required: true
    inputType: URL
    columnWidth: 12
    helpContent: "The feed_publisher_url field contains the URL of the feed publishing organization's website. (This may be the same as one of the agency_url values in agency.txt.) The value must be a fully qualified URL that includes http:// or https://, and any special characters in the URL must be correctly escaped. See http://www.w3.org/Addressing/URL/4_URI_Recommentations.html for a description of how to create fully qualified URL values."
  - name: "feed_lang"
    required: true
    inputType: LANGUAGE
    columnWidth: 12
    helpContent: "The feed_lang field contains a IETF BCP 47 language code specifying the default language used for the text in this feed. This setting helps GTFS consumers choose capitalization rules and other language-specific settings for the feed. For an introduction to IETF BCP 47, please refer to http://www.rfc-editor.org/rfc/bcp/bcp47.txt and http://www.w3.org/International/articles/language-tags/."
  - name: "default_lang"
    required: false
    inputType: LANGUAGE
    columnWidth: 12
    helpContent: "Defines the language used when the data consumer doesn’t know the language of the rider. It's often defined as en, English."
  - name: "feed_start_date"
    required: false
    inputType: DATE
    columnWidth: 12
    helpContent: "The feed provides complete and reliable schedule information for service in the period from the beginning of the feed_start_date day to the end of the feed_end_date day. Both days are given as dates in YYYYMMDD format as for calendar.txt, or left empty if unavailable. The feed_end_date date must not precede the feed_start_date date if both are given. Feed providers are encouraged to give schedule data outside this period to advise of likely future service, but feed consumers should treat it mindful of its non-authoritative status. If feed_start_date or feed_end_date extend beyond the active calendar dates defined in calendar.txt and calendar_dates.txt, the feed is making an explicit assertion that there is no service for dates within the feed_start_date or feed_end_date range but not included in the active calendar dates."
  - name: "feed_end_date"
    required: false
    inputType: DATE
    columnWidth: 12
    helpContent: "The feed provides complete and reliable schedule information for service in the period from the beginning of the feed_start_date day to the end of the feed_end_date day. Both days are given as dates in YYYYMMDD format as for calendar.txt, or left empty if unavailable. The feed_end_date date must not precede the feed_start_date date if both are given. Feed providers are encouraged to give schedule data outside this period to advise of likely future service, but feed consumers should treat it mindful of its non-authoritative status. If feed_start_date or feed_end_date extend beyond the active calendar dates defined in calendar.txt and calendar_dates.txt, the feed is making an explicit assertion that there is no service for dates within the feed_start_date or feed_end_date range but not included in the active calendar dates."
  - name: default_route_color
    displayName: Default color
    datatools: true
    required: false
    inputType: COLOR
    columnWidth: 6
  - name: default_route_type
    displayName: Default route type
    datatools: true
    columnWidth: 6
    required: false
    inputType: DROPDOWN
    options:
    - value: 3
      text: Bus
    - value: 0
      text: Tram
    - value: 1
      text: Subway
    - value: 2
      text: Rail
    - value: 4
      text: Ferry
    - value: 5
      text: Cable car
    - value: 6
      text: Gondola
    - value: 7
      text: Funicular
  - name: "feed_version"
    required: false
    inputType: TEXT
    columnWidth: 12
    helpContent: "The feed publisher can specify a string here that indicates the current version of their GTFS feed. GTFS-consuming applications can display this value to help feed publishers determine whether the latest version of their feed has been incorporated."
  - name: "feed_contact_email"
    required: false
    inputType: EMAIL
    columnWidth: 12
    helpContent: "Email address for communication regarding the GTFS dataset and data publishing practices."
  - name: "feed_contact_url"
    required: false
    inputType: URL
    columnWidth: 12
    helpContent: "URL for contact information, a web-form, support desk, or other tools for communication regarding the GTFS dataset and data publishing practices."

- id: agency
  name: agency.txt
  helpContent: One or more transit agencies that provide the data in this feed.
  fields:
  - name: "agency_id"
    required: false
    inputType: GTFS_ID
    columnWidth: 12
    helpContent: "The agency_id field is an ID that uniquely identifies a transit agency. A transit feed may represent data from more than one agency. The agency_id is dataset unique. This field is optional for transit feeds that only contain data for a single agency."
  - name: "agency_name"
    required: true
    inputType: TEXT
    columnWidth: 12
    helpContent: "The agency_name field contains the full name of the transit agency. Google Maps will display this name."
  - name: "agency_url"
    required: true
    inputType: URL
    placeholder: https://agency.org
    columnWidth: 12
    helpContent: "The agency_url field contains the URL of the transit agency. The value must be a fully qualified URL that includes http:// or https://, and any special characters in the URL must be correctly escaped."
  - name: "agency_timezone"
    required: true
    inputType: TIMEZONE
    columnWidth: 12
    helpContent: "The agency_timezone field contains the timezone where the transit agency is located. Timezone names never contain the space character but may contain an underscore. If multiple agencies are specified in the feed, each must have the same agency_timezone."
  - name: "agency_lang"
    required: false
    inputType: LANGUAGE
    columnWidth: 12
    helpContent: "The agency_lang field contains a two-letter ISO 639-1 code for the primary language used by this transit agency. The language code is case-insensitive (both en and EN are accepted). This setting defines capitalization rules and other language-specific settings for all text contained in this transit agency's feed. Please refer to http://www.loc.gov/standards/iso639-2/php/code_list.php for a list of valid values."
  - name: "agency_phone"
    required: false
    inputType: TEXT
    columnWidth: 12
    helpContent: "The agency_phone field contains a single voice telephone number for the specified agency. This field is a string value that presents the telephone number as typical for the agency's service area. It can and should contain punctuation marks to group the digits of the number. Dialable text (for example, TriMet's \"503-238-RIDE\") is permitted, but the field must not contain any other descriptive text."
  - name: "agency_fare_url"
    required: false
    inputType: URL
    placeholder: https://agency.org/fares
    columnWidth: 12
    helpContent: "The agency_fare_url specifies the URL of a web page that allows a rider to purchase tickets or other fare instruments for that agency online. The value must be a fully qualified URL that includes http:// or https://, and any special characters in the URL must be correctly escaped. Seehttp://www.w3.org/Addressing/URL/4_URI_Recommentations.html for a description of how to create fully qualified URL values."
  - name: "agency_email"
    required: false
    inputType: EMAIL
    placeholder: contact@agency.org
    columnWidth: 12
    helpContent: "The agency_email field contains a single valid email address actively monitored by the agency’s customer service department. This email address will be considered a direct contact point where transit riders can reach a customer service representative at the agency."
  - name: agency_branding_url
    required: false
    displayName: Agency branding URL
    datatools: false
    placeholder: https://agency.org/assets/agency/XYZ
    inputType: URL
    columnWidth: 12
    helpContent:

- id: stop
  name: stops.txt
  helpContent: Individual locations where vehicles pick up or drop off passengers.
  fields:
  - name: "stop_id"
    required: true
    inputType: GTFS_ID
    columnWidth: 6
    helpContent: "The stop_id field contains an ID that uniquely identifies a stop or station. Multiple routes may use the same stop. The stop_id is dataset unique."
  - name: "stop_code"
    required: false
    inputType: TEXT
    columnWidth: 6
    helpContent: "The stop_code field contains short text or a number that identifies the stop for passengers. Stop codes are often used in phone-based transit information systems or printed on stop signage to make it easier for riders to get a stop schedule or real-time arrival information for a particular stop."
  - name: "stop_name"
    required: false
    inputType: TEXT
    bulkEditEnabled: true
    columnWidth: 12
    helpContent: "The stop_name field contains the name of a stop or station. Please use a name that people will understand in the local and tourist vernacular."
  - name: "stop_desc"
    required: false
    inputType: TEXT
    bulkEditEnabled: true
    columnWidth: 12
    helpContent: "The stop_desc field contains a description of a stop. Please provide useful, quality information. Do not simply duplicate the name of the stop."
  - name: "stop_lat"
    required: false
    inputType: LATITUDE
    columnWidth: 6
    helpContent: "The stop_lat field contains the latitude of a stop or station. The field value must be a valid WGS 84 latitude."
  - name: "stop_lon"
    required: false
    inputType: LONGITUDE
    columnWidth: 6
    helpContent: "The stop_lon field contains the longitude of a stop or station. The field value must be a valid WGS 84 longitude value from -180 to 180."
  - name: "zone_id"
    required: false
    inputType: GTFS_ZONE
    columnWidth: 12
    bulkEditEnabled: true
    helpContent: "The zone_id field defines the fare zone for a stop ID. Zone IDs are required if you want to provide fare information using fare_rules.txt. If this stop ID represents a station, the zone ID is ignored."
  - name: "stop_url"
    required: false
    inputType: URL
    columnWidth: 12
    helpContent: "The stop_url field contains the URL of a web page about a particular stop. This should be different from the agency_url and the route_url fields."
  - name: "location_type"
    required: false
    bulkEditEnabled: true
    inputType: DROPDOWN
    options:
    - value: '0'
      text: Stop (0)
    - value: '1'
      text: Station (1)
    - value: '2'
      text: Entrance/Exit (2)
    - value: '3'
      text: Generic Node (3)
    - value: '4'
      text: Boarding Area (4)
    columnWidth: 7
    helpContent: "The location_type field identifies whether this stop ID represents a stop or station. If no location type is specified, or the location_type is blank, stop IDs are treated as stops. Stations may have different properties from stops when they are represented on a map or used in trip planning."
  - name: "platform_code"
    required: false
    inputType: TEXT
    columnWidth: 5
    helpContent: "Platform identifier for a platform stop (a stop belonging to a station). This should be just the platform identifier (eg. G or 3)."
  - name: "parent_station"
    required: false
    inputType: GTFS_STOP
    bulkEditEnabled: true
    columnWidth: 12
    helpContent: "For stops that are physically located inside stations, the parent_station field identifies the station associated with the stop. To use this field, stops.txt must also contain a row where this stop ID is assigned location type=1."
  - name: "stop_timezone"
    required: false
    inputType: TIMEZONE
    bulkEditEnabled: true
    columnWidth: 12
    helpContent: "The stop_timezone field contains the timezone in which this stop or station is located. If omitted, the stop should be assumed to be located in the timezone specified byagency_timezone in agency.txt."
  - name: "wheelchair_boarding"
    required: false
    inputType: DROPDOWN
    bulkEditEnabled: true
    options:
    - value: 0
      text: No information (0)
    - value: 1
      text: At least some vehicles (1)
    - value: 2
      text: Not possible (2)
    columnWidth: 12
    helpContent: "The wheelchair_boarding field identifies whether wheelchair boardings are possible from the specified stop or station. The field can have the following values:"


- id: route
  name: routes.txt
  helpContent: This file contains information for a route.
  fields:
  - name: status
    datatools: true
    displayName: Status
    bulkEditEnabled: true
    required: true
    inputType: DROPDOWN
    options:
    - value: 0
      text: 'In Progress'
    - value: 1
      text: 'Pending Approval'
    - value: 2
      text: 'Approved'
    columnWidth: 6
    adminOnly: true
    # helpContent: The route_id field contains an ID that uniquely identifies a route. The route_id is dataset unique.
  - name: publicly_visible
    datatools: true
    displayName: Public?
    bulkEditEnabled: true
    required: true
    inputType: DROPDOWN
    options:
    - value: 0
      text: 'No'
    - value: 1
      text: 'Yes'
    columnWidth: 6
    adminOnly: true
    # helpContent: The route_id field contains an ID that uniquely identifies a route. The route_id is dataset unique.
  - name: route_id
    required: true
    inputType: GTFS_ID
    columnWidth: 5
    helpContent: The route_id field contains an ID that uniquely identifies a route. The route_id is dataset unique.
  - name: route_short_name
    required: true
    inputType: TEXT
    columnWidth: 7
    helpContent: The route_short_name contains the short name of a route. This will often be a short, abstract identifier like "32", "100X", or "Green" that riders use to identify a route, but which doesn't give any indication of what places the route serves.
  - name: route_long_name
    required: true
    inputType: TEXT
    columnWidth: 12
    helpContent: The route_long_name contains the full name of a route. This name is generally more descriptive than the route_short_name and will often include the route's destination or stop. At least one of route_short_name or route_long_name must be specified, or potentially both if appropriate. If the route does not have a long name, please specify a route_short_name and use an empty string as the value for this field.
  - name: agency_id
    required: false
    inputType: GTFS_AGENCY
    bulkEditEnabled: true
    columnWidth: 12
    helpContent: The agency_id field defines an agency for the specified route. This value is referenced from the agency.txt file. Use this field when you are providing data for routes from more than one agency.
  - name: route_desc
    required: false
    inputType: TEXT
    columnWidth: 12
    helpContent: 'Contains a description of a route. Please provide useful, quality information. Do not simply duplicate the name of the route. For example, "A trains operate between Inwood-207 St, Manhattan and Far Rockaway-Mott Avenue, Queens at all times. Also from about 6AM until about midnight, additional A trains operate between Inwood-207 St and Lefferts Boulevard (trains typically alternate between Lefferts Blvd and Far Rockaway)."'
  - name: route_type
    required: true
    inputType: GTFS_ROUTE_TYPE
    bulkEditEnabled: true
    options:
    - value: 3
      text: Bus
    - value: 0
      text: Tram
    - value: 1
      text: Subway
    - value: 2
      text: Rail
    - value: 4
      text: Ferry
    - value: 5
      text: Cable car
    - value: 6
      text: Gondola
    - value: 7
      text: Funicular
    - value: 11
      text: Trolleybus
    - value: 12
      text: Monorail
    - value: 100
      text: Railway Service
    - value: 101
      text: High Speed Rail Service
    - value: 102
      text: Long Distance Trains
    - value: 103
      text: Inter Regional Rail Service
    - value: 104
      text: Car Transport Rail Service
    - value: 105
      text: Sleeper Rail Service
    - value: 106
      text: Regional Rail Service
    - value: 107
      text: Tourist Railway Service
    - value: 108
      text: Rail Shuttle (Within Complex)
    - value: 109
      text: Suburban Railway
    - value: 110
      text: Replacement Rail Service
    - value: 111
      text: Special Rail Service
    - value: 112
      text: Lorry Transport Rail Service
    - value: 113
      text: All Rail Services
    - value: 114
      text: Cross-Country Rail Service
    - value: 115
      text: Vehicle Transport Rail Service
    - value: 116
      text: Rack and Pinion Railway
    - value: 117
      text: Additional Rail Service
    - value: 200
      text: Coach Service
    - value: 201
      text: International Coach Service
    - value: 202
      text: National Coach Service
    - value: 203
      text: Shuttle Coach Service
    - value: 204
      text: Regional Coach Service
    - value: 205
      text: Special Coach Service
    - value: 206
      text: Sightseeing Coach Service
    - value: 207
      text: Tourist Coach Service
    - value: 208
      text: Commuter Coach Service
    - value: 209
      text: All Coach Services
    - value: 400
      text: Urban Railway Service
    - value: 401
      text: Metro Service
    - value: 402
      text: Underground Service
    - value: 403
      text: Urban Railway Service
    - value: 404
      text: All Urban Railway Services
    - value: 405
      text: Monorail
    - value: 700
      text: Bus Service
    - value: 701
      text: Regional Bus Service
    - value: 702
      text: Express Bus Service
    - value: 703
      text: Stopping Bus Service
    - value: 704
      text: Local Bus Service
    - value: 705
      text: Night Bus Service
    - value: 706
      text: Post Bus Service
    - value: 707
      text: Special Needs Bus
    - value: 708
      text: Mobility Bus Service
    - value: 709
      text: Mobility Bus for Registered Disabled
    - value: 710
      text: Sightseeing Bus
    - value: 711
      text: Shuttle Bus
    - value: 712
      text: School Bus
    - value: 713
      text: School and Public Service Bus
    - value: 714
      text: Rail Replacement Bus Service
    - value: 715
      text: Demand and Response Bus Service
    - value: 716
      text: All Bus Services
    - value: 900
      text: Tram Service
    - value: 901
      text: City Tram Service
    - value: 902
      text: Local Tram Service
    - value: 903
      text: Regional Tram Service
    - value: 904
      text: Sightseeing Tram Service
    - value: 905
      text: Shuttle Tram Service
    - value: 906
      text: All Tram Services
    - value: 1000
      text: Water Transport Service
    - value: 1100
      text: Air Service
    - value: 1200
      text: Ferry Service
    - value: 1300
      text: Aerial Lift Service
    - value: 1400
      text: Funicular Service
    - value: 1500
      text: Taxi Service
    - value: 1501
      text: Communal Taxi Service
    - value: 1502
      text: Water Taxi Service
    - value: 1503
      text: Rail Taxi Service
    - value: 1504
      text: Bike Taxi Service
    - value: 1505
      text: Licensed Taxi Service
    - value: 1506
      text: Private Hire Service Vehicle
    - value: 1507
      text: All Taxi Services
    - value: 1700
      text: Miscellaneous Service
    - value: 1702
      text: Horse-drawn Carriage
    columnWidth: 12
    helpContent: The route_type field describes the type of transportation used on a route. Valid values for this field are...
  - name: route_sort_order
    required: false
    inputType: POSITIVE_INT
    columnWidth: 6
    helpContent: The route_sort_order field can be used to order the routes in a way which is ideal for presentation to customers. It must be a non-negative integer. Routes with smaller route_sort_order values should be displayed before routes with larger route_sort_order values.
  - name: continuous_pickup
    required: false
    inputType: DROPDOWN
    bulkEditEnabled: true
    options:
    - value: 0
      text: Continuous stopping pickup (0)
    - value: 1
      text: No continuous stopping pickup (1)
    - value: 2
      text: Must phone an agency to arrange continuous stopping pickup (2)
    - value: 3
      text: Must coordinate with a driver to arrange continuous stopping pickup (3)
    columnWidth: 12
    helpContent: Indicates whether a rider can board the transit vehicle anywhere along the vehicle’s travel path.
  - name: continuous_drop_off
    required: false
    inputType: DROPDOWN
    bulkEditEnabled: true
    options:
    - value: 0
      text: Continuous stopping drop-off (0)
    - value: 1
      text: No continuous stopping drop-off (1)
    - value: 2
      text: Must phone an agency to arrange continuous stopping drop-off (2)
    - value: 3
      text: Must coordinate with a driver to arrange continuous stopping drop-off (3)
    columnWidth: 12
    helpContent: Indicates whether a rider can alight from the transit vehicle at any point along the vehicle’s travel path.
  - name: route_url
    required: false
    inputType: URL
    placeholder: https://agency.org/route/1234
    columnWidth: 12
    helpContent: The route_url field contains the URL of a web page about that particular route. This should be different from the agency_url.
  - name: route_color
    required: false
    inputType: COLOR
    placeholder: 'FF0000'
    bulkEditEnabled: true
    columnWidth: 6
    helpContent: In systems that have colors assigned to routes, the route_color field defines a color that corresponds to a route. The color must be provided as a six-character hexadecimal number, for example, 00FFFF. If no color is specified, the default route color is white (FFFFFF).
  - name: route_text_color
    required: false
    inputType: DROPDOWN
    bulkEditEnabled: true
    options:
      - value: 'FFFFFF'
        text: White
      - value: '000000'
        text: Black
    columnWidth: 6
    helpContent: The route_text_color field can be used to specify a legible color to use for text drawn against a background of route_color. The color must be provided as a six-character hexadecimal number, for example, FFD700. If no color is specified, the default text color is black (000000).
  - name: wheelchair_accessible
    required: false
    displayName: Is route wheelchair accessible?
    inputType: DROPDOWN
    bulkEditEnabled: true
    columnWidth: 12
    helpContent: Indicates whether vehicles that operate on this route are wheelchair accessible.
    options:
      - value: 0
        text: No information (0)
      - value: 1
        text: Yes (1)
      - value: 2
        text: No (2)
  - name: route_branding_url
    required: false
    displayName: Route branding URL
    datatools: false
    placeholder: https://agency.org/assets/route/1234
    inputType: URL
    columnWidth: 12
    helpContent:

- id: trip
  name: trips.txt
  helpContent: Trips for each route. A trip is a sequence of two or more stops that occurs at specific time.
  fields:
  - name: "route_id"
    required: true
    inputType: GTFS_ROUTE
    columnWidth: 6
    helpContent: "The route_id field contains an ID that uniquely identifies a route. This value is referenced from the routes.txt file."
  - name: "service_id"
    required: true
    inputType: GTFS_SERVICE
    columnWidth: 6
    helpContent: "The service_id contains an ID that uniquely identifies a set of dates when service is available for one or more routes. This value is referenced from thecalendar.txt or calendar_dates.txt file."
  - name: "trip_id"
    required: true
    inputType: GTFS_ID
    columnWidth: 6
    helpContent: "The trip_id field contains an ID that identifies a trip. The trip_id is dataset unique."
  - name: "trip_headsign"
    required: false
    inputType: TEXT
    bulkEditEnabled: true
    columnWidth: 6
    helpContent: "The trip_headsign field contains the text that appears on a sign that identifies the trip's destination to passengers. Use this field to distinguish between different patterns of service in the same route. If the headsign changes during a trip, you can override the trip_headsign by specifying values for the the stop_headsign field in stop_times.txt."
  - name: "trip_short_name"
    required: false
    inputType: TEXT
    bulkEditEnabled: true
    columnWidth: 6
    helpContent: "The trip_short_name field contains the text that appears in schedules and sign boards to identify the trip to passengers, for example, to identify train numbers for commuter rail trips. If riders do not commonly rely on trip names, please leave this field blank."
  - name: "direction_id"
    required: false
    inputType: DROPDOWN
    bulkEditEnabled: true
    options:
    - value: '0'
    - value: '1'
    columnWidth: 6
    helpContent: "The direction_id field contains a binary value that indicates the direction of travel for a trip. Use this field to distinguish between bi-directional trips with the same route_id. This field is not used in routing; it provides a way to separate trips by direction when publishing time tables. You can specify names for each direction with the trip_headsign field."
  - name: "block_id"
    required: false
    inputType: GTFS_BLOCK
    bulkEditEnabled: true
    columnWidth: 6
    helpContent: "The block_id field identifies the block to which the trip belongs. A block consists of two or more sequential trips made using the same vehicle, where a passenger can transfer from one trip to the next just by staying in the vehicle. The block_id must be referenced by two or more trips in trips.txt."
  - name: "shape_id"
    required: false
    inputType: GTFS_SHAPE
    columnWidth: 6
    helpContent: "The shape_id field contains an ID that defines a shape for the trip. This value is referenced from the shapes.txt file. The shapes.txt file allows you to define how a line should be drawn on the map to represent a trip."
  - name: "wheelchair_accessible"
    required: false
    inputType: DROPDOWN
    bulkEditEnabled: true
    options:
    - value: '0'
    - value: '1'
    - value: '2'
    columnWidth: 6
    helpContent: "0 (or empty) - indicates that there is no accessibility information for the trip"
  - name: "bikes_allowed"
    required: false
    inputType: DROPDOWN
    bulkEditEnabled: true
    options:
    - value: '0'
    - value: '1'
    - value: '2'
    columnWidth: 6
    helpContent: "0 (or empty) - indicates that there is no bike information for the trip"


- id: stop_time
  name: stop_times.txt
  helpContent: Times that a vehicle arrives at and departs from individual stops for each trip.
  fields:
  - name: "trip_id"
    required: true
    inputType: GTFS_TRIP
    columnWidth: 6
    helpContent: "The trip_id field contains an ID that identifies a trip. This value is referenced from the trips.txt file."
  - name: "arrival_time"
    required: true
    inputType: TIME
    columnWidth: 6
    helpContent: "The arrival_time specifies the arrival time at a specific stop for a specific trip on a route. The time is measured from "
  - name: "departure_time"
    required: true
    inputType: TIME
    columnWidth: 6
    helpContent: "The departure_time specifies the departure time from a specific stop for a specific trip on a route. The time is measured from "
  - name: "stop_id"
    required: true
    inputType: GTFS_STOP
    columnWidth: 6
    helpContent: "The stop_id field contains an ID that uniquely identifies a stop. Multiple routes may use the same stop. The stop_id is referenced from the stops.txt file. If location_type is used in stops.txt, all stops referenced in stop_times.txt must have location_type of 0."
  - name: "stop_sequence"
    required: true
    inputType: POSITIVE_INT
    columnWidth: 6
    helpContent: "The stop_sequence field identifies the order of the stops for a particular trip. The values for stop_sequence must be non-negative integers, and they must increase along the trip."
  - name: "stop_headsign"
    required: false
    inputType: TEXT
    bulkEditEnabled: true
    columnWidth: 6
    helpContent: "The stop_headsign field contains the text that appears on a sign that identifies the trip's destination to passengers. Use this field to override the defaulttrip_headsign when the headsign changes between stops. If this headsign is associated with an entire trip, use trip_headsign instead."
  - name: "pickup_type"
    required: false
    inputType: DROPDOWN
    bulkEditEnabled: true
    options:
    - value: '0'
    - value: '1'
    - value: '2'
    - value: '3'
    columnWidth: 6
    helpContent: "The pickup_type field indicates whether passengers are picked up at a stop as part of the normal schedule or whether a pickup at the stop is not available. This field also allows the transit agency to indicate that passengers must call the agency or notify the driver to arrange a pickup at a particular stop. Valid values for this field are:"
  - name: "drop_off_type"
    required: false
    inputType: DROPDOWN
    bulkEditEnabled: true
    options:
    - value: '0'
    - value: '1'
    - value: '2'
    - value: '3'
    columnWidth: 6
    helpContent: "The drop_off_type field indicates whether passengers are dropped off at a stop as part of the normal schedule or whether a drop off at the stop is not available. This field also allows the transit agency to indicate that passengers must call the agency or notify the driver to arrange a drop off at a particular stop. Valid values for this field are:"
  - name: "shape_dist_traveled"
    required: false
    inputType: POSITIVE_NUM
    columnWidth: 6
    helpContent: "When used in the stop_times.txt file, the shape_dist_traveled field positions a stop as a distance from the first shape point. The shape_dist_traveled field represents a real distance traveled along the route in units such as feet or kilometers. For example, if a bus travels a distance of 5.25 kilometers from the start of the shape to the stop, the shape_dist_traveled for the stop ID would be entered as "
  - name: "timepoint"
    required: false
    inputType: DROPDOWN
    bulkEditEnabled: true
    options:
    - value: ''
    - value: '0'
    - value: '1'
    columnWidth: 6
    helpContent: "The timepoint field can be used to indicate if the specified arrival and departure times for a stop are strictly adhered to by the transit vehicle or if they are instead approximate and/or interpolated times. The field allows a GTFS producer to provide interpolated stop times that potentially incorporate local knowledge, but still indicate if the times are approximate. For stop-time entries with specified arrival and departure times, valid values for this field are:"

- id: calendar
  name: calendar.txt
  helpContent: Dates for service IDs using a weekly schedule. Specify when service starts and ends, as well as days of the week where service is available.
  fields:
  - name: "service_id"
    required: true
    inputType: GTFS_ID
    columnWidth: 6
    helpContent: "The service_id contains an ID that uniquely identifies a set of dates when service is available for one or more routes. Each service_id value can appear at most once in a calendar.txt file. This value is dataset unique. It is referenced by the trips.txt file."
  - name: "description"
    required: false
    datatools: true
    inputType: TEXT
    bulkEditEnabled: true
    columnWidth: 6
    helpContent:
  - name: "monday"
    required: true
    inputType: DAY_OF_WEEK_BOOLEAN
    bulkEditEnabled: true
    options:
    - value: '0'
    - value: '1'
    columnWidth: 6
    helpContent: "The monday field contains a binary value that indicates whether the service is valid for all Mondays."
  - name: "tuesday"
    required: true
    inputType: DAY_OF_WEEK_BOOLEAN
    bulkEditEnabled: true
    options:
    - value: '0'
    - value: '1'
    columnWidth: 6
    helpContent: "The tuesday field contains a binary value that indicates whether the service is valid for all Tuesdays."
  - name: "wednesday"
    required: true
    inputType: DAY_OF_WEEK_BOOLEAN
    bulkEditEnabled: true
    options:
    - value: '0'
    - value: '1'
    columnWidth: 6
    helpContent: "The wednesday field contains a binary value that indicates whether the service is valid for all Wednesdays."
  - name: "thursday"
    required: true
    inputType: DAY_OF_WEEK_BOOLEAN
    bulkEditEnabled: true
    options:
    - value: '0'
    - value: '1'
    columnWidth: 6
    helpContent: "The thursday field contains a binary value that indicates whether the service is valid for all Thursdays."
  - name: "friday"
    required: true
    inputType: DAY_OF_WEEK_BOOLEAN
    bulkEditEnabled: true
    options:
    - value: '0'
    - value: '1'
    columnWidth: 6
    helpContent: "The friday field contains a binary value that indicates whether the service is valid for all Fridays."
  - name: "saturday"
    required: true
    inputType: DAY_OF_WEEK_BOOLEAN
    bulkEditEnabled: true
    options:
    - value: '0'
    - value: '1'
    columnWidth: 6
    helpContent: "The saturday field contains a binary value that indicates whether the service is valid for all Saturdays."
  - name: "sunday"
    required: true
    inputType: DAY_OF_WEEK_BOOLEAN
    bulkEditEnabled: true
    options:
    - value: '0'
    - value: '1'
    columnWidth: 6
    helpContent: "The sunday field contains a binary value that indicates whether the service is valid for all Sundays."
  - name: "start_date"
    required: true
    inputType: DATE
    bulkEditEnabled: true
    columnWidth: 12
    helpContent: "The start_date field contains the start date for the service."
  - name: "end_date"
    required: true
    inputType: DATE
    bulkEditEnabled: true
    columnWidth: 12
    helpContent: "The end_date field contains the end date for the service. This date is included in the service interval."


- id: calendar_dates
  name: calendar_dates.txt
  helpContent: Exceptions for the service IDs defined in the calendar.txt file. If calendar_dates.txt includes ALL dates of service, this file may be specified instead of calendar.txt.
  fields:
  - name: "service_id"
    required: true
    inputType: GTFS_SERVICE
    columnWidth: 6
    helpContent: "The service_id contains an ID that uniquely identifies a set of dates when a service exception is available for one or more routes. Each (service_id, date) pair can only appear once in calendar_dates.txt. If the a service_id value appears in both the calendar.txt and calendar_dates.txt files, the information in calendar_dates.txt modifies the service information specified in calendar.txt. This field is referenced by the trips.txt file."
  - name: "date"
    required: true
    inputType: DATE
    bulkEditEnabled: true
    columnWidth: 12
    helpContent: "The date field specifies a particular date when service availability is different than the norm. You can use the exception_type field to indicate whether service is available on the specified date."
  - name: "exception_type"
    required: true
    inputType: DROPDOWN
    bulkEditEnabled: true
    options:
    - value: '1'
    - value: '2'
    columnWidth: 6
    helpContent: "The exception_type indicates whether service is available on the date specified in thedate field."


- id: fare_attributes
  name: fare_attributes.txt
  helpContent: Fare information for a transit organization's routes.
  fields:
  - name: "fare_id"
    required: true
    inputType: GTFS_ID
    columnWidth: 6
    helpContent: "The fare_id field contains an ID that uniquely identifies a fare class. The fare_id is dataset unique."
  - name: "price"
    required: true
    inputType: NUMBER
    bulkEditEnabled: true
    columnWidth: 6
    helpContent: "The price field contains the fare price, in the unit specified by currency_type."
  - name: "currency_type"
    required: true
    inputType: DROPDOWN
    bulkEditEnabled: true
    options:
    - value: USD
      text: US dollar (USD)
    - value: AUD
      text: Australian dollar (AUD)
    - value: CAD
      text: Canadian dollar (CAD)
    - value: CHF
      text: Swiss franc (CHF)
    - value: CNH
      text: Chinese renminbi (CNH)
    - value: EUR
      text: Euro (EUR)
    - value: GBP
      text: Pound sterling (GBP)
    - value: JPY
      text: Japanese yen (JPY)
    - value: MXN
      text: Mexican peso (MXN)
    - value: NZD
      text: New Zealand dollar (NZD)
    - value: SEK
      text: Swedish krona (SEK)
    columnWidth: 12
    helpContent: "The currency_type field defines the currency used to pay the fare. Please use the ISO 4217 alphabetical currency codes which can be found at the following URL:http://en.wikipedia.org/wiki/ISO_4217."
  - name: "payment_method"
    required: true
    inputType: DROPDOWN
    bulkEditEnabled: true
    options:
    - value: '0'
      text: Paid on board (0)
    - value: '1'
      text: Paid before boarding (1)
    columnWidth: 12
    helpContent: "The payment_method field indicates when the fare must be paid. Valid values for this field are:"
  - name: "transfers"
    required: true
    inputType: DROPDOWN
    bulkEditEnabled: true
    options:
    - value: '0'
      text: No transfers permitted (0)
    - value: '1'
      text: One transfers permitted (1)
    - value: '2'
      text: Two transfers permitted (2)
    - value: ''
      text: Unlimited transfers (empty)
    columnWidth: 6
    helpContent: "The transfers field specifies the number of transfers permitted on this fare. Valid values for this field are:"
  - name: "transfer_duration"
    required: false
    inputType: POSITIVE_INT
    bulkEditEnabled: true
    columnWidth: 6
    helpContent: "The transfer_duration field specifies the length of time in seconds before a transfer expires."
  - name: agency_id
    required: false
    inputType: GTFS_AGENCY
    bulkEditEnabled: true
    columnWidth: 12
    helpContent: "Required for feeds with multiple agencies defined in the agency.txt file. Each fare attribute must specify an agency_id value to indicate which agency the fare applies to."


- id: fare_rules
  name: fare_rules.txt
  helpContent: Rules for applying fare information for a transit organization's routes.
  fields:
  - name: "fare_id"
    required: true
    inputType: GTFS_FARE
    columnWidth: 6
    helpContent: "The fare_id field contains an ID that uniquely identifies a fare class. This value is referenced from the fare_attributes.txt file."
  - name: "route_id"
    required: false
    inputType: GTFS_ROUTE
    columnWidth: 12
    helpContent: "The route_id field associates the fare ID with a route. Route IDs are referenced from the routes.txt file. If you have several routes with the same fare attributes, create a row in fare_rules.txt for each route."
  - name: "origin_id"
    required: false
    inputType: GTFS_ZONE
    columnWidth: 6
    helpContent: "The origin_id field associates the fare ID with an origin zone ID. Zone IDs are referenced from the stops.txt file. If you have several origin IDs with the same fare attributes, create a row in fare_rules.txt for each origin ID."
  - name: "destination_id"
    required: false
    inputType: GTFS_ZONE
    columnWidth: 6
    helpContent: "The destination_id field associates the fare ID with a destination zone ID. Zone IDs are referenced from the stops.txt file. If you have several destination IDs with the same fare attributes, create a row in fare_rules.txt for each destination ID."
  - name: "contains_id"
    required: false
    inputType: GTFS_ZONE
    columnWidth: 6
    helpContent: "The contains_id field associates the fare ID with a zone ID, referenced from thestops.txt file. The fare ID is then associated with itineraries that pass through every contains_id zone."


- id: frequencies
  name: frequencies.txt
  helpContent: Headway (time between trips) for routes with variable frequency of service.
  fields:
  - name: "trip_id"
    required: true
    inputType: GTFS_TRIP
    columnWidth: 6
    helpContent: "The trip_id contains an ID that identifies a trip on which the specified frequency of service applies. Trip IDs are referenced from the trips.txt file."
  - name: "start_time"
    required: true
    inputType: TIME
    bulkEditEnabled: true
    columnWidth: 6
    helpContent: "The start_time field specifies the time at which service begins with the specified frequency. The time is measured from "
  - name: "end_time"
    required: true
    inputType: TIME
    bulkEditEnabled: true
    columnWidth: 6
    helpContent: "The end_time field indicates the time at which service changes to a different frequency (or ceases) at the first stop in the trip. The time is measured from "
  - name: "headway_secs"
    required: true
    inputType: POSITIVE_INT
    bulkEditEnabled: true
    columnWidth: 6
    helpContent: "The headway_secs field indicates the time between departures from the same stop (headway) for this trip type, during the time interval specified by start_time andend_time. The headway value must be entered in seconds."
  - name: "exact_times"
    required: false
    inputType: DROPDOWN
    bulkEditEnabled: true
    options:
    - value: '0'
    - value: '1'
    columnWidth: 6
    helpContent: "The exact_times field determines if frequency-based trips should be exactly scheduled based on the specified headway information. Valid values for this field are:"


- id: transfers
  name: transfers.txt
  helpContent: Rules for making connections at transfer points between routes.
  fields:
  - name: "from_stop_id"
    required: true
    inputType: GTFS_STOP
    columnWidth: 12
    helpContent: "The from_stop_id field contains a stop ID that identifies a stop or station where a connection between routes begins. Stop IDs are referenced from the stops.txt file. If the stop ID refers to a station that contains multiple stops, this transfer rule applies to all stops in that station."
  - name: "to_stop_id"
    required: true
    inputType: GTFS_STOP
    columnWidth: 12
    helpContent: "The to_stop_id field contains a stop ID that identifies a stop or station where a connection between routes ends. Stop IDs are referenced from the stops.txt file. If the stop ID refers to a station that contains multiple stops, this transfer rule applies to all stops in that station."
  - name: "transfer_type"
    required: true
    inputType: DROPDOWN
    options:
    - value: '0'
    - value: '1'
    - value: '2'
    - value: '3'
    columnWidth: 6
    helpContent: "The transfer_type field specifies the type of connection for the specified (from_stop_id, to_stop_id) pair. Valid values for this field are:"
  - name: "min_transfer_time"
    required: false
    inputType: POSITIVE_INT
    columnWidth: 6
    helpContent: "When a connection between routes requires an amount of time between arrival and departure (transfer_type=2), the min_transfer_time field defines the amount of time that must be available in an itinerary to permit a transfer between routes at these stops. The min_transfer_time must be sufficient to permit a typical rider to move between the two stops, including buffer time to allow for schedule variance on each route."


- id: scheduleexception
  name: (none)
  datatools: true
  helpContent: Conveyal-specific table for classifying schedule exceptions.
  fields:
  - name: name
    required: true
  - name: dates
    required: true
    inputType: EXCEPTION_DATE
  - name: exemplar
    required: true
  - name: custom_schedule
    required: false
  - name: removed_service
    required: false
  - name: added_service
    required: false