From 3efa182d264d506bc0cc67719d77b7e3bd5ede93 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Sun, 7 Jul 2024 11:11:42 -0400
Subject: [PATCH 01/30] Start vehicles
---
gtfs/spec/en/reference.md | 14 ++++++++++++++
1 file changed, 14 insertions(+)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index b190e996..201db201 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -36,6 +36,7 @@ This document defines the format and structure of the files that comprise a GTFS
- [translations.txt](#translationstxt)
- [feed\_info.txt](#feed_infotxt)
- [attributions.txt](#attributionstxt)
+ - [vehicles.txt](#vehiclestxt)
## Document Conventions
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", “SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC 2119](https://tools.ietf.org/html/rfc2119).
@@ -748,3 +749,16 @@ The file defines the attributions applied to the dataset.
| `attribution_url` | URL | Optional | URL of the organization. |
| `attribution_email` | Email | Optional | Email of the organization. |
| `attribution_phone` | Phone number | Optional | Phone number of the organization. |
+
+### vehicles.txt
+
+File: **Optional**
+
+Primary key (`label`)
+
+This file describes the capacity, accessibility and features of individual vehicles or vehicle ranges.
+
+| Field Name | Type | Presence | Description |
+| ------ | ------ | ------ | ------ |
+| `label` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails. If `high_label` is provided then this value is the low end of the range. |
+| `high_label` | Text | Optional | If a range of vehicles is represented this is the high end the range.
From 4d4ffecfaca3f0954bd8808e8e27b3fff6b9fb2a Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Sun, 7 Jul 2024 20:06:55 -0400
Subject: [PATCH 02/30] Update reference.md
---
gtfs/spec/en/reference.md | 6 ++++--
1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index 201db201..ed07145b 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -760,5 +760,7 @@ This file describes the capacity, accessibility and features of individual vehic
| Field Name | Type | Presence | Description |
| ------ | ------ | ------ | ------ |
-| `label` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails. If `high_label` is provided then this value is the low end of the range. |
-| `high_label` | Text | Optional | If a range of vehicles is represented this is the high end the range.
+| `label` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails or the vehicle identifier in other real time data sources. If `high_label` is provided then this value is the low end of the range. |
+| `high_label` | Text | Optional | If a range of vehicles is represented this is the high end the range. There may be non-numeric characters before or after the number that must be consistant for the range. |
+| `vehicle_class_id` | Text | Recommended | Identifies a class of vehicle that usually run on certain routes. |
+| `vehicle_type` | Text | Recommended | Should one of the two charactor codes in Vehicle Type column of the Referance Sheet tab on the A-30 Template from the US Federal Transit Administation at https://www.transit.dot.gov/ntd/30-template |
From 411b2fc4eb08bfabc7bf963832292c9790ab6855 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Thu, 11 Jul 2024 11:31:53 -0400
Subject: [PATCH 03/30] Update reference.md
---
gtfs/spec/en/reference.md | 8 +++++++-
1 file changed, 7 insertions(+), 1 deletion(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index ed07145b..831fdffc 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -763,4 +763,10 @@ This file describes the capacity, accessibility and features of individual vehic
| `label` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails or the vehicle identifier in other real time data sources. If `high_label` is provided then this value is the low end of the range. |
| `high_label` | Text | Optional | If a range of vehicles is represented this is the high end the range. There may be non-numeric characters before or after the number that must be consistant for the range. |
| `vehicle_class_id` | Text | Recommended | Identifies a class of vehicle that usually run on certain routes. |
-| `vehicle_type` | Text | Recommended | Should one of the two charactor codes in Vehicle Type column of the Referance Sheet tab on the A-30 Template from the US Federal Transit Administation at https://www.transit.dot.gov/ntd/30-template |
+| `vehicle_type` | Text | Recommended | Should one of the two charactor codes in Vehicle Type column on the Referance Sheet tab on the [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administation or a one or two word description of the type of vehicle |
+| `manufacturer` | Text | Optional | The name of the company that manufactured the vehicle |
+| `model` | Text | Optional | The name of the vehicle model. |
+| `year_manufactured` | Year | Optional | The year the vehicle was manufactured. If a range of vehicles is represented, then the earilest year should be used. |
+| `fuel_type` | Text | Optional | The type of fuel used to provide energy for propulsion. It should be from the list of Fuel Types column on the Referance Sheet tab on the [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administation. |
+| `length` | Positive float | Optional | The length of the vehcile in meters. |
+| 'articulated_sections` | integer | Optional | The number of articulared sections. If there are no articulations the number should be 1. |
From 9f5d43738b2aa073bcb8e750276d8f4486a4f60b Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Tue, 29 Oct 2024 17:08:38 -0400
Subject: [PATCH 04/30] Update reference.md
Additional rows
---
gtfs/spec/en/reference.md | 8 +++++++-
1 file changed, 7 insertions(+), 1 deletion(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index 831fdffc..067e0e35 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -763,10 +763,16 @@ This file describes the capacity, accessibility and features of individual vehic
| `label` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails or the vehicle identifier in other real time data sources. If `high_label` is provided then this value is the low end of the range. |
| `high_label` | Text | Optional | If a range of vehicles is represented this is the high end the range. There may be non-numeric characters before or after the number that must be consistant for the range. |
| `vehicle_class_id` | Text | Recommended | Identifies a class of vehicle that usually run on certain routes. |
+| `depot` | Text | Optional | The name of the facility where the vehicle is normally stored when not in service, such as the bus garage or train yard. |
| `vehicle_type` | Text | Recommended | Should one of the two charactor codes in Vehicle Type column on the Referance Sheet tab on the [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administation or a one or two word description of the type of vehicle |
| `manufacturer` | Text | Optional | The name of the company that manufactured the vehicle |
| `model` | Text | Optional | The name of the vehicle model. |
| `year_manufactured` | Year | Optional | The year the vehicle was manufactured. If a range of vehicles is represented, then the earilest year should be used. |
| `fuel_type` | Text | Optional | The type of fuel used to provide energy for propulsion. It should be from the list of Fuel Types column on the Referance Sheet tab on the [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administation. |
| `length` | Positive float | Optional | The length of the vehcile in meters. |
-| 'articulated_sections` | integer | Optional | The number of articulared sections. If there are no articulations the number should be 1. |
+| `articulated_sections` | integer | Optional | The number of articulared sections. If there are no articulations the number should be 1. |
+| `levels` | integer | Optional | The number of levels available to passengers. Only levels directly above or below other levels count, not where the height of the floor changes within the vehicle. |
+| `seating` | integer | Optional | The number of seats available to passengers, including ones that may become unavailable due to making space for wheelchairs or bikes. |
+| `full_load` | integer | Optional | The number of passengers that is considered a full load for a vehicle. If passenger occupancy is provided, this should be the number of passengers that is considered Full or 100%. |
+| `wheelchair_capacity` | integer | Optional | The number of spots available for passingers with wheelchairs |
+
From c6d33065c4f0544f7a4da7826f481da331fba4f7 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Wed, 30 Oct 2024 15:39:49 -0400
Subject: [PATCH 05/30] Update reference.md
---
gtfs/spec/en/reference.md | 11 +++++++----
1 file changed, 7 insertions(+), 4 deletions(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index 067e0e35..f9c066a0 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -762,7 +762,7 @@ This file describes the capacity, accessibility and features of individual vehic
| ------ | ------ | ------ | ------ |
| `label` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails or the vehicle identifier in other real time data sources. If `high_label` is provided then this value is the low end of the range. |
| `high_label` | Text | Optional | If a range of vehicles is represented this is the high end the range. There may be non-numeric characters before or after the number that must be consistant for the range. |
-| `vehicle_class_id` | Text | Recommended | Identifies a class of vehicle that usually run on certain routes. |
+| `vehicle_class` | ID | Recommended | Identifies a class of vehicle that usually run on certain routes. Ment to link with vehicle_class fields in routes.txt and trips.txt, not to be displayed. When the vehicle_class does not match the class in trips.txt or routes.txt then the consumer should highlight that the vehicle type isn't what is expected and show information about the vehicle that is coming. |
| `depot` | Text | Optional | The name of the facility where the vehicle is normally stored when not in service, such as the bus garage or train yard. |
| `vehicle_type` | Text | Recommended | Should one of the two charactor codes in Vehicle Type column on the Referance Sheet tab on the [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administation or a one or two word description of the type of vehicle |
| `manufacturer` | Text | Optional | The name of the company that manufactured the vehicle |
@@ -773,6 +773,9 @@ This file describes the capacity, accessibility and features of individual vehic
| `articulated_sections` | integer | Optional | The number of articulared sections. If there are no articulations the number should be 1. |
| `levels` | integer | Optional | The number of levels available to passengers. Only levels directly above or below other levels count, not where the height of the floor changes within the vehicle. |
| `seating` | integer | Optional | The number of seats available to passengers, including ones that may become unavailable due to making space for wheelchairs or bikes. |
-| `full_load` | integer | Optional | The number of passengers that is considered a full load for a vehicle. If passenger occupancy is provided, this should be the number of passengers that is considered Full or 100%. |
-| `wheelchair_capacity` | integer | Optional | The number of spots available for passingers with wheelchairs |
-
+| `full_load` | integer | Recommended | The number of passengers that is considered a full load for a vehicle. If passenger occupancy is provided, this should be the number of passengers that is considered Full or 100%. |
+| `wheelchairs` | integer | Recommended | The number of spots available for passingers with wheelchairs. |
+| `strollers` | integer | Optional | The number of spots available for strollers. Would include spots used by wheetchairs or strollers. |
+| `bicycles ` | integer | Recommended | The number of bicycles the vehicle can carry, either on the inside or outside of the vehicle. |
+| `bicycle_notes ` | Text | Optional | A decription of the location, procedures and restriction of bringing a bicycle on the vehicle. |
+| `luggage` | Enum | Optional | The vehicle has space set aside for luggage.
From 53ff269278dc5c2be9d5211209074131e5100eeb Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Wed, 30 Oct 2024 20:25:21 -0400
Subject: [PATCH 06/30] Update reference.md
---
gtfs/spec/en/reference.md | 10 +++++++++-
1 file changed, 9 insertions(+), 1 deletion(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index f9c066a0..ca9f5a4c 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -778,4 +778,12 @@ This file describes the capacity, accessibility and features of individual vehic
| `strollers` | integer | Optional | The number of spots available for strollers. Would include spots used by wheetchairs or strollers. |
| `bicycles ` | integer | Recommended | The number of bicycles the vehicle can carry, either on the inside or outside of the vehicle. |
| `bicycle_notes ` | Text | Optional | A decription of the location, procedures and restriction of bringing a bicycle on the vehicle. |
-| `luggage` | Enum | Optional | The vehicle has space set aside for luggage.
+| `luggage` | Enum | Optional | The vehicle has space set aside for luggage. Valid options are:
`0` - No space set aside for luggage.
`1` - Space above passenger seating for luggage.
`2` - Space set aside in the passenger cabin for luggage.`3` - Space for luggage that can be accessed externally. |
+| `luggage_notes` | Text | Optional | A description of how luggage is stored and any limitations that may apply. |
+| `restrooms` | integer | Optional | The number of restrooms in the vehicle. |
+| `air_conditioned` | Enum | Optional | Valid options are:
`0` - No air conditioning provided.
`1` -The vehicle has air conditioning. |
+| `ac_plugs` | integer | Optional | Number of AC power plug that follow the local standard available to passengers. |
+| `usb_plugs` | integer | Optional | Number of USB-A ports for charging devices available to passengers. |
+| `wifi` | Enum | Optional | Valid options are:
`0` - No WiFi available to passengers.
`1` - Internet access through WiFi with no requirements beyond agreeing to the terms of service.
`2` - Internet access available through WiFi but requires creating a free account.
`3` - Internet access available through WiFi for a fee. |
+| `wifi_notes` | Text | Optional | Description of how the access the Internet through WiFi and any limitation it has. |
+
From 61e698afcfde0a531dfa7a0dfa7c149f6cf6f98b Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Thu, 7 Nov 2024 21:42:09 -0500
Subject: [PATCH 07/30] Update reference.md
---
gtfs/spec/en/reference.md | 15 +++++++++++----
1 file changed, 11 insertions(+), 4 deletions(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index ca9f5a4c..380502c1 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -761,11 +761,11 @@ This file describes the capacity, accessibility and features of individual vehic
| Field Name | Type | Presence | Description |
| ------ | ------ | ------ | ------ |
| `label` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails or the vehicle identifier in other real time data sources. If `high_label` is provided then this value is the low end of the range. |
-| `high_label` | Text | Optional | If a range of vehicles is represented this is the high end the range. There may be non-numeric characters before or after the number that must be consistant for the range. |
+| `high_label` | Text | Optional | If a range of vehicles is represented this is the high end the range. Non-numeric characters before or after the number that must be consistant for the range. |
| `vehicle_class` | ID | Recommended | Identifies a class of vehicle that usually run on certain routes. Ment to link with vehicle_class fields in routes.txt and trips.txt, not to be displayed. When the vehicle_class does not match the class in trips.txt or routes.txt then the consumer should highlight that the vehicle type isn't what is expected and show information about the vehicle that is coming. |
| `depot` | Text | Optional | The name of the facility where the vehicle is normally stored when not in service, such as the bus garage or train yard. |
| `vehicle_type` | Text | Recommended | Should one of the two charactor codes in Vehicle Type column on the Referance Sheet tab on the [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administation or a one or two word description of the type of vehicle |
-| `manufacturer` | Text | Optional | The name of the company that manufactured the vehicle |
+| `manufacturer` | Text | Optional | The name of the company that manufactured the vehicle. |
| `model` | Text | Optional | The name of the vehicle model. |
| `year_manufactured` | Year | Optional | The year the vehicle was manufactured. If a range of vehicles is represented, then the earilest year should be used. |
| `fuel_type` | Text | Optional | The type of fuel used to provide energy for propulsion. It should be from the list of Fuel Types column on the Referance Sheet tab on the [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administation. |
@@ -785,5 +785,12 @@ This file describes the capacity, accessibility and features of individual vehic
| `ac_plugs` | integer | Optional | Number of AC power plug that follow the local standard available to passengers. |
| `usb_plugs` | integer | Optional | Number of USB-A ports for charging devices available to passengers. |
| `wifi` | Enum | Optional | Valid options are:
`0` - No WiFi available to passengers.
`1` - Internet access through WiFi with no requirements beyond agreeing to the terms of service.
`2` - Internet access available through WiFi but requires creating a free account.
`3` - Internet access available through WiFi for a fee. |
-| `wifi_notes` | Text | Optional | Description of how the access the Internet through WiFi and any limitation it has. |
-
+| `wifi_notes` | Text | Optional | Description of how the access the Internet through WiFi and any limitations it has. |
+| `doors` | integer | Optional | The number of doors on each side. If there are doors on both sides of the vehicle, provide the number of doors per side. |
+| `boarding_type` | Enum | Recommended | Valid options are:
`1` - High platform level boarding
`2` - Low platform level boarding
`3` - One or more steps are required to board`4` - Level boarding at some stations |
+| `boarding_steps` | integer | Optional | Number of steps require to board where there is no level boarding. |
+| `accessable_boarding | Enum | Recommended | The accommodation to allow boarding with a mobility device. Valid options are:
`0` - Not accessable.
`1` - Level boarding.
`2` - Ramp can be deployed.
`3` - Lift can be deployed. |
+| `accessability_notes` | Text | Optional | Information about how to board with a mobility device and any limitations. |
+| `next_stop_announcement | Enum | Recommended | Valid options are:
`1` - Automatic audio next stop annoucements.
`2` - Next stop annoucements by on board staff. |
+| `next_stop_display` | Enum | Recommended | Valid options are:
`1` - Interior displays showing the next stop.
`2` - Interior displays showing multiple upcoming stops. |
+| `decoration` | Text | Optional | A brief description of a special wrap or modification of the vehicle that is either seasonal or long term. |
From 9cc2da87a4e3d4988ab3ae0929a3804f40d7f8d4 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Thu, 7 Nov 2024 21:42:59 -0500
Subject: [PATCH 08/30] Update reference.md
---
gtfs/spec/en/reference.md | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index 380502c1..fe2d5567 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -789,8 +789,8 @@ This file describes the capacity, accessibility and features of individual vehic
| `doors` | integer | Optional | The number of doors on each side. If there are doors on both sides of the vehicle, provide the number of doors per side. |
| `boarding_type` | Enum | Recommended | Valid options are:
`1` - High platform level boarding
`2` - Low platform level boarding
`3` - One or more steps are required to board`4` - Level boarding at some stations |
| `boarding_steps` | integer | Optional | Number of steps require to board where there is no level boarding. |
-| `accessable_boarding | Enum | Recommended | The accommodation to allow boarding with a mobility device. Valid options are:
`0` - Not accessable.
`1` - Level boarding.
`2` - Ramp can be deployed.
`3` - Lift can be deployed. |
+| `accessable_boarding` | Enum | Recommended | The accommodation to allow boarding with a mobility device. Valid options are:
`0` - Not accessable.
`1` - Level boarding.
`2` - Ramp can be deployed.
`3` - Lift can be deployed. |
| `accessability_notes` | Text | Optional | Information about how to board with a mobility device and any limitations. |
-| `next_stop_announcement | Enum | Recommended | Valid options are:
`1` - Automatic audio next stop annoucements.
`2` - Next stop annoucements by on board staff. |
+| `next_stop_announcement` | Enum | Recommended | Valid options are:
`1` - Automatic audio next stop annoucements.
`2` - Next stop annoucements by on board staff. |
| `next_stop_display` | Enum | Recommended | Valid options are:
`1` - Interior displays showing the next stop.
`2` - Interior displays showing multiple upcoming stops. |
| `decoration` | Text | Optional | A brief description of a special wrap or modification of the vehicle that is either seasonal or long term. |
From 0ce1ebbc57c4bfabddb69fa7836189669dc50b08 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Thu, 7 Nov 2024 22:06:57 -0500
Subject: [PATCH 09/30] Update reference.md
---
gtfs/spec/en/reference.md | 12 +++++++-----
1 file changed, 7 insertions(+), 5 deletions(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index fe2d5567..331471d8 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -230,6 +230,7 @@ Primary key (`route_id`)
| `continuous_pickup` | Enum | Optional | Indicates that the rider can board the transit vehicle at any point along the vehicle’s travel path as described by `shapes.txt`, on every trip of the route. Valid options are:
`0` - Continuous stopping pickup.
`1` or empty - No continuous stopping pickup.
`2` - Must phone agency to arrange continuous stopping pickup.
`3` - Must coordinate with driver to arrange continuous stopping pickup.
Values for `routes.continuous_pickup` may be overridden by defining values in `stop_times.continuous_pickup` for specific `stop_time`s along the route. |
| `continuous_drop_off` | Enum | Optional | Indicates that the rider can alight from the transit vehicle at any point along the vehicle’s travel path as described by `shapes.txt`, on every trip of the route. Valid options are:
`0` - Continuous stopping drop off.
`1` or empty - No continuous stopping drop off.
`2` - Must phone agency to arrange continuous stopping drop off.
`3` - Must coordinate with driver to arrange continuous stopping drop off.
Values for `routes.continuous_drop_off` may be overridden by defining values in `stop_times.continuous_drop_off` for specific `stop_time`s along the route. |
| `network_id` | ID | **Conditionally Forbidden** | Identifies a group of routes. Multiple rows in [routes.txt](#routestxt) may have the same `network_id`.
Conditionally Forbidden:
- **Forbidden** if `route_networks.txt` file exists.
- Optional otherwise.
+| `vehicle_class` | ID | Optional | Matches the `vehicle_class` in vehicles.txt to identify the type of vehicle that usually operates on this route. Can be used for information on what type of vehicle to expect when real time data is not available and identify where the vehicle is not the expected type when real time data is available. If trips.txt has a `vehicle_class`, that value overrides the value in routes.txt. |
### trips.txt
@@ -249,6 +250,7 @@ Primary key (`trip_id`)
| `shape_id` | Foreign ID referencing `shapes.shape_id` | **Conditionally Required** | Identifies a geospatial shape describing the vehicle travel path for a trip.
Conditionally Required:
- **Required** if the trip has a continuous pickup or drop-off behavior defined either in `routes.txt` or in `stop_times.txt`.
- Optional otherwise. |
| `wheelchair_accessible` | Enum | Optional | Indicates wheelchair accessibility. Valid options are:
`0` or empty - No accessibility information for the trip.
`1` - Vehicle being used on this particular trip can accommodate at least one rider in a wheelchair.
`2` - No riders in wheelchairs can be accommodated on this trip. |
| `bikes_allowed` | Enum | Optional | Indicates whether bikes are allowed. Valid options are:
`0` or empty - No bike information for the trip.
`1` - Vehicle being used on this particular trip can accommodate at least one bicycle.
`2` - No bicycles are allowed on this trip. |
+| `vehicle_class` | ID | Optional | Matches the `vehicle_class` in vehicles.txt to identify the type of vehicle that usually operates on this trip. Can be used for information on what type of vehicle to expect when real time data is not available and identify where the vehicle is not the expected type when real time data is available. This value overrides the value in routes.txt. |
#### Example: Blocks and service day
@@ -763,12 +765,12 @@ This file describes the capacity, accessibility and features of individual vehic
| `label` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails or the vehicle identifier in other real time data sources. If `high_label` is provided then this value is the low end of the range. |
| `high_label` | Text | Optional | If a range of vehicles is represented this is the high end the range. Non-numeric characters before or after the number that must be consistant for the range. |
| `vehicle_class` | ID | Recommended | Identifies a class of vehicle that usually run on certain routes. Ment to link with vehicle_class fields in routes.txt and trips.txt, not to be displayed. When the vehicle_class does not match the class in trips.txt or routes.txt then the consumer should highlight that the vehicle type isn't what is expected and show information about the vehicle that is coming. |
-| `depot` | Text | Optional | The name of the facility where the vehicle is normally stored when not in service, such as the bus garage or train yard. |
-| `vehicle_type` | Text | Recommended | Should one of the two charactor codes in Vehicle Type column on the Referance Sheet tab on the [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administation or a one or two word description of the type of vehicle |
+| `depot` | Text | Optional | The name of the facility where the vehicle is normally stored when not in service, such as the bus garage or rail yard. |
+| `vehicle_type` | Text | Recommended | Should one of the two charactor codes in Vehicle Type column on the Referance Sheet tab on the [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administation or a one or two word description of the type of vehicle. Examples:
`BU` - Bus
`LR` - Light Rail Vehicle
`RP` - Commuter Rail Passenger Coach |
| `manufacturer` | Text | Optional | The name of the company that manufactured the vehicle. |
| `model` | Text | Optional | The name of the vehicle model. |
| `year_manufactured` | Year | Optional | The year the vehicle was manufactured. If a range of vehicles is represented, then the earilest year should be used. |
-| `fuel_type` | Text | Optional | The type of fuel used to provide energy for propulsion. It should be from the list of Fuel Types column on the Referance Sheet tab on the [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administation. |
+| `fuel_type` | Text | Optional | The type of fuel used to provide energy for propulsion. It should be from the list of Fuel Types column on the Referance Sheet tab on the [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administation. Examples include `Diesel Fuel`, `Hybrid Diesel`, `Electric Propulsion Power` and `Electric Battery`.|
| `length` | Positive float | Optional | The length of the vehcile in meters. |
| `articulated_sections` | integer | Optional | The number of articulared sections. If there are no articulations the number should be 1. |
| `levels` | integer | Optional | The number of levels available to passengers. Only levels directly above or below other levels count, not where the height of the floor changes within the vehicle. |
@@ -778,7 +780,7 @@ This file describes the capacity, accessibility and features of individual vehic
| `strollers` | integer | Optional | The number of spots available for strollers. Would include spots used by wheetchairs or strollers. |
| `bicycles ` | integer | Recommended | The number of bicycles the vehicle can carry, either on the inside or outside of the vehicle. |
| `bicycle_notes ` | Text | Optional | A decription of the location, procedures and restriction of bringing a bicycle on the vehicle. |
-| `luggage` | Enum | Optional | The vehicle has space set aside for luggage. Valid options are:
`0` - No space set aside for luggage.
`1` - Space above passenger seating for luggage.
`2` - Space set aside in the passenger cabin for luggage.`3` - Space for luggage that can be accessed externally. |
+| `luggage` | Enum | Optional | The vehicle has space set aside for luggage. Valid options are:
`0` - No space set aside for luggage.
`1` - Space above passenger seating for luggage.
`2` - Space set aside in the passenger cabin for luggage.
`3` - Space for luggage that can be accessed externally. |
| `luggage_notes` | Text | Optional | A description of how luggage is stored and any limitations that may apply. |
| `restrooms` | integer | Optional | The number of restrooms in the vehicle. |
| `air_conditioned` | Enum | Optional | Valid options are:
`0` - No air conditioning provided.
`1` -The vehicle has air conditioning. |
@@ -787,7 +789,7 @@ This file describes the capacity, accessibility and features of individual vehic
| `wifi` | Enum | Optional | Valid options are:
`0` - No WiFi available to passengers.
`1` - Internet access through WiFi with no requirements beyond agreeing to the terms of service.
`2` - Internet access available through WiFi but requires creating a free account.
`3` - Internet access available through WiFi for a fee. |
| `wifi_notes` | Text | Optional | Description of how the access the Internet through WiFi and any limitations it has. |
| `doors` | integer | Optional | The number of doors on each side. If there are doors on both sides of the vehicle, provide the number of doors per side. |
-| `boarding_type` | Enum | Recommended | Valid options are:
`1` - High platform level boarding
`2` - Low platform level boarding
`3` - One or more steps are required to board`4` - Level boarding at some stations |
+| `boarding_type` | Enum | Recommended | Valid options are:
`1` - High platform level boarding
`2` - Low platform level boarding
`3` - One or more steps are required to board.
`4` - Level boarding at some stations |
| `boarding_steps` | integer | Optional | Number of steps require to board where there is no level boarding. |
| `accessable_boarding` | Enum | Recommended | The accommodation to allow boarding with a mobility device. Valid options are:
`0` - Not accessable.
`1` - Level boarding.
`2` - Ramp can be deployed.
`3` - Lift can be deployed. |
| `accessability_notes` | Text | Optional | Information about how to board with a mobility device and any limitations. |
From f14f328a12d0242ab4e9c0fc1f94efc67384f666 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Sat, 23 Nov 2024 11:09:59 -0500
Subject: [PATCH 10/30] Update reference.md
---
gtfs/spec/en/reference.md | 16 +++++++++-------
1 file changed, 9 insertions(+), 7 deletions(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index 331471d8..f020085d 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -774,18 +774,20 @@ This file describes the capacity, accessibility and features of individual vehic
| `length` | Positive float | Optional | The length of the vehcile in meters. |
| `articulated_sections` | integer | Optional | The number of articulared sections. If there are no articulations the number should be 1. |
| `levels` | integer | Optional | The number of levels available to passengers. Only levels directly above or below other levels count, not where the height of the floor changes within the vehicle. |
+| `vehicle_notes` | Text | Optional | Notable aspects about the vehicles that passengers should know about not covered by other fields. |
| `seating` | integer | Optional | The number of seats available to passengers, including ones that may become unavailable due to making space for wheelchairs or bikes. |
| `full_load` | integer | Recommended | The number of passengers that is considered a full load for a vehicle. If passenger occupancy is provided, this should be the number of passengers that is considered Full or 100%. |
| `wheelchairs` | integer | Recommended | The number of spots available for passingers with wheelchairs. |
-| `strollers` | integer | Optional | The number of spots available for strollers. Would include spots used by wheetchairs or strollers. |
+| `strollers` | integer | Optional | The number of spots available for strollers. Would include spots used by wheelchairs or strollers. |
| `bicycles ` | integer | Recommended | The number of bicycles the vehicle can carry, either on the inside or outside of the vehicle. |
-| `bicycle_notes ` | Text | Optional | A decription of the location, procedures and restriction of bringing a bicycle on the vehicle. |
+| `bicycle_notes` | Text | Optional | A decription of the location, procedures and restriction of bringing a bicycle on the vehicle. |
| `luggage` | Enum | Optional | The vehicle has space set aside for luggage. Valid options are:
`0` - No space set aside for luggage.
`1` - Space above passenger seating for luggage.
`2` - Space set aside in the passenger cabin for luggage.
`3` - Space for luggage that can be accessed externally. |
| `luggage_notes` | Text | Optional | A description of how luggage is stored and any limitations that may apply. |
| `restrooms` | integer | Optional | The number of restrooms in the vehicle. |
-| `air_conditioned` | Enum | Optional | Valid options are:
`0` - No air conditioning provided.
`1` -The vehicle has air conditioning. |
-| `ac_plugs` | integer | Optional | Number of AC power plug that follow the local standard available to passengers. |
-| `usb_plugs` | integer | Optional | Number of USB-A ports for charging devices available to passengers. |
+| `air_conditioned` | Enum | Optional | Valid options are:
`0` - No air conditioning provided.
`1` - The vehicle has air conditioning. |
+| `ac_plugs` | integer | Optional | AC power plugs that follow the local standard that are available to passengers.
Empty - No information on availability.
`0` - No AC power plugs available.
`1` - An unknown number of AC power plugs available.
Other number - the number of AC power plugs available to passengers. |
+| `usba_plugs` | integer | Optional | USB-A ports for charging devices available to passengers.
Empty - No information on availability.
`0` - No USB-A ports available.
`1` - An unknown number of USB-A ports available.
Other number - the number of USB-A ports available to passengers. |
+| `usbc_plugs` | integer | Optional | USB-C ports for charging devices available to passengers.
Empty - No information on availability.
`0` - No USB-C ports available.
`1` - An unknown number of USB-C ports available.
Other number - the number of USB-C ports available to passengers. |
| `wifi` | Enum | Optional | Valid options are:
`0` - No WiFi available to passengers.
`1` - Internet access through WiFi with no requirements beyond agreeing to the terms of service.
`2` - Internet access available through WiFi but requires creating a free account.
`3` - Internet access available through WiFi for a fee. |
| `wifi_notes` | Text | Optional | Description of how the access the Internet through WiFi and any limitations it has. |
| `doors` | integer | Optional | The number of doors on each side. If there are doors on both sides of the vehicle, provide the number of doors per side. |
@@ -793,6 +795,6 @@ This file describes the capacity, accessibility and features of individual vehic
| `boarding_steps` | integer | Optional | Number of steps require to board where there is no level boarding. |
| `accessable_boarding` | Enum | Recommended | The accommodation to allow boarding with a mobility device. Valid options are:
`0` - Not accessable.
`1` - Level boarding.
`2` - Ramp can be deployed.
`3` - Lift can be deployed. |
| `accessability_notes` | Text | Optional | Information about how to board with a mobility device and any limitations. |
-| `next_stop_announcement` | Enum | Recommended | Valid options are:
`1` - Automatic audio next stop annoucements.
`2` - Next stop annoucements by on board staff. |
-| `next_stop_display` | Enum | Recommended | Valid options are:
`1` - Interior displays showing the next stop.
`2` - Interior displays showing multiple upcoming stops. |
+| `next_stop_announcement` | Enum | Recommended | Audible next stop announcemnts. Valid options are:
`0` - No next stop announcement available.
`1` - Automatic audio next stop annoucements.
`2` - Next stop annoucements by on board staff.
`3` - Next stop annoucements on request of on board staff. |
+| `next_stop_display` | Enum | Recommended | Visual next stop displays. Valid options are:
`0` - No next stop display.
`1` - Interior displays showing the next stop.
`2` - Interior displays showing multiple upcoming stops. |
| `decoration` | Text | Optional | A brief description of a special wrap or modification of the vehicle that is either seasonal or long term. |
From 5cf0039e5e9c2a1598251346bedf82ceddbd4623 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Sat, 23 Nov 2024 11:35:27 -0500
Subject: [PATCH 11/30] Update reference.md
---
gtfs/spec/en/reference.md | 68 +++++++++++++++++++--------------------
1 file changed, 34 insertions(+), 34 deletions(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index f020085d..6420276f 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -762,39 +762,39 @@ This file describes the capacity, accessibility and features of individual vehic
| Field Name | Type | Presence | Description |
| ------ | ------ | ------ | ------ |
-| `label` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails or the vehicle identifier in other real time data sources. If `high_label` is provided then this value is the low end of the range. |
-| `high_label` | Text | Optional | If a range of vehicles is represented this is the high end the range. Non-numeric characters before or after the number that must be consistant for the range. |
-| `vehicle_class` | ID | Recommended | Identifies a class of vehicle that usually run on certain routes. Ment to link with vehicle_class fields in routes.txt and trips.txt, not to be displayed. When the vehicle_class does not match the class in trips.txt or routes.txt then the consumer should highlight that the vehicle type isn't what is expected and show information about the vehicle that is coming. |
+| `label` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails or the vehicle identifier in other real-time data sources. If `high_label` is provided then this value is the low end of the range. |
+| `high_label` | Text | Optional | If a range of vehicles is represented this is the high end of the range. Non-numeric characters before or after the number must be consistent for the range. |
+| `vehicle_class` | ID | Recommended | Identifies a class of vehicle that usually runs on certain routes. Ment to link with vehicle_class fields in routes.txt and trips.txt. When the vehicle_class does not match the class in trips.txt or routes.txt then the consumer should highlight that the vehicle type isn't what is expected and show information about the vehicle that is coming. |
| `depot` | Text | Optional | The name of the facility where the vehicle is normally stored when not in service, such as the bus garage or rail yard. |
-| `vehicle_type` | Text | Recommended | Should one of the two charactor codes in Vehicle Type column on the Referance Sheet tab on the [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administation or a one or two word description of the type of vehicle. Examples:
`BU` - Bus
`LR` - Light Rail Vehicle
`RP` - Commuter Rail Passenger Coach |
-| `manufacturer` | Text | Optional | The name of the company that manufactured the vehicle. |
-| `model` | Text | Optional | The name of the vehicle model. |
-| `year_manufactured` | Year | Optional | The year the vehicle was manufactured. If a range of vehicles is represented, then the earilest year should be used. |
-| `fuel_type` | Text | Optional | The type of fuel used to provide energy for propulsion. It should be from the list of Fuel Types column on the Referance Sheet tab on the [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administation. Examples include `Diesel Fuel`, `Hybrid Diesel`, `Electric Propulsion Power` and `Electric Battery`.|
-| `length` | Positive float | Optional | The length of the vehcile in meters. |
-| `articulated_sections` | integer | Optional | The number of articulared sections. If there are no articulations the number should be 1. |
-| `levels` | integer | Optional | The number of levels available to passengers. Only levels directly above or below other levels count, not where the height of the floor changes within the vehicle. |
-| `vehicle_notes` | Text | Optional | Notable aspects about the vehicles that passengers should know about not covered by other fields. |
-| `seating` | integer | Optional | The number of seats available to passengers, including ones that may become unavailable due to making space for wheelchairs or bikes. |
-| `full_load` | integer | Recommended | The number of passengers that is considered a full load for a vehicle. If passenger occupancy is provided, this should be the number of passengers that is considered Full or 100%. |
-| `wheelchairs` | integer | Recommended | The number of spots available for passingers with wheelchairs. |
-| `strollers` | integer | Optional | The number of spots available for strollers. Would include spots used by wheelchairs or strollers. |
-| `bicycles ` | integer | Recommended | The number of bicycles the vehicle can carry, either on the inside or outside of the vehicle. |
+| `vehicle_type` | Text | Recommended | Should be one of the two character codes in the Vehicle Type column on the Reference Sheet tab in [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administration or a one or two word description of the type of vehicle. Examples:
`BU` - Bus
`LR` - Light Rail Vehicle
`RP` - Commuter Rail Passenger Coach |
+| `manufacturer` | Text | Optional | The name of the company that manufactured the vehicle. |
+| `model` | Text | Optional | The name of the vehicle model. |
+| `year_manufactured` | Year | Optional | The year the vehicle was manufactured. If a range of vehicles is represented, the earliest year should be used. |
+| `fuel_type` | Text | Optional | The type of fuel used to provide energy for propulsion. It should be from the list of Fuel Types column on the Reference Sheet tab in [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administration. Examples include `Diesel Fuel`, `Hybrid Diesel`, `Electric Propulsion Power` and `Electric Battery`.|
+| `length` | Positive float | Optional | The length of the vehicle in meters. |
+| `articulated_sections` | integer | Optional | The number of articulated sections. If there are no articulations the number should be 1. |
+| `levels` | integer | Optional | The number of levels available to passengers. Only levels directly above or below other levels count, not where the height of the floor changes within the vehicle. |
+| `vehicle_notes` | Text | Optional | Notable aspects about the vehicles that passengers should know about not covered by other fields. |
+| `seating` | integer | Optional | The number of seats available to passengers, including ones that may become unavailable due to making space for wheelchairs or bikes. |
+| `full_load` | integer | Recommended | The number of passengers that is considered a full load for a vehicle. If passenger occupancy is provided, this should be the number of passengers that is considered Full or 100%. |
+| `wheelchairs` | integer | Recommended | The number of spots available for passingers with wheelchairs. |
+| `strollers` | integer | Optional | The number of spots available for strollers. Would include spots used by wheelchairs or strollers. |
+| `bicycles ` | integer | Recommended | The number of bicycles the vehicle can carry, either on the inside or outside of the vehicle. |
| `bicycle_notes` | Text | Optional | A decription of the location, procedures and restriction of bringing a bicycle on the vehicle. |
-| `luggage` | Enum | Optional | The vehicle has space set aside for luggage. Valid options are:
`0` - No space set aside for luggage.
`1` - Space above passenger seating for luggage.
`2` - Space set aside in the passenger cabin for luggage.
`3` - Space for luggage that can be accessed externally. |
-| `luggage_notes` | Text | Optional | A description of how luggage is stored and any limitations that may apply. |
-| `restrooms` | integer | Optional | The number of restrooms in the vehicle. |
-| `air_conditioned` | Enum | Optional | Valid options are:
`0` - No air conditioning provided.
`1` - The vehicle has air conditioning. |
-| `ac_plugs` | integer | Optional | AC power plugs that follow the local standard that are available to passengers.
Empty - No information on availability.
`0` - No AC power plugs available.
`1` - An unknown number of AC power plugs available.
Other number - the number of AC power plugs available to passengers. |
-| `usba_plugs` | integer | Optional | USB-A ports for charging devices available to passengers.
Empty - No information on availability.
`0` - No USB-A ports available.
`1` - An unknown number of USB-A ports available.
Other number - the number of USB-A ports available to passengers. |
-| `usbc_plugs` | integer | Optional | USB-C ports for charging devices available to passengers.
Empty - No information on availability.
`0` - No USB-C ports available.
`1` - An unknown number of USB-C ports available.
Other number - the number of USB-C ports available to passengers. |
-| `wifi` | Enum | Optional | Valid options are:
`0` - No WiFi available to passengers.
`1` - Internet access through WiFi with no requirements beyond agreeing to the terms of service.
`2` - Internet access available through WiFi but requires creating a free account.
`3` - Internet access available through WiFi for a fee. |
-| `wifi_notes` | Text | Optional | Description of how the access the Internet through WiFi and any limitations it has. |
-| `doors` | integer | Optional | The number of doors on each side. If there are doors on both sides of the vehicle, provide the number of doors per side. |
-| `boarding_type` | Enum | Recommended | Valid options are:
`1` - High platform level boarding
`2` - Low platform level boarding
`3` - One or more steps are required to board.
`4` - Level boarding at some stations |
-| `boarding_steps` | integer | Optional | Number of steps require to board where there is no level boarding. |
-| `accessable_boarding` | Enum | Recommended | The accommodation to allow boarding with a mobility device. Valid options are:
`0` - Not accessable.
`1` - Level boarding.
`2` - Ramp can be deployed.
`3` - Lift can be deployed. |
-| `accessability_notes` | Text | Optional | Information about how to board with a mobility device and any limitations. |
-| `next_stop_announcement` | Enum | Recommended | Audible next stop announcemnts. Valid options are:
`0` - No next stop announcement available.
`1` - Automatic audio next stop annoucements.
`2` - Next stop annoucements by on board staff.
`3` - Next stop annoucements on request of on board staff. |
-| `next_stop_display` | Enum | Recommended | Visual next stop displays. Valid options are:
`0` - No next stop display.
`1` - Interior displays showing the next stop.
`2` - Interior displays showing multiple upcoming stops. |
-| `decoration` | Text | Optional | A brief description of a special wrap or modification of the vehicle that is either seasonal or long term. |
+| `luggage` | Enum | Optional | The vehicle has space set aside for luggage. Valid options are:
`0` - No space set aside for luggage.
`1` - Space above passenger seating for luggage.
`2` - Space set aside in the passenger cabin for luggage.
`3` - Space for luggage that can be accessed externally. |
+| `luggage_notes` | Text | Optional | A description of how luggage is stored and any limitations that may apply. |
+| `restrooms` | integer | Optional | The number of restrooms in the vehicle. |
+| `air_conditioned` | Enum | Optional | Valid options are:
`0` - No air conditioning provided.
`1` - The vehicle has air conditioning. |
+| `ac_plugs` | integer | Optional | AC power plugs that follow the local standard that are available to passengers.
Empty - No information on availability.
`0` - No AC power plugs available.
`1` - An unknown number of AC power plugs available.
Other number - the number of AC power plugs available to passengers. |
+| `usba_plugs` | integer | Optional | USB-A ports for charging devices available to passengers.
Empty - No information on availability.
`0` - No USB-A ports available.
`1` - An unknown number of USB-A ports available.
Other number - the number of USB-A ports available to passengers. |
+| `usbc_plugs` | integer | Optional | USB-C ports for charging devices available to passengers.
Empty - No information on availability.
`0` - No USB-C ports available.
`1` - An unknown number of USB-C ports available.
Other number - the number of USB-C ports available to passengers. |
+| `wifi` | Enum | Optional | Valid options are:
`0` - No WiFi available to passengers.
`1` - Internet access through WiFi with no requirements beyond agreeing to the terms of service.
`2` - Internet access available through WiFi but requires creating a free account.
`3` - Internet access available through WiFi for a fee. |
+| `wifi_notes` | Text | Optional | Description of how the access the Internet through WiFi and any limitations it has. |
+| `doors` | integer | Optional | The number of doors on each side. If there are doors on both sides of the vehicle, provide the number of doors per side. |
+| `boarding_type` | Enum | Recommended | Valid options are:
`1` - High platform level boarding
`2` - Low platform level boarding
`3` - One or more steps are required to board.
`4` - Level boarding at some stations |
+| `boarding_steps` | integer | Optional | Number of steps require to board where there is no level boarding. |
+| `accessable_boarding` | Enum | Recommended | The accommodation to allow boarding with a mobility device. Valid options are:
`0` - Not accessable.
`1` - Level boarding.
`2` - Ramp can be deployed.
`3` - Lift can be deployed. |
+| `accessability_notes` | Text | Optional | Information about how to board with a mobility device and any limitations. |
+| `next_stop_announcement` | Enum | Recommended | Audible next stop announcemnts. Valid options are:
`0` - No next stop announcement available.
`1` - Automatic audio next stop annoucements.
`2` - Next stop annoucements by on board staff.
`3` - Next stop annoucements on request of on board staff. |
+| `next_stop_display` | Enum | Recommended | Visual next stop displays. Valid options are:
`0` - No next stop display.
`1` - Interior displays showing the next stop.
`2` - Interior displays showing multiple upcoming stops. |
+| `decoration` | Text | Optional | A brief description of a special wrap or modification of the vehicle that is either seasonal or long term. |
From b8fdedec769cb2dcf0c2dbd68ff374d5354c906d Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Sun, 24 Nov 2024 10:56:01 -0500
Subject: [PATCH 12/30] Update reference.md
---
gtfs/spec/en/reference.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index 6420276f..bb3ce057 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -774,6 +774,7 @@ This file describes the capacity, accessibility and features of individual vehic
| `length` | Positive float | Optional | The length of the vehicle in meters. |
| `articulated_sections` | integer | Optional | The number of articulated sections. If there are no articulations the number should be 1. |
| `levels` | integer | Optional | The number of levels available to passengers. Only levels directly above or below other levels count, not where the height of the floor changes within the vehicle. |
+| `image_url` | URL | Optional | Fully qualified URL of an image of the vehicle. The image should have as aspect ratio between 1:1 and 2:1 and a have a vertical resolution of at least 500. Consumers should only download this image one time for each GTFS update and always serve it to end users themselves. End users should never be automatically downloading directly from the URL provided.
| `vehicle_notes` | Text | Optional | Notable aspects about the vehicles that passengers should know about not covered by other fields. |
| `seating` | integer | Optional | The number of seats available to passengers, including ones that may become unavailable due to making space for wheelchairs or bikes. |
| `full_load` | integer | Recommended | The number of passengers that is considered a full load for a vehicle. If passenger occupancy is provided, this should be the number of passengers that is considered Full or 100%. |
From 5cd17fe22748e659c5793c6b23068b22e0b02fbf Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Sun, 22 Dec 2024 19:52:00 -0500
Subject: [PATCH 13/30] Update reference.md
---
gtfs/spec/en/reference.md | 7 +++++--
1 file changed, 5 insertions(+), 2 deletions(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index bb3ce057..053a9033 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -774,7 +774,9 @@ This file describes the capacity, accessibility and features of individual vehic
| `length` | Positive float | Optional | The length of the vehicle in meters. |
| `articulated_sections` | integer | Optional | The number of articulated sections. If there are no articulations the number should be 1. |
| `levels` | integer | Optional | The number of levels available to passengers. Only levels directly above or below other levels count, not where the height of the floor changes within the vehicle. |
-| `image_url` | URL | Optional | Fully qualified URL of an image of the vehicle. The image should have as aspect ratio between 1:1 and 2:1 and a have a vertical resolution of at least 500. Consumers should only download this image one time for each GTFS update and always serve it to end users themselves. End users should never be automatically downloading directly from the URL provided.
+| `image_url` | URL | Optional | Fully qualified URL of an image of the vehicle. The image should have as aspect ratio between 1:1 and 2:1 and a have a vertical resolution of at least 500. The image should show the front of the vehicle (except for train cars) and the side the passengers baord. The rights to the image should also free commerical reproduction of the image. It may or may not require attribution. Consumers should only download this image one time for each GTFS update and always serve it to end users themselves. End users should never be automatically downloading directly from the URL provided. |
+| `image_photographer` | Text | Conditionally Required | The name of the person or organization that took the photo in the `image_url`. Required if the photo `image_url` wasn't produced by the transit agency that operates it. |
+| `image_details` | URL | Optional | Fully qualified URL of an web page with more information on the photo, photographer or organation that produced the photo in the `image_url` |
| `vehicle_notes` | Text | Optional | Notable aspects about the vehicles that passengers should know about not covered by other fields. |
| `seating` | integer | Optional | The number of seats available to passengers, including ones that may become unavailable due to making space for wheelchairs or bikes. |
| `full_load` | integer | Recommended | The number of passengers that is considered a full load for a vehicle. If passenger occupancy is provided, this should be the number of passengers that is considered Full or 100%. |
@@ -784,7 +786,8 @@ This file describes the capacity, accessibility and features of individual vehic
| `bicycle_notes` | Text | Optional | A decription of the location, procedures and restriction of bringing a bicycle on the vehicle. |
| `luggage` | Enum | Optional | The vehicle has space set aside for luggage. Valid options are:
`0` - No space set aside for luggage.
`1` - Space above passenger seating for luggage.
`2` - Space set aside in the passenger cabin for luggage.
`3` - Space for luggage that can be accessed externally. |
| `luggage_notes` | Text | Optional | A description of how luggage is stored and any limitations that may apply. |
-| `restrooms` | integer | Optional | The number of restrooms in the vehicle. |
+| `restrooms` | integer | Optional | The number of restrooms in the vehicle, including any accessable restrooms. |
+| `accessable_restrooms` | integer | Optional | The number of accessable restrooms in the vehicle. |
| `air_conditioned` | Enum | Optional | Valid options are:
`0` - No air conditioning provided.
`1` - The vehicle has air conditioning. |
| `ac_plugs` | integer | Optional | AC power plugs that follow the local standard that are available to passengers.
Empty - No information on availability.
`0` - No AC power plugs available.
`1` - An unknown number of AC power plugs available.
Other number - the number of AC power plugs available to passengers. |
| `usba_plugs` | integer | Optional | USB-A ports for charging devices available to passengers.
Empty - No information on availability.
`0` - No USB-A ports available.
`1` - An unknown number of USB-A ports available.
Other number - the number of USB-A ports available to passengers. |
From 3474dcab9a938fb95715e5c38fa812a650a38655 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Sat, 15 Feb 2025 11:13:26 -0500
Subject: [PATCH 14/30] Update reference.md
---
gtfs/spec/en/reference.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index 5ba09d6e..b9eddc4f 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -901,7 +901,7 @@ This file describes the capacity, accessibility and features of individual vehic
| `length` | Positive float | Optional | The length of the vehicle in meters. |
| `articulated_sections` | integer | Optional | The number of articulated sections. If there are no articulations the number should be 1. |
| `levels` | integer | Optional | The number of levels available to passengers. Only levels directly above or below other levels count, not where the height of the floor changes within the vehicle. |
-| `image_url` | URL | Optional | Fully qualified URL of an image of the vehicle. The image should have as aspect ratio between 1:1 and 2:1 and a have a vertical resolution of at least 500. The image should show the front of the vehicle (except for train cars) and the side the passengers baord. The rights to the image should also free commerical reproduction of the image. It may or may not require attribution. Consumers should only download this image one time for each GTFS update and always serve it to end users themselves. End users should never be automatically downloading directly from the URL provided. |
+| `image_url` | URL | Optional | Fully qualified URL of an image of the vehicle. The image should have as aspect ratio between 1:1 and 2:1 and a have a vertical resolution of at least 500. The image should show the front of the vehicle (except for train cars) and the side the passengers baord. The rights to the image should also free commerical reproduction of the image, for example licenced under [CC-BY]|(https://creativecommons.org/licenses/by/4.0/). Consumers should only download this image one time for each GTFS update and always serve it to end users themselves. End users should never be automatically downloading directly from the URL provided. |
| `image_photographer` | Text | Conditionally Required | The name of the person or organization that took the photo in the `image_url`. Required if the photo `image_url` wasn't produced by the transit agency that operates it. |
| `image_details` | URL | Optional | Fully qualified URL of an web page with more information on the photo, photographer or organation that produced the photo in the `image_url` |
| `vehicle_notes` | Text | Optional | Notable aspects about the vehicles that passengers should know about not covered by other fields. |
From 198521d5549802c7183446efe38581a4d422fd4f Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Sat, 15 Feb 2025 11:14:53 -0500
Subject: [PATCH 15/30] Update reference.md
---
gtfs/spec/en/reference.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index b9eddc4f..549a6239 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -901,7 +901,7 @@ This file describes the capacity, accessibility and features of individual vehic
| `length` | Positive float | Optional | The length of the vehicle in meters. |
| `articulated_sections` | integer | Optional | The number of articulated sections. If there are no articulations the number should be 1. |
| `levels` | integer | Optional | The number of levels available to passengers. Only levels directly above or below other levels count, not where the height of the floor changes within the vehicle. |
-| `image_url` | URL | Optional | Fully qualified URL of an image of the vehicle. The image should have as aspect ratio between 1:1 and 2:1 and a have a vertical resolution of at least 500. The image should show the front of the vehicle (except for train cars) and the side the passengers baord. The rights to the image should also free commerical reproduction of the image, for example licenced under [CC-BY]|(https://creativecommons.org/licenses/by/4.0/). Consumers should only download this image one time for each GTFS update and always serve it to end users themselves. End users should never be automatically downloading directly from the URL provided. |
+| `image_url` | URL | Optional | Fully qualified URL of an image of the vehicle. The image should have as aspect ratio between 1:1 and 2:1 and a have a vertical resolution of at least 500. The image should show the front of the vehicle (except for train cars) and the side the passengers baord. The rights to the image should also free commerical reproduction of the image, for example licenced under [CC-BY](https://creativecommons.org/licenses/by/4.0/). Consumers should only download this image one time for each GTFS update and always serve it to end users themselves. End users should never be automatically downloading directly from the URL provided. |
| `image_photographer` | Text | Conditionally Required | The name of the person or organization that took the photo in the `image_url`. Required if the photo `image_url` wasn't produced by the transit agency that operates it. |
| `image_details` | URL | Optional | Fully qualified URL of an web page with more information on the photo, photographer or organation that produced the photo in the `image_url` |
| `vehicle_notes` | Text | Optional | Notable aspects about the vehicles that passengers should know about not covered by other fields. |
From b854c876946a264d2b703b0a1c607cb22fedf999 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Mon, 17 Feb 2025 10:51:16 -0500
Subject: [PATCH 16/30] Update reference.md
---
gtfs/spec/en/reference.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index 549a6239..a7d324e0 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -927,5 +927,5 @@ This file describes the capacity, accessibility and features of individual vehic
| `accessable_boarding` | Enum | Recommended | The accommodation to allow boarding with a mobility device. Valid options are:
`0` - Not accessable.
`1` - Level boarding.
`2` - Ramp can be deployed.
`3` - Lift can be deployed. |
| `accessability_notes` | Text | Optional | Information about how to board with a mobility device and any limitations. |
| `next_stop_announcement` | Enum | Recommended | Audible next stop announcemnts. Valid options are:
`0` - No next stop announcement available.
`1` - Automatic audio next stop annoucements.
`2` - Next stop annoucements by on board staff.
`3` - Next stop annoucements on request of on board staff. |
-| `next_stop_display` | Enum | Recommended | Visual next stop displays. Valid options are:
`0` - No next stop display.
`1` - Interior displays showing the next stop.
`2` - Interior displays showing multiple upcoming stops. |
+| `next_stop_display` | Enum | Recommended | Visual next stop displays. Valid options are:
`0` - No next stop display.
`1` - Interior displays showing the next stop.
`2` - Interior displays showing multiple upcoming stops.
`3` - The name of the station can be seen from inside the vehicle |
| `decoration` | Text | Optional | A brief description of a special wrap or modification of the vehicle that is either seasonal or long term. |
From 4f7a78001a7f999bec306b4fff009970db08fbf7 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Sat, 22 Feb 2025 13:14:47 -0500
Subject: [PATCH 17/30] Update reference.md
---
gtfs/spec/en/reference.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index a7d324e0..d169c4b8 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -890,7 +890,7 @@ This file describes the capacity, accessibility and features of individual vehic
| Field Name | Type | Presence | Description |
| ------ | ------ | ------ | ------ |
| `label` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails or the vehicle identifier in other real-time data sources. If `high_label` is provided then this value is the low end of the range. |
-| `high_label` | Text | Optional | If a range of vehicles is represented this is the high end of the range. Non-numeric characters before or after the number must be consistent for the range. |
+| `high_label` | Text | Optional | If a range of vehicles is represented this is the high end of the range. The number of charactors must be the same as `label` and range covers values with the same number of charactors and are between `label` and `high_label` when using a comparison as a string. |
| `vehicle_class` | ID | Recommended | Identifies a class of vehicle that usually runs on certain routes. Ment to link with vehicle_class fields in routes.txt and trips.txt. When the vehicle_class does not match the class in trips.txt or routes.txt then the consumer should highlight that the vehicle type isn't what is expected and show information about the vehicle that is coming. |
| `depot` | Text | Optional | The name of the facility where the vehicle is normally stored when not in service, such as the bus garage or rail yard. |
| `vehicle_type` | Text | Recommended | Should be one of the two character codes in the Vehicle Type column on the Reference Sheet tab in [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administration or a one or two word description of the type of vehicle. Examples:
`BU` - Bus
`LR` - Light Rail Vehicle
`RP` - Commuter Rail Passenger Coach |
From c64ee650db570f999822e965112976c843f8e244 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Sat, 22 Feb 2025 21:56:05 -0500
Subject: [PATCH 18/30] Update reference.md
---
gtfs/spec/en/reference.md | 4 +++-
1 file changed, 3 insertions(+), 1 deletion(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index d169c4b8..2d733418 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -927,5 +927,7 @@ This file describes the capacity, accessibility and features of individual vehic
| `accessable_boarding` | Enum | Recommended | The accommodation to allow boarding with a mobility device. Valid options are:
`0` - Not accessable.
`1` - Level boarding.
`2` - Ramp can be deployed.
`3` - Lift can be deployed. |
| `accessability_notes` | Text | Optional | Information about how to board with a mobility device and any limitations. |
| `next_stop_announcement` | Enum | Recommended | Audible next stop announcemnts. Valid options are:
`0` - No next stop announcement available.
`1` - Automatic audio next stop annoucements.
`2` - Next stop annoucements by on board staff.
`3` - Next stop annoucements on request of on board staff. |
-| `next_stop_display` | Enum | Recommended | Visual next stop displays. Valid options are:
`0` - No next stop display.
`1` - Interior displays showing the next stop.
`2` - Interior displays showing multiple upcoming stops.
`3` - The name of the station can be seen from inside the vehicle |
+| `next_stop_display` | Enum | Recommended | Visual next stop displays. Valid options are:
`0` - No next stop display.
`1` - Interior displays showing the next stop.
`2` - Interior displays showing multiple upcoming stops.
`3` - The name of the station can be seen from inside the vehicle. |
+| `livery_color` | Color | Optional | Hex code of the most noticeable color of the livery. |
+| `livery` | Text | Optional | The name of the livery. |
| `decoration` | Text | Optional | A brief description of a special wrap or modification of the vehicle that is either seasonal or long term. |
From 3e8e288f9be7b4e2b3d8dc976001eaa9f8f7236e Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Fri, 28 Feb 2025 21:21:41 -0500
Subject: [PATCH 19/30] Update reference.md
---
gtfs/spec/en/reference.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index 2d733418..5ed67c54 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -927,6 +927,7 @@ This file describes the capacity, accessibility and features of individual vehic
| `accessable_boarding` | Enum | Recommended | The accommodation to allow boarding with a mobility device. Valid options are:
`0` - Not accessable.
`1` - Level boarding.
`2` - Ramp can be deployed.
`3` - Lift can be deployed. |
| `accessability_notes` | Text | Optional | Information about how to board with a mobility device and any limitations. |
| `next_stop_announcement` | Enum | Recommended | Audible next stop announcemnts. Valid options are:
`0` - No next stop announcement available.
`1` - Automatic audio next stop annoucements.
`2` - Next stop annoucements by on board staff.
`3` - Next stop annoucements on request of on board staff. |
+| `route_announcement` | Enum | Recommended | Audible route and destination announcements heard by passenger waiting at the stop. Valid options are:
`0` - No route announcement available.
`1` - Automatic audio route annoucements from the vehicle.
`2` - Automatic audio route annoucements in stations when before or when vehicles arrive.
`3` - Route annoucements by station staff. |
| `next_stop_display` | Enum | Recommended | Visual next stop displays. Valid options are:
`0` - No next stop display.
`1` - Interior displays showing the next stop.
`2` - Interior displays showing multiple upcoming stops.
`3` - The name of the station can be seen from inside the vehicle. |
| `livery_color` | Color | Optional | Hex code of the most noticeable color of the livery. |
| `livery` | Text | Optional | The name of the livery. |
From 75d552f28cb23ec5d76af8d68d587056fb4f2252 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Wed, 5 Mar 2025 20:04:12 -0500
Subject: [PATCH 20/30] Update reference.md
---
gtfs/spec/en/reference.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index 5ed67c54..5ebcf9d6 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -901,6 +901,7 @@ This file describes the capacity, accessibility and features of individual vehic
| `length` | Positive float | Optional | The length of the vehicle in meters. |
| `articulated_sections` | integer | Optional | The number of articulated sections. If there are no articulations the number should be 1. |
| `levels` | integer | Optional | The number of levels available to passengers. Only levels directly above or below other levels count, not where the height of the floor changes within the vehicle. |
+| `cab` | enum | Optional | For rail cars valid options are:
`0` - No cab in the vehicle.
`1` - In addition to a passenger area the car has a cab for controlling the train. |
| `image_url` | URL | Optional | Fully qualified URL of an image of the vehicle. The image should have as aspect ratio between 1:1 and 2:1 and a have a vertical resolution of at least 500. The image should show the front of the vehicle (except for train cars) and the side the passengers baord. The rights to the image should also free commerical reproduction of the image, for example licenced under [CC-BY](https://creativecommons.org/licenses/by/4.0/). Consumers should only download this image one time for each GTFS update and always serve it to end users themselves. End users should never be automatically downloading directly from the URL provided. |
| `image_photographer` | Text | Conditionally Required | The name of the person or organization that took the photo in the `image_url`. Required if the photo `image_url` wasn't produced by the transit agency that operates it. |
| `image_details` | URL | Optional | Fully qualified URL of an web page with more information on the photo, photographer or organation that produced the photo in the `image_url` |
From 0a51f71cd104eed1893f01511a11c18737948a3c Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Sat, 24 May 2025 18:39:39 -0400
Subject: [PATCH 21/30] Update reference.md
---
gtfs/spec/en/reference.md | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index 5ebcf9d6..15d5eb27 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -891,7 +891,7 @@ This file describes the capacity, accessibility and features of individual vehic
| ------ | ------ | ------ | ------ |
| `label` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails or the vehicle identifier in other real-time data sources. If `high_label` is provided then this value is the low end of the range. |
| `high_label` | Text | Optional | If a range of vehicles is represented this is the high end of the range. The number of charactors must be the same as `label` and range covers values with the same number of charactors and are between `label` and `high_label` when using a comparison as a string. |
-| `vehicle_class` | ID | Recommended | Identifies a class of vehicle that usually runs on certain routes. Ment to link with vehicle_class fields in routes.txt and trips.txt. When the vehicle_class does not match the class in trips.txt or routes.txt then the consumer should highlight that the vehicle type isn't what is expected and show information about the vehicle that is coming. |
+| `vehicle_class` | ID | Recommended | Identifies a class of vehicle that usually runs on certain routes. Ment to link with vehicle_class fields in routes.txt and trips.txt. Can be used to provide vehicle information when label isn't available or highlight when the vehicle doesn't match the expected class and what the major differences are. |
| `depot` | Text | Optional | The name of the facility where the vehicle is normally stored when not in service, such as the bus garage or rail yard. |
| `vehicle_type` | Text | Recommended | Should be one of the two character codes in the Vehicle Type column on the Reference Sheet tab in [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administration or a one or two word description of the type of vehicle. Examples:
`BU` - Bus
`LR` - Light Rail Vehicle
`RP` - Commuter Rail Passenger Coach |
| `manufacturer` | Text | Optional | The name of the company that manufactured the vehicle. |
@@ -922,6 +922,7 @@ This file describes the capacity, accessibility and features of individual vehic
| `usbc_plugs` | integer | Optional | USB-C ports for charging devices available to passengers.
Empty - No information on availability.
`0` - No USB-C ports available.
`1` - An unknown number of USB-C ports available.
Other number - the number of USB-C ports available to passengers. |
| `wifi` | Enum | Optional | Valid options are:
`0` - No WiFi available to passengers.
`1` - Internet access through WiFi with no requirements beyond agreeing to the terms of service.
`2` - Internet access available through WiFi but requires creating a free account.
`3` - Internet access available through WiFi for a fee. |
| `wifi_notes` | Text | Optional | Description of how the access the Internet through WiFi and any limitations it has. |
+| `food` | Enum | Optional | The type of food available. Valid options are:
`0` - No food available.
`1` - Unstaff vending machines with drinks or snacks
`2` - Staffed cafe with snacks and hot and cold drinks
`3` - Staffed cafe with warmed food and hot and cold drinks
`4` - Restraunt service with waiters that bring food to your table. |
| `doors` | integer | Optional | The number of doors on each side. If there are doors on both sides of the vehicle, provide the number of doors per side. |
| `boarding_type` | Enum | Recommended | Valid options are:
`1` - High platform level boarding
`2` - Low platform level boarding
`3` - One or more steps are required to board.
`4` - Level boarding at some stations |
| `boarding_steps` | integer | Optional | Number of steps require to board where there is no level boarding. |
From 9c62d46c1e656f1985f3c6bbd08ce22ae6c86755 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Sat, 24 May 2025 18:41:36 -0400
Subject: [PATCH 22/30] Update reference.md
---
gtfs/spec/en/reference.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index 15d5eb27..ea1c9776 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -922,7 +922,7 @@ This file describes the capacity, accessibility and features of individual vehic
| `usbc_plugs` | integer | Optional | USB-C ports for charging devices available to passengers.
Empty - No information on availability.
`0` - No USB-C ports available.
`1` - An unknown number of USB-C ports available.
Other number - the number of USB-C ports available to passengers. |
| `wifi` | Enum | Optional | Valid options are:
`0` - No WiFi available to passengers.
`1` - Internet access through WiFi with no requirements beyond agreeing to the terms of service.
`2` - Internet access available through WiFi but requires creating a free account.
`3` - Internet access available through WiFi for a fee. |
| `wifi_notes` | Text | Optional | Description of how the access the Internet through WiFi and any limitations it has. |
-| `food` | Enum | Optional | The type of food available. Valid options are:
`0` - No food available.
`1` - Unstaff vending machines with drinks or snacks
`2` - Staffed cafe with snacks and hot and cold drinks
`3` - Staffed cafe with warmed food and hot and cold drinks
`4` - Restraunt service with waiters that bring food to your table. |
+| `food` | Enum | Optional | The type of food available. Valid options are:
`0` - No food available.
`1` - Unstaff vending machines with drinks or snacks
`2` - Staffed cafe with snacks and hot and cold drinks
`3` - Staffed cafe with warmed food and hot and cold drinks
`4` - Table service with waiters that bring food to your table. |
| `doors` | integer | Optional | The number of doors on each side. If there are doors on both sides of the vehicle, provide the number of doors per side. |
| `boarding_type` | Enum | Recommended | Valid options are:
`1` - High platform level boarding
`2` - Low platform level boarding
`3` - One or more steps are required to board.
`4` - Level boarding at some stations |
| `boarding_steps` | integer | Optional | Number of steps require to board where there is no level boarding. |
From 8f0973382154b9d70b743075fd31a95942473ee5 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Sat, 24 May 2025 20:34:48 -0400
Subject: [PATCH 23/30] Update reference.md
---
gtfs/spec/en/reference.md | 18 +++++++++---------
1 file changed, 9 insertions(+), 9 deletions(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index ea1c9776..6bea34cf 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -910,13 +910,13 @@ This file describes the capacity, accessibility and features of individual vehic
| `full_load` | integer | Recommended | The number of passengers that is considered a full load for a vehicle. If passenger occupancy is provided, this should be the number of passengers that is considered Full or 100%. |
| `wheelchairs` | integer | Recommended | The number of spots available for passingers with wheelchairs. |
| `strollers` | integer | Optional | The number of spots available for strollers. Would include spots used by wheelchairs or strollers. |
-| `bicycles ` | integer | Recommended | The number of bicycles the vehicle can carry, either on the inside or outside of the vehicle. |
+| `bicycles` | integer | Recommended | The number of bicycles the vehicle can carry, either on the inside or outside of the vehicle. |
| `bicycle_notes` | Text | Optional | A decription of the location, procedures and restriction of bringing a bicycle on the vehicle. |
| `luggage` | Enum | Optional | The vehicle has space set aside for luggage. Valid options are:
`0` - No space set aside for luggage.
`1` - Space above passenger seating for luggage.
`2` - Space set aside in the passenger cabin for luggage.
`3` - Space for luggage that can be accessed externally. |
| `luggage_notes` | Text | Optional | A description of how luggage is stored and any limitations that may apply. |
-| `restrooms` | integer | Optional | The number of restrooms in the vehicle, including any accessable restrooms. |
-| `accessable_restrooms` | integer | Optional | The number of accessable restrooms in the vehicle. |
-| `air_conditioned` | Enum | Optional | Valid options are:
`0` - No air conditioning provided.
`1` - The vehicle has air conditioning. |
+| `restrooms` | integer | Optional | The number of restrooms in the vehicle, including any accessible restrooms. |
+| `accessible_restrooms` | integer | Optional | The number of accessible restrooms in the vehicle. |
+| `air_conditioning` | Enum | Optional | Valid options are:
`0` - No air conditioning provided.
`1` - The vehicle has air conditioning. |
| `ac_plugs` | integer | Optional | AC power plugs that follow the local standard that are available to passengers.
Empty - No information on availability.
`0` - No AC power plugs available.
`1` - An unknown number of AC power plugs available.
Other number - the number of AC power plugs available to passengers. |
| `usba_plugs` | integer | Optional | USB-A ports for charging devices available to passengers.
Empty - No information on availability.
`0` - No USB-A ports available.
`1` - An unknown number of USB-A ports available.
Other number - the number of USB-A ports available to passengers. |
| `usbc_plugs` | integer | Optional | USB-C ports for charging devices available to passengers.
Empty - No information on availability.
`0` - No USB-C ports available.
`1` - An unknown number of USB-C ports available.
Other number - the number of USB-C ports available to passengers. |
@@ -926,11 +926,11 @@ This file describes the capacity, accessibility and features of individual vehic
| `doors` | integer | Optional | The number of doors on each side. If there are doors on both sides of the vehicle, provide the number of doors per side. |
| `boarding_type` | Enum | Recommended | Valid options are:
`1` - High platform level boarding
`2` - Low platform level boarding
`3` - One or more steps are required to board.
`4` - Level boarding at some stations |
| `boarding_steps` | integer | Optional | Number of steps require to board where there is no level boarding. |
-| `accessable_boarding` | Enum | Recommended | The accommodation to allow boarding with a mobility device. Valid options are:
`0` - Not accessable.
`1` - Level boarding.
`2` - Ramp can be deployed.
`3` - Lift can be deployed. |
-| `accessability_notes` | Text | Optional | Information about how to board with a mobility device and any limitations. |
-| `next_stop_announcement` | Enum | Recommended | Audible next stop announcemnts. Valid options are:
`0` - No next stop announcement available.
`1` - Automatic audio next stop annoucements.
`2` - Next stop annoucements by on board staff.
`3` - Next stop annoucements on request of on board staff. |
-| `route_announcement` | Enum | Recommended | Audible route and destination announcements heard by passenger waiting at the stop. Valid options are:
`0` - No route announcement available.
`1` - Automatic audio route annoucements from the vehicle.
`2` - Automatic audio route annoucements in stations when before or when vehicles arrive.
`3` - Route annoucements by station staff. |
-| `next_stop_display` | Enum | Recommended | Visual next stop displays. Valid options are:
`0` - No next stop display.
`1` - Interior displays showing the next stop.
`2` - Interior displays showing multiple upcoming stops.
`3` - The name of the station can be seen from inside the vehicle. |
+| `accessible_boarding` | Enum | Recommended | The accommodation to allow boarding with a mobility device. Valid options are:
`0` - Not accessible.
`1` - Level boarding.
`2` - Ramp can be deployed.
`3` - Lift can be deployed. |
+| `accessibility_notes` | Text | Optional | Information about how to board with a mobility device and any limitations. |
+| `stop_announcements` | Enum | Recommended | Audible next stop announcemnts. Valid options are:
`0` - No next stop announcement available.
`1` - Automatic audio next stop annoucements.
`2` - Next stop annoucements by on board staff.
`3` - Next stop annoucements on request of on board staff. |
+| `route_announcements` | Enum | Recommended | Audible route and destination announcements heard by passenger waiting at the stop. Valid options are:
`0` - No route announcement available.
`1` - Automatic audio route annoucements from the vehicle.
`2` - Automatic audio route annoucements in stations when before or when vehicles arrive.
`3` - Route annoucements by station staff. |
+| `stop_displays` | Enum | Recommended | Visual next stop displays. Valid options are:
`0` - No next stop display.
`1` - Interior displays showing the next stop.
`2` - Interior displays showing multiple upcoming stops.
`3` - The name of the station can be seen from inside the vehicle. |
| `livery_color` | Color | Optional | Hex code of the most noticeable color of the livery. |
| `livery` | Text | Optional | The name of the livery. |
| `decoration` | Text | Optional | A brief description of a special wrap or modification of the vehicle that is either seasonal or long term. |
From 701298694ac6fa5b77bc8c215ca84781c4522215 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Wed, 28 May 2025 19:45:33 -0400
Subject: [PATCH 24/30] Update reference.md
---
gtfs/spec/en/reference.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index 6bea34cf..03f4c570 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -922,7 +922,7 @@ This file describes the capacity, accessibility and features of individual vehic
| `usbc_plugs` | integer | Optional | USB-C ports for charging devices available to passengers.
Empty - No information on availability.
`0` - No USB-C ports available.
`1` - An unknown number of USB-C ports available.
Other number - the number of USB-C ports available to passengers. |
| `wifi` | Enum | Optional | Valid options are:
`0` - No WiFi available to passengers.
`1` - Internet access through WiFi with no requirements beyond agreeing to the terms of service.
`2` - Internet access available through WiFi but requires creating a free account.
`3` - Internet access available through WiFi for a fee. |
| `wifi_notes` | Text | Optional | Description of how the access the Internet through WiFi and any limitations it has. |
-| `food` | Enum | Optional | The type of food available. Valid options are:
`0` - No food available.
`1` - Unstaff vending machines with drinks or snacks
`2` - Staffed cafe with snacks and hot and cold drinks
`3` - Staffed cafe with warmed food and hot and cold drinks
`4` - Table service with waiters that bring food to your table. |
+| `food` | Enum | Optional | The type of food available. Valid options are:
`0` - No food available.
`1` - Unstaff vending machines with drinks or snacks.
`2` - Staffed cafe with snacks and hot and cold drinks.
`3` - Staffed cafe with warmed food and hot and cold drinks.
`4` - Food trolley with drinks and snakes brought to your seat.
`5` - Table service with waiters that bring food to your table. |
| `doors` | integer | Optional | The number of doors on each side. If there are doors on both sides of the vehicle, provide the number of doors per side. |
| `boarding_type` | Enum | Recommended | Valid options are:
`1` - High platform level boarding
`2` - Low platform level boarding
`3` - One or more steps are required to board.
`4` - Level boarding at some stations |
| `boarding_steps` | integer | Optional | Number of steps require to board where there is no level boarding. |
From abf84bfaf87e91f278686c26259c17b3f06c3a61 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Sat, 7 Feb 2026 20:49:35 -0500
Subject: [PATCH 25/30] Update reference.md
---
gtfs/spec/en/reference.md | 2 ++
1 file changed, 2 insertions(+)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index 03f4c570..8b31509f 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -912,6 +912,7 @@ This file describes the capacity, accessibility and features of individual vehic
| `strollers` | integer | Optional | The number of spots available for strollers. Would include spots used by wheelchairs or strollers. |
| `bicycles` | integer | Recommended | The number of bicycles the vehicle can carry, either on the inside or outside of the vehicle. |
| `bicycle_notes` | Text | Optional | A decription of the location, procedures and restriction of bringing a bicycle on the vehicle. |
+| `car_capacity` | integer | Optional | The number of standard size cars the vehicle can carry. Primarily for farries. |
| `luggage` | Enum | Optional | The vehicle has space set aside for luggage. Valid options are:
`0` - No space set aside for luggage.
`1` - Space above passenger seating for luggage.
`2` - Space set aside in the passenger cabin for luggage.
`3` - Space for luggage that can be accessed externally. |
| `luggage_notes` | Text | Optional | A description of how luggage is stored and any limitations that may apply. |
| `restrooms` | integer | Optional | The number of restrooms in the vehicle, including any accessible restrooms. |
@@ -933,4 +934,5 @@ This file describes the capacity, accessibility and features of individual vehic
| `stop_displays` | Enum | Recommended | Visual next stop displays. Valid options are:
`0` - No next stop display.
`1` - Interior displays showing the next stop.
`2` - Interior displays showing multiple upcoming stops.
`3` - The name of the station can be seen from inside the vehicle. |
| `livery_color` | Color | Optional | Hex code of the most noticeable color of the livery. |
| `livery` | Text | Optional | The name of the livery. |
+| `nick_name` | Text | Optional | The name for the specific vehicle, such as the name of a ferry or some passenger rail cars that have names. |
| `decoration` | Text | Optional | A brief description of a special wrap or modification of the vehicle that is either seasonal or long term. |
From 59daa8671e4e5e26c45517b19f6806bb13900eb7 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Sat, 7 Feb 2026 20:55:57 -0500
Subject: [PATCH 26/30] Update reference.md
---
gtfs/spec/en/reference.md | 1 +
1 file changed, 1 insertion(+)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index 8b31509f..f57702a8 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -891,6 +891,7 @@ This file describes the capacity, accessibility and features of individual vehic
| ------ | ------ | ------ | ------ |
| `label` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails or the vehicle identifier in other real-time data sources. If `high_label` is provided then this value is the low end of the range. |
| `high_label` | Text | Optional | If a range of vehicles is represented this is the high end of the range. The number of charactors must be the same as `label` and range covers values with the same number of charactors and are between `label` and `high_label` when using a comparison as a string. |
+| `registration_plate` | Text | Optional | The license plate or number plate of the vehicle. |
| `vehicle_class` | ID | Recommended | Identifies a class of vehicle that usually runs on certain routes. Ment to link with vehicle_class fields in routes.txt and trips.txt. Can be used to provide vehicle information when label isn't available or highlight when the vehicle doesn't match the expected class and what the major differences are. |
| `depot` | Text | Optional | The name of the facility where the vehicle is normally stored when not in service, such as the bus garage or rail yard. |
| `vehicle_type` | Text | Recommended | Should be one of the two character codes in the Vehicle Type column on the Reference Sheet tab in [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administration or a one or two word description of the type of vehicle. Examples:
`BU` - Bus
`LR` - Light Rail Vehicle
`RP` - Commuter Rail Passenger Coach |
From 7725d9609fa445681e9e1ccf1eb356e839641699 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Sun, 10 May 2026 19:38:18 -0400
Subject: [PATCH 27/30] Change to match TIDES vehicles.txt
---
gtfs/spec/en/reference.md | 16 ++++++++--------
1 file changed, 8 insertions(+), 8 deletions(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index f57702a8..16bd9025 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -889,14 +889,14 @@ This file describes the capacity, accessibility and features of individual vehic
| Field Name | Type | Presence | Description |
| ------ | ------ | ------ | ------ |
-| `label` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails or the vehicle identifier in other real-time data sources. If `high_label` is provided then this value is the low end of the range. |
-| `high_label` | Text | Optional | If a range of vehicles is represented this is the high end of the range. The number of charactors must be the same as `label` and range covers values with the same number of charactors and are between `label` and `high_label` when using a comparison as a string. |
+| `vehicle_id` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails or the vehicle identifier in other real-time data sources. If `vehicle_id_high` is provided then this value is the low end of the range. |
+| `vehicle_id_high` | Text | Optional | If a range of vehicles is represented this is the high end of the range. The number of charactors must be the same as `vehicle_id` and range covers values with the same number of charactors and are between `vehicle_id` and `vehicle_id_high` when using a string comparison. |
| `registration_plate` | Text | Optional | The license plate or number plate of the vehicle. |
| `vehicle_class` | ID | Recommended | Identifies a class of vehicle that usually runs on certain routes. Ment to link with vehicle_class fields in routes.txt and trips.txt. Can be used to provide vehicle information when label isn't available or highlight when the vehicle doesn't match the expected class and what the major differences are. |
-| `depot` | Text | Optional | The name of the facility where the vehicle is normally stored when not in service, such as the bus garage or rail yard. |
+| `facility_name` | Text | Optional | The name of the facility where the vehicle is normally stored when not in service, such as the bus garage or rail yard. |
| `vehicle_type` | Text | Recommended | Should be one of the two character codes in the Vehicle Type column on the Reference Sheet tab in [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administration or a one or two word description of the type of vehicle. Examples:
`BU` - Bus
`LR` - Light Rail Vehicle
`RP` - Commuter Rail Passenger Coach |
| `manufacturer` | Text | Optional | The name of the company that manufactured the vehicle. |
-| `model` | Text | Optional | The name of the vehicle model. |
+| `model_name` | Text | Optional | The name of the vehicle model. |
| `year_manufactured` | Year | Optional | The year the vehicle was manufactured. If a range of vehicles is represented, the earliest year should be used. |
| `fuel_type` | Text | Optional | The type of fuel used to provide energy for propulsion. It should be from the list of Fuel Types column on the Reference Sheet tab in [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administration. Examples include `Diesel Fuel`, `Hybrid Diesel`, `Electric Propulsion Power` and `Electric Battery`.|
| `length` | Positive float | Optional | The length of the vehicle in meters. |
@@ -907,11 +907,11 @@ This file describes the capacity, accessibility and features of individual vehic
| `image_photographer` | Text | Conditionally Required | The name of the person or organization that took the photo in the `image_url`. Required if the photo `image_url` wasn't produced by the transit agency that operates it. |
| `image_details` | URL | Optional | Fully qualified URL of an web page with more information on the photo, photographer or organation that produced the photo in the `image_url` |
| `vehicle_notes` | Text | Optional | Notable aspects about the vehicles that passengers should know about not covered by other fields. |
-| `seating` | integer | Optional | The number of seats available to passengers, including ones that may become unavailable due to making space for wheelchairs or bikes. |
-| `full_load` | integer | Recommended | The number of passengers that is considered a full load for a vehicle. If passenger occupancy is provided, this should be the number of passengers that is considered Full or 100%. |
-| `wheelchairs` | integer | Recommended | The number of spots available for passingers with wheelchairs. |
+| `capacity_seated` | integer | Optional | The number of seats available to passengers, including ones that may become unavailable due to making space for wheelchairs or bikes. |
+| `capacity_standing` | integer | Recommended | The number of passengers that is considered a full load for a vehicle. If passenger occupancy is provided, this should be the number of passengers that is considered Full or 100%. |
+| `capacity_wheelchair` | integer | Recommended | The number of spots available for passingers with wheelchairs. |
| `strollers` | integer | Optional | The number of spots available for strollers. Would include spots used by wheelchairs or strollers. |
-| `bicycles` | integer | Recommended | The number of bicycles the vehicle can carry, either on the inside or outside of the vehicle. |
+| `capacity_bike` | integer | Recommended | The number of bicycles the vehicle can carry, either on the inside or outside of the vehicle. |
| `bicycle_notes` | Text | Optional | A decription of the location, procedures and restriction of bringing a bicycle on the vehicle. |
| `car_capacity` | integer | Optional | The number of standard size cars the vehicle can carry. Primarily for farries. |
| `luggage` | Enum | Optional | The vehicle has space set aside for luggage. Valid options are:
`0` - No space set aside for luggage.
`1` - Space above passenger seating for luggage.
`2` - Space set aside in the passenger cabin for luggage.
`3` - Space for luggage that can be accessed externally. |
From e4200c83350f38cf4908cc154bde0a1597c0caa4 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Tue, 12 May 2026 21:13:33 -0400
Subject: [PATCH 28/30] Vehicle field name changes
---
gtfs/spec/en/reference.md | 14 +++++++-------
1 file changed, 7 insertions(+), 7 deletions(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index bd5fda64..d323effc 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -923,8 +923,8 @@ This file describes the capacity, accessibility and features of individual vehic
| Field Name | Type | Presence | Description |
| ------ | ------ | ------ | ------ |
-| `vehicle_id` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails or the vehicle identifier in other real-time data sources. If `vehicle_id_high` is provided then this value is the low end of the range. |
-| `vehicle_id_high` | Text | Optional | If a range of vehicles is represented this is the high end of the range. The number of charactors must be the same as `vehicle_id` and range covers values with the same number of charactors and are between `vehicle_id` and `vehicle_id_high` when using a string comparison. |
+| `vehicle_label` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails or the vehicle identifier in other real-time data sources. If `vehicle_id_high` is provided then this value is the low end of the range. |
+| `vehicle_label_high` | Text | Optional | If a range of vehicles is represented this is the high end of the range. The number of charactors must be the same as `vehicle_id` and range covers values with the same number of charactors and are between `vehicle_id` and `vehicle_id_high` when using a string comparison. |
| `registration_plate` | Text | Optional | The license plate or number plate of the vehicle. |
| `vehicle_class` | ID | Recommended | Identifies a class of vehicle that usually runs on certain routes. Ment to link with vehicle_class fields in routes.txt and trips.txt. Can be used to provide vehicle information when label isn't available or highlight when the vehicle doesn't match the expected class and what the major differences are. |
| `facility_name` | Text | Optional | The name of the facility where the vehicle is normally stored when not in service, such as the bus garage or rail yard. |
@@ -942,11 +942,11 @@ This file describes the capacity, accessibility and features of individual vehic
| `image_details` | URL | Optional | Fully qualified URL of an web page with more information on the photo, photographer or organation that produced the photo in the `image_url` |
| `vehicle_notes` | Text | Optional | Notable aspects about the vehicles that passengers should know about not covered by other fields. |
| `capacity_seated` | integer | Optional | The number of seats available to passengers, including ones that may become unavailable due to making space for wheelchairs or bikes. |
-| `capacity_standing` | integer | Recommended | The number of passengers that is considered a full load for a vehicle. If passenger occupancy is provided, this should be the number of passengers that is considered Full or 100%. |
-| `capacity_wheelchair` | integer | Recommended | The number of spots available for passingers with wheelchairs. |
-| `strollers` | integer | Optional | The number of spots available for strollers. Would include spots used by wheelchairs or strollers. |
-| `capacity_bike` | integer | Recommended | The number of bicycles the vehicle can carry, either on the inside or outside of the vehicle. |
-| `bicycle_notes` | Text | Optional | A decription of the location, procedures and restriction of bringing a bicycle on the vehicle. |
+| `capacity_full` | integer | Recommended | The number of passengers that is considered a full load for a vehicle. If passenger occupancy is provided, this should be the number of passengers that is considered Full or 100%. |
+| `capacity_wheelchairs` | integer | Recommended | The number of spots available for passingers with wheelchairs. |
+| `capacity_strollers` | integer | Optional | The number of spots available for strollers. Would include spots used by wheelchairs or strollers. |
+| `capacity_bikes` | integer | Recommended | The number of bicycles the vehicle can carry, either on the inside or outside of the vehicle. |
+| `bike_notes` | Text | Optional | A decription of the location, procedures and restriction of bringing a bicycle on the vehicle. |
| `car_capacity` | integer | Optional | The number of standard size cars the vehicle can carry. Primarily for farries. |
| `luggage` | Enum | Optional | The vehicle has space set aside for luggage. Valid options are:
`0` - No space set aside for luggage.
`1` - Space above passenger seating for luggage.
`2` - Space set aside in the passenger cabin for luggage.
`3` - Space for luggage that can be accessed externally. |
| `luggage_notes` | Text | Optional | A description of how luggage is stored and any limitations that may apply. |
From dbbc550295c69525444fa7b274f059387980d5fc Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Tue, 12 May 2026 21:28:00 -0400
Subject: [PATCH 29/30] Update vehicle field
---
gtfs/spec/en/reference.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index d323effc..698ef402 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -925,7 +925,7 @@ This file describes the capacity, accessibility and features of individual vehic
| ------ | ------ | ------ | ------ |
| `vehicle_label` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails or the vehicle identifier in other real-time data sources. If `vehicle_id_high` is provided then this value is the low end of the range. |
| `vehicle_label_high` | Text | Optional | If a range of vehicles is represented this is the high end of the range. The number of charactors must be the same as `vehicle_id` and range covers values with the same number of charactors and are between `vehicle_id` and `vehicle_id_high` when using a string comparison. |
-| `registration_plate` | Text | Optional | The license plate or number plate of the vehicle. |
+| `license_plate` | Text | Optional | The license plate or number plate of the vehicle. |
| `vehicle_class` | ID | Recommended | Identifies a class of vehicle that usually runs on certain routes. Ment to link with vehicle_class fields in routes.txt and trips.txt. Can be used to provide vehicle information when label isn't available or highlight when the vehicle doesn't match the expected class and what the major differences are. |
| `facility_name` | Text | Optional | The name of the facility where the vehicle is normally stored when not in service, such as the bus garage or rail yard. |
| `vehicle_type` | Text | Recommended | Should be one of the two character codes in the Vehicle Type column on the Reference Sheet tab in [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administration or a one or two word description of the type of vehicle. Examples:
`BU` - Bus
`LR` - Light Rail Vehicle
`RP` - Commuter Rail Passenger Coach |
From c3749f4305b8904564fdfb4e5d1b8acffab2c1a1 Mon Sep 17 00:00:00 2001
From: Darwin O'Connor - TransSee
<36251661+doconnoronca@users.noreply.github.com>
Date: Tue, 12 May 2026 21:37:32 -0400
Subject: [PATCH 30/30] Fixes
---
gtfs/spec/en/reference.md | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
diff --git a/gtfs/spec/en/reference.md b/gtfs/spec/en/reference.md
index 698ef402..c2498a01 100644
--- a/gtfs/spec/en/reference.md
+++ b/gtfs/spec/en/reference.md
@@ -923,9 +923,9 @@ This file describes the capacity, accessibility and features of individual vehic
| Field Name | Type | Presence | Description |
| ------ | ------ | ------ | ------ |
-| `vehicle_label` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails or the vehicle identifier in other real-time data sources. If `vehicle_id_high` is provided then this value is the low end of the range. |
-| `vehicle_label_high` | Text | Optional | If a range of vehicles is represented this is the high end of the range. The number of charactors must be the same as `vehicle_id` and range covers values with the same number of charactors and are between `vehicle_id` and `vehicle_id_high` when using a string comparison. |
-| `license_plate` | Text | Optional | The license plate or number plate of the vehicle. |
+| `vehicle_label` | Text | **Required** | A label that is unique to the vehicle and matches the label shown in the GTFS RealTime label value in the VehicleDescriptor or CarriageDetails or the vehicle identifier in other real-time data sources. If `vehicle_label_high` is provided then this value is the low end of the range. |
+| `vehicle_label_high` | Text | Optional | If a range of vehicles is represented this is the high end of the range. The number of charactors must be the same as `vehicle_label` and range covers values with the same number of charactors and are between `vehicle_label` and `vehicle_label_high` when using a string comparison. |
+| `license_plate` | Text | Optional | The license plate or number plate of the vehicle. Does not apply if a range of vehicles is being used. |
| `vehicle_class` | ID | Recommended | Identifies a class of vehicle that usually runs on certain routes. Ment to link with vehicle_class fields in routes.txt and trips.txt. Can be used to provide vehicle information when label isn't available or highlight when the vehicle doesn't match the expected class and what the major differences are. |
| `facility_name` | Text | Optional | The name of the facility where the vehicle is normally stored when not in service, such as the bus garage or rail yard. |
| `vehicle_type` | Text | Recommended | Should be one of the two character codes in the Vehicle Type column on the Reference Sheet tab in [A-30 Template](https://www.transit.dot.gov/ntd/30-template) from the US Federal Transit Administration or a one or two word description of the type of vehicle. Examples:
`BU` - Bus
`LR` - Light Rail Vehicle
`RP` - Commuter Rail Passenger Coach |
@@ -958,7 +958,7 @@ This file describes the capacity, accessibility and features of individual vehic
| `usbc_plugs` | integer | Optional | USB-C ports for charging devices available to passengers.
Empty - No information on availability.
`0` - No USB-C ports available.
`1` - An unknown number of USB-C ports available.
Other number - the number of USB-C ports available to passengers. |
| `wifi` | Enum | Optional | Valid options are:
`0` - No WiFi available to passengers.
`1` - Internet access through WiFi with no requirements beyond agreeing to the terms of service.
`2` - Internet access available through WiFi but requires creating a free account.
`3` - Internet access available through WiFi for a fee. |
| `wifi_notes` | Text | Optional | Description of how the access the Internet through WiFi and any limitations it has. |
-| `food` | Enum | Optional | The type of food available. Valid options are:
`0` - No food available.
`1` - Unstaff vending machines with drinks or snacks.
`2` - Staffed cafe with snacks and hot and cold drinks.
`3` - Staffed cafe with warmed food and hot and cold drinks.
`4` - Food trolley with drinks and snakes brought to your seat.
`5` - Table service with waiters that bring food to your table. |
+| `food` | Enum | Optional | The type of food available. Valid options are:
`0` - No food available.
`1` - Unstaffed vending machines with drinks or snacks.
`2` - Staffed cafe with snacks and hot and cold drinks.
`3` - Staffed cafe with warmed food and hot and cold drinks.
`4` - Food trolley with drinks and snakes brought to your seat.
`5` - Table service with waiters that bring food to your table. |
| `doors` | integer | Optional | The number of doors on each side. If there are doors on both sides of the vehicle, provide the number of doors per side. |
| `boarding_type` | Enum | Recommended | Valid options are:
`1` - High platform level boarding
`2` - Low platform level boarding
`3` - One or more steps are required to board.
`4` - Level boarding at some stations |
| `boarding_steps` | integer | Optional | Number of steps require to board where there is no level boarding. |