From 4727b203d1a7d9efdf0e525d653dc41cc3c85b0d Mon Sep 17 00:00:00 2001 From: Guillaume Campagna Date: Wed, 8 Apr 2020 16:48:06 -0400 Subject: [PATCH 01/11] Simplify enum for occupancy, add occupancy_percentage --- gtfs-realtime/proto/gtfs-realtime.proto | 27 ++++++++++++++----------- gtfs-realtime/spec/en/reference.md | 15 +++++--------- 2 files changed, 20 insertions(+), 22 deletions(-) diff --git a/gtfs-realtime/proto/gtfs-realtime.proto b/gtfs-realtime/proto/gtfs-realtime.proto index 41858294d..9d4fbc531 100644 --- a/gtfs-realtime/proto/gtfs-realtime.proto +++ b/gtfs-realtime/proto/gtfs-realtime.proto @@ -347,43 +347,46 @@ message VehiclePosition { } optional CongestionLevel congestion_level = 6; - // The degree of passenger occupancy of the vehicle. This field is still - // experimental, and subject to change. It may be formally adopted in the - // future. + // The degree of passenger occupancy of the vehicle enum OccupancyStatus { // The vehicle is considered empty by most measures, and has few or no // passengers onboard, but is still accepting passengers. - EMPTY = 0; + EMPTY = 0 [deprecated=true]; - // The vehicle has a relatively large percentage of seats available. - // What percentage of free seats out of the total seats available is to be - // considered large enough to fall into this category is determined at the - // discretion of the producer. - MANY_SEATS_AVAILABLE = 1; + // The vehicle has seats available. + SEATS_AVAILABLE = 1; // The vehicle has a relatively small percentage of seats available. // What percentage of free seats out of the total seats available is to be // considered small enough to fall into this category is determined at the // discretion of the feed producer. - FEW_SEATS_AVAILABLE = 2; + // Deprecated, if you need more granularity than the available enum please use occupancy_percentage + FEW_SEATS_AVAILABLE = 2 [deprecated=true]; // The vehicle can currently accommodate only standing passengers. STANDING_ROOM_ONLY = 3; // The vehicle can currently accommodate only standing passengers // and has limited space for them. - CRUSHED_STANDING_ROOM_ONLY = 4; + // Deprecated, if you need more granularity than the available enum please use occupancy_percentage + CRUSHED_STANDING_ROOM_ONLY = 4 [deprecated=true]; // The vehicle is considered full by most measures, but may still be // allowing passengers to board. FULL = 5; // The vehicle is not accepting additional passengers. - NOT_ACCEPTING_PASSENGERS = 6; + // Deprecated, if you need more granularity than the available enum please use occupancy_percentage + NOT_ACCEPTING_PASSENGERS = 6 [deprecated=true]; } optional OccupancyStatus occupancy_status = 9; + // A percentage value representing the degree of passenger occupancy of the vehicle. + // The value 100 should represent total the maximum occupancy the vehicle was designed for. + // It's not impossible that the value goes over 100 if there are currently more passenger than the vehicle was designed for. + optional OccupancyStatus occupancy_percentage = 10; + // The extensions namespace allows 3rd-party developers to extend the // GTFS Realtime Specification in order to add and evaluate new features and // modifications to the spec. diff --git a/gtfs-realtime/spec/en/reference.md b/gtfs-realtime/spec/en/reference.md index d6f445ec1..1d7d5b045 100644 --- a/gtfs-realtime/spec/en/reference.md +++ b/gtfs-realtime/spec/en/reference.md @@ -207,7 +207,8 @@ Realtime positioning information for a given vehicle. | **current_status** | [VehicleStopStatus](#enum-vehiclestopstatus) | Optional | One | The exact status of the vehicle with respect to the current stop. Ignored if current_stop_sequence is missing. | | **timestamp** | [uint64](https://developers.google.com/protocol-buffers/docs/proto#scalar) | Optional | One | Moment at which the vehicle's position was measured. In POSIX time (i.e., number of seconds since January 1st 1970 00:00:00 UTC). | | **congestion_level** | [CongestionLevel](#enum-congestionlevel) | Optional | One | -| _**occupancy_status**_ | _[OccupancyStatus](#enum-occupancystatus)_ | _Optional_ | One | The degree of passenger occupancy of the vehicle.
**Caution:** this field is still **experimental**, and subject to change. It may be formally adopted in the future.| +| **occupancy_status** | [OccupancyStatus](#enum-occupancystatus) | Optional | One | The degree of passenger occupancy of the vehicle. More detail can be provided with _occupancy_percentage_. | +| **occupancy_percentage** | [uint32](https://developers.google.com/protocol-buffers/docs/proto#scalar) | Optionals | One | A percentage value representing the degree of passenger occupancy of the vehicle. The value 100 should represent total the maximum occupancy the vehicle was designed for. It's not impossible that the value goes over 100 if there are currently more passenger than the vehicle was designed for. | ## _enum_ VehicleStopStatus @@ -235,21 +236,15 @@ Congestion level that is affecting this vehicle. ## _enum OccupancyStatus_ -The degree of passenger occupancy for the vehicle. - -**Caution:** this field is still **experimental**, and subject to change. It may be formally adopted in the future. +The degree of passenger occupancy for the vehicle. OccupancyStatus should be used to display a textual or #### _Values_ | _**Value**_ | _**Comment**_ | |-------------|---------------| -| _**EMPTY**_ | _The vehicle is considered empty by most measures, and has few or no passengers onboard, but is still accepting passengers._ | -| _**MANY_SEATS_AVAILABLE**_ | _The vehicle has a large percentage of seats available. What percentage of free seats out of the total seats available is to be considered large enough to fall into this category is determined at the discretion of the producer._ | -| _**FEW_SEATS_AVAILABLE**_ | _The vehicle has a small percentage of seats available. What percentage of free seats out of the total seats available is to be considered small enough to fall into this category is determined at the discretion of the producer._ | +| _**SEATS_AVAILABLE**_ | _The vehicle has seats available._ | | _**STANDING_ROOM_ONLY**_ | _The vehicle can currently accommodate only standing passengers._ | -| _**CRUSHED_STANDING_ROOM_ONLY**_ | _The vehicle can currently accommodate only standing passengers and has limited space for them._ | | _**FULL**_ | _The vehicle is considered full by most measures, but may still be allowing passengers to board._ | -| _**NOT_ACCEPTING_PASSENGERS**_ | _The vehicle can not accept passengers._ | ## _message_ Alert @@ -359,7 +354,7 @@ To specify a single trip instance, in many cases a `trip_id` by itself is suffic * If the trip lasts for more than 24 hours, or is delayed such that it would collide with a scheduled trip on the following day, then `start_date` is required in addition to `trip_id` * If the `trip_id` field can't be provided, then `route_id`, `direction_id`, `start_date`, and `start_time` must all be provided -In all cases, if `route_id` is provided in addition to `trip_id`, then the `route_id` must be the same `route_id` as assigned to the given trip in GTFS trips.txt. +In all cases, if `route_id` is provided in addition to `trip_id`, then the `route_id` must be the same `route_id` as assigned to the given trip in GTFS trips.txt. The `trip_id` field cannot, by itself or in combination with other TripDescriptor fields, be used to identify multiple trip instances. For example, a TripDescriptor should never specify trip_id by itself for GTFS frequencies.txt exact_times=0 trips because start_time is also required to resolve to a single trip instance starting at a specific time of the day. If the TripDescriptor does not resolve to a single trip instance (i.e., it resolves to zero or multiple trip instances), it is considered an error and the entity containing the erroneous TripDescriptor may be discarded by consumers. From 58822d41777c2fabfaaa2e90d0850c5d9776353c Mon Sep 17 00:00:00 2001 From: Guillaume Campagna Date: Wed, 8 Apr 2020 16:49:38 -0400 Subject: [PATCH 02/11] Fix typo --- gtfs-realtime/spec/en/reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gtfs-realtime/spec/en/reference.md b/gtfs-realtime/spec/en/reference.md index 1d7d5b045..157271036 100644 --- a/gtfs-realtime/spec/en/reference.md +++ b/gtfs-realtime/spec/en/reference.md @@ -208,7 +208,7 @@ Realtime positioning information for a given vehicle. | **timestamp** | [uint64](https://developers.google.com/protocol-buffers/docs/proto#scalar) | Optional | One | Moment at which the vehicle's position was measured. In POSIX time (i.e., number of seconds since January 1st 1970 00:00:00 UTC). | | **congestion_level** | [CongestionLevel](#enum-congestionlevel) | Optional | One | | **occupancy_status** | [OccupancyStatus](#enum-occupancystatus) | Optional | One | The degree of passenger occupancy of the vehicle. More detail can be provided with _occupancy_percentage_. | -| **occupancy_percentage** | [uint32](https://developers.google.com/protocol-buffers/docs/proto#scalar) | Optionals | One | A percentage value representing the degree of passenger occupancy of the vehicle. The value 100 should represent total the maximum occupancy the vehicle was designed for. It's not impossible that the value goes over 100 if there are currently more passenger than the vehicle was designed for. | +| **occupancy_percentage** | [uint32](https://developers.google.com/protocol-buffers/docs/proto#scalar) | Optional | One | A percentage value representing the degree of passenger occupancy of the vehicle. The value 100 should represent total the maximum occupancy the vehicle was designed for. It's not impossible that the value goes over 100 if there are currently more passenger than the vehicle was designed for. | ## _enum_ VehicleStopStatus From aa5a5569ad32c952776617608e9544ca9955c9e9 Mon Sep 17 00:00:00 2001 From: Guillaume Campagna Date: Wed, 8 Apr 2020 16:50:25 -0400 Subject: [PATCH 03/11] Add more details for seating + standing capacity --- gtfs-realtime/spec/en/reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gtfs-realtime/spec/en/reference.md b/gtfs-realtime/spec/en/reference.md index 157271036..e7e9a2f98 100644 --- a/gtfs-realtime/spec/en/reference.md +++ b/gtfs-realtime/spec/en/reference.md @@ -208,7 +208,7 @@ Realtime positioning information for a given vehicle. | **timestamp** | [uint64](https://developers.google.com/protocol-buffers/docs/proto#scalar) | Optional | One | Moment at which the vehicle's position was measured. In POSIX time (i.e., number of seconds since January 1st 1970 00:00:00 UTC). | | **congestion_level** | [CongestionLevel](#enum-congestionlevel) | Optional | One | | **occupancy_status** | [OccupancyStatus](#enum-occupancystatus) | Optional | One | The degree of passenger occupancy of the vehicle. More detail can be provided with _occupancy_percentage_. | -| **occupancy_percentage** | [uint32](https://developers.google.com/protocol-buffers/docs/proto#scalar) | Optional | One | A percentage value representing the degree of passenger occupancy of the vehicle. The value 100 should represent total the maximum occupancy the vehicle was designed for. It's not impossible that the value goes over 100 if there are currently more passenger than the vehicle was designed for. | +| **occupancy_percentage** | [uint32](https://developers.google.com/protocol-buffers/docs/proto#scalar) | Optional | One | A percentage value representing the degree of passenger occupancy of the vehicle. The value 100 should represent total the maximum occupancy the vehicle was designed for including both seating and standing capacity. It's not impossible that the value goes over 100 if there are currently more passenger than the vehicle was designed for. | ## _enum_ VehicleStopStatus From 2727f973a7ce470a086dc968fcf85480df47e20a Mon Sep 17 00:00:00 2001 From: Guillaume Campagna Date: Wed, 8 Apr 2020 17:03:20 -0400 Subject: [PATCH 04/11] Add more details Co-Authored-By: Juan --- gtfs-realtime/proto/gtfs-realtime.proto | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gtfs-realtime/proto/gtfs-realtime.proto b/gtfs-realtime/proto/gtfs-realtime.proto index 9d4fbc531..35a1e7191 100644 --- a/gtfs-realtime/proto/gtfs-realtime.proto +++ b/gtfs-realtime/proto/gtfs-realtime.proto @@ -383,7 +383,7 @@ message VehiclePosition { optional OccupancyStatus occupancy_status = 9; // A percentage value representing the degree of passenger occupancy of the vehicle. - // The value 100 should represent total the maximum occupancy the vehicle was designed for. + // The value 100 should represent the total maximum occupancy the vehicle was designed for, including both seated and standing capacity. // It's not impossible that the value goes over 100 if there are currently more passenger than the vehicle was designed for. optional OccupancyStatus occupancy_percentage = 10; From c376f4a3ff758fea9d756d3985c06b4798e9ccbf Mon Sep 17 00:00:00 2001 From: Guillaume Campagna Date: Wed, 8 Apr 2020 17:03:39 -0400 Subject: [PATCH 05/11] Re-phrase comment Co-Authored-By: Juan --- gtfs-realtime/proto/gtfs-realtime.proto | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gtfs-realtime/proto/gtfs-realtime.proto b/gtfs-realtime/proto/gtfs-realtime.proto index 35a1e7191..7431af85e 100644 --- a/gtfs-realtime/proto/gtfs-realtime.proto +++ b/gtfs-realtime/proto/gtfs-realtime.proto @@ -384,7 +384,7 @@ message VehiclePosition { // A percentage value representing the degree of passenger occupancy of the vehicle. // The value 100 should represent the total maximum occupancy the vehicle was designed for, including both seated and standing capacity. - // It's not impossible that the value goes over 100 if there are currently more passenger than the vehicle was designed for. + // It is possible that the value goes over 100 if there are currently more passengers than what the vehicle was designed for. optional OccupancyStatus occupancy_percentage = 10; // The extensions namespace allows 3rd-party developers to extend the From 3f3ab98dfe0f37480a326398767449c50c618ac3 Mon Sep 17 00:00:00 2001 From: Guillaume Campagna Date: Wed, 8 Apr 2020 17:03:51 -0400 Subject: [PATCH 06/11] Add more details about use of percent Co-Authored-By: Juan --- gtfs-realtime/proto/gtfs-realtime.proto | 1 + 1 file changed, 1 insertion(+) diff --git a/gtfs-realtime/proto/gtfs-realtime.proto b/gtfs-realtime/proto/gtfs-realtime.proto index 7431af85e..0d2acd732 100644 --- a/gtfs-realtime/proto/gtfs-realtime.proto +++ b/gtfs-realtime/proto/gtfs-realtime.proto @@ -383,6 +383,7 @@ message VehiclePosition { optional OccupancyStatus occupancy_status = 9; // A percentage value representing the degree of passenger occupancy of the vehicle. + // The values are represented as an integer without decimals. 0 means 0% and 100 means 100%. // The value 100 should represent the total maximum occupancy the vehicle was designed for, including both seated and standing capacity. // It is possible that the value goes over 100 if there are currently more passengers than what the vehicle was designed for. optional OccupancyStatus occupancy_percentage = 10; From 28de1ae5f6da7f50a58356983ea21fc71a2d6b77 Mon Sep 17 00:00:00 2001 From: Guillaume Campagna Date: Wed, 8 Apr 2020 17:04:16 -0400 Subject: [PATCH 07/11] Use new phrasing Co-Authored-By: Juan --- gtfs-realtime/spec/en/reference.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/gtfs-realtime/spec/en/reference.md b/gtfs-realtime/spec/en/reference.md index e7e9a2f98..3df726c9d 100644 --- a/gtfs-realtime/spec/en/reference.md +++ b/gtfs-realtime/spec/en/reference.md @@ -208,7 +208,7 @@ Realtime positioning information for a given vehicle. | **timestamp** | [uint64](https://developers.google.com/protocol-buffers/docs/proto#scalar) | Optional | One | Moment at which the vehicle's position was measured. In POSIX time (i.e., number of seconds since January 1st 1970 00:00:00 UTC). | | **congestion_level** | [CongestionLevel](#enum-congestionlevel) | Optional | One | | **occupancy_status** | [OccupancyStatus](#enum-occupancystatus) | Optional | One | The degree of passenger occupancy of the vehicle. More detail can be provided with _occupancy_percentage_. | -| **occupancy_percentage** | [uint32](https://developers.google.com/protocol-buffers/docs/proto#scalar) | Optional | One | A percentage value representing the degree of passenger occupancy of the vehicle. The value 100 should represent total the maximum occupancy the vehicle was designed for including both seating and standing capacity. It's not impossible that the value goes over 100 if there are currently more passenger than the vehicle was designed for. | +| **occupancy_percentage** | [uint32](https://developers.google.com/protocol-buffers/docs/proto#scalar) | Optional | One | A percentage value representing the degree of passenger occupancy of the vehicle. The value 100 should represent the total maximum occupancy the vehicle was designed for including both seating and standing capacity. It is possible that the value goes over 100 if there are currently more passengers than what the vehicle was designed for. | ## _enum_ VehicleStopStatus From 39bbf1cd5f1a595f7a2ccb4bbc90f605a4c20b6e Mon Sep 17 00:00:00 2001 From: Guillaume Campagna Date: Wed, 8 Apr 2020 17:05:13 -0400 Subject: [PATCH 08/11] Add more details --- gtfs-realtime/spec/en/reference.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/gtfs-realtime/spec/en/reference.md b/gtfs-realtime/spec/en/reference.md index 3df726c9d..7c6678463 100644 --- a/gtfs-realtime/spec/en/reference.md +++ b/gtfs-realtime/spec/en/reference.md @@ -208,7 +208,7 @@ Realtime positioning information for a given vehicle. | **timestamp** | [uint64](https://developers.google.com/protocol-buffers/docs/proto#scalar) | Optional | One | Moment at which the vehicle's position was measured. In POSIX time (i.e., number of seconds since January 1st 1970 00:00:00 UTC). | | **congestion_level** | [CongestionLevel](#enum-congestionlevel) | Optional | One | | **occupancy_status** | [OccupancyStatus](#enum-occupancystatus) | Optional | One | The degree of passenger occupancy of the vehicle. More detail can be provided with _occupancy_percentage_. | -| **occupancy_percentage** | [uint32](https://developers.google.com/protocol-buffers/docs/proto#scalar) | Optional | One | A percentage value representing the degree of passenger occupancy of the vehicle. The value 100 should represent the total maximum occupancy the vehicle was designed for including both seating and standing capacity. It is possible that the value goes over 100 if there are currently more passengers than what the vehicle was designed for. | +| **occupancy_percentage** | [uint32](https://developers.google.com/protocol-buffers/docs/proto#scalar) | Optional | One | A percentage value representing the degree of passenger occupancy of the vehicle. The value 100 should represent total the maximum occupancy the vehicle was designed for including both seating and standing capacity. It's not impossible that the value goes over 100 if there are currently more passenger than the vehicle was designed for. | ## _enum_ VehicleStopStatus @@ -236,7 +236,7 @@ Congestion level that is affecting this vehicle. ## _enum OccupancyStatus_ -The degree of passenger occupancy for the vehicle. OccupancyStatus should be used to display a textual or +The degree of passenger occupancy for the vehicle. OccupancyStatus should be used to display a textual or iconic representation of occupancy #### _Values_ From 5843b80f25dbe61b7a74bf7410b648b0690d41a0 Mon Sep 17 00:00:00 2001 From: Guillaume Campagna Date: Wed, 8 Apr 2020 21:05:29 -0400 Subject: [PATCH 09/11] Update standing value to STANDING_AVAILABLE to match SIRI --- gtfs-realtime/proto/gtfs-realtime.proto | 4 ++-- gtfs-realtime/spec/en/reference.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/gtfs-realtime/proto/gtfs-realtime.proto b/gtfs-realtime/proto/gtfs-realtime.proto index 0d2acd732..511b3eba3 100644 --- a/gtfs-realtime/proto/gtfs-realtime.proto +++ b/gtfs-realtime/proto/gtfs-realtime.proto @@ -363,8 +363,8 @@ message VehiclePosition { // Deprecated, if you need more granularity than the available enum please use occupancy_percentage FEW_SEATS_AVAILABLE = 2 [deprecated=true]; - // The vehicle can currently accommodate only standing passengers. - STANDING_ROOM_ONLY = 3; + // The vehicle can currently accommodate standing passengers. + STANDING_AVAILABLE = 3; // The vehicle can currently accommodate only standing passengers // and has limited space for them. diff --git a/gtfs-realtime/spec/en/reference.md b/gtfs-realtime/spec/en/reference.md index 7c6678463..edfc2dd74 100644 --- a/gtfs-realtime/spec/en/reference.md +++ b/gtfs-realtime/spec/en/reference.md @@ -243,7 +243,7 @@ The degree of passenger occupancy for the vehicle. OccupancyStatus should be use | _**Value**_ | _**Comment**_ | |-------------|---------------| | _**SEATS_AVAILABLE**_ | _The vehicle has seats available._ | -| _**STANDING_ROOM_ONLY**_ | _The vehicle can currently accommodate only standing passengers._ | +| _**STANDING_AVAILABLE**_ | _The vehicle can currently accommodate standing passengers._ | | _**FULL**_ | _The vehicle is considered full by most measures, but may still be allowing passengers to board._ | ## _message_ Alert From 50309afccd3e4eb2e6e9403283597ee846a5f0c3 Mon Sep 17 00:00:00 2001 From: Guillaume Campagna Date: Thu, 9 Apr 2020 08:37:42 -0400 Subject: [PATCH 10/11] Add privacy requirement for occupancy_percentage --- gtfs-realtime/proto/gtfs-realtime.proto | 1 + gtfs-realtime/spec/en/reference.md | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/gtfs-realtime/proto/gtfs-realtime.proto b/gtfs-realtime/proto/gtfs-realtime.proto index 0d2acd732..a1034fa21 100644 --- a/gtfs-realtime/proto/gtfs-realtime.proto +++ b/gtfs-realtime/proto/gtfs-realtime.proto @@ -386,6 +386,7 @@ message VehiclePosition { // The values are represented as an integer without decimals. 0 means 0% and 100 means 100%. // The value 100 should represent the total maximum occupancy the vehicle was designed for, including both seated and standing capacity. // It is possible that the value goes over 100 if there are currently more passengers than what the vehicle was designed for. + // The precision of precision should be low enough that you can't track a single person boarding and alighting for privacy reasons. optional OccupancyStatus occupancy_percentage = 10; // The extensions namespace allows 3rd-party developers to extend the diff --git a/gtfs-realtime/spec/en/reference.md b/gtfs-realtime/spec/en/reference.md index 7c6678463..4d759c55e 100644 --- a/gtfs-realtime/spec/en/reference.md +++ b/gtfs-realtime/spec/en/reference.md @@ -208,7 +208,7 @@ Realtime positioning information for a given vehicle. | **timestamp** | [uint64](https://developers.google.com/protocol-buffers/docs/proto#scalar) | Optional | One | Moment at which the vehicle's position was measured. In POSIX time (i.e., number of seconds since January 1st 1970 00:00:00 UTC). | | **congestion_level** | [CongestionLevel](#enum-congestionlevel) | Optional | One | | **occupancy_status** | [OccupancyStatus](#enum-occupancystatus) | Optional | One | The degree of passenger occupancy of the vehicle. More detail can be provided with _occupancy_percentage_. | -| **occupancy_percentage** | [uint32](https://developers.google.com/protocol-buffers/docs/proto#scalar) | Optional | One | A percentage value representing the degree of passenger occupancy of the vehicle. The value 100 should represent total the maximum occupancy the vehicle was designed for including both seating and standing capacity. It's not impossible that the value goes over 100 if there are currently more passenger than the vehicle was designed for. | +| **occupancy_percentage** | [uint32](https://developers.google.com/protocol-buffers/docs/proto#scalar) | Optional | One | A percentage value representing the degree of passenger occupancy of the vehicle. The value 100 should represent total the maximum occupancy the vehicle was designed for including both seating and standing capacity. It's not impossible that the value goes over 100 if there are currently more passenger than the vehicle was designed for. The precision of precision should be low enough that you can't track a single person boarding and alighting for privacy reasons. | ## _enum_ VehicleStopStatus From b29854315214342c4fc0a7cc602dc7bc4a242a7e Mon Sep 17 00:00:00 2001 From: Guillaume Campagna Date: Thu, 9 Apr 2020 08:38:36 -0400 Subject: [PATCH 11/11] Remove comment not relevant anymore --- gtfs-realtime/proto/gtfs-realtime.proto | 10 +--------- 1 file changed, 1 insertion(+), 9 deletions(-) diff --git a/gtfs-realtime/proto/gtfs-realtime.proto b/gtfs-realtime/proto/gtfs-realtime.proto index a1034fa21..ef1611e73 100644 --- a/gtfs-realtime/proto/gtfs-realtime.proto +++ b/gtfs-realtime/proto/gtfs-realtime.proto @@ -349,25 +349,18 @@ message VehiclePosition { // The degree of passenger occupancy of the vehicle enum OccupancyStatus { - // The vehicle is considered empty by most measures, and has few or no - // passengers onboard, but is still accepting passengers. + // Deprecated, if you need more granularity than the available enum please use occupancy_percentage EMPTY = 0 [deprecated=true]; // The vehicle has seats available. SEATS_AVAILABLE = 1; - // The vehicle has a relatively small percentage of seats available. - // What percentage of free seats out of the total seats available is to be - // considered small enough to fall into this category is determined at the - // discretion of the feed producer. // Deprecated, if you need more granularity than the available enum please use occupancy_percentage FEW_SEATS_AVAILABLE = 2 [deprecated=true]; // The vehicle can currently accommodate only standing passengers. STANDING_ROOM_ONLY = 3; - // The vehicle can currently accommodate only standing passengers - // and has limited space for them. // Deprecated, if you need more granularity than the available enum please use occupancy_percentage CRUSHED_STANDING_ROOM_ONLY = 4 [deprecated=true]; @@ -375,7 +368,6 @@ message VehiclePosition { // allowing passengers to board. FULL = 5; - // The vehicle is not accepting additional passengers. // Deprecated, if you need more granularity than the available enum please use occupancy_percentage NOT_ACCEPTING_PASSENGERS = 6 [deprecated=true];