From a168719686b9ea75f114b092f3661241e7f57d11 Mon Sep 17 00:00:00 2001 From: Chris Roberts Date: Wed, 21 Jul 2021 18:51:52 +0100 Subject: [PATCH 1/2] Add GTFS extended route_types Proposed by Google https://developers.google.com/transit/gtfs/reference/extended-route-types --- 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 437c7b1e3..1affd0cfe 100644 --- a/gtfs/spec/en/reference.md +++ b/gtfs/spec/en/reference.md @@ -166,7 +166,7 @@ File: **Required** | `route_short_name` | Text | **Conditionally Required** | Short name of a route. Often a short, abstract identifier (e.g., "32", "100X", "Green") that riders use to identify a route. Both `route_short_name` and `route_long_name` may be defined.

Conditionally Required:
- **Required** if `routes.route_long_name` is empty.
- Optional otherwise. | | `route_long_name` | Text | **Conditionally Required** | Full name of a route. This name is generally more descriptive than the `route_short_name` and often includes the route's destination or stop. Both `route_short_name` and `route_long_name` may be defined.

Conditionally Required:
- **Required** if `routes.route_short_name` is empty.
- Optional otherwise. | | `route_desc` | Text | Optional | Description of a route that provides useful, quality information. Do not simply duplicate the name of the route.
_Example: "A" trains operate between Inwood-207 St, Manhattan and Far Rockaway-Mott Avenue, Queens at all times. Also from about 6AM until about midnight, additional "A" trains operate between Inwood-207 St and Lefferts Boulevard (trains typically alternate between Lefferts Blvd and Far Rockaway)._ | -| `route_type` | Enum | **Required** | Indicates the type of transportation used on a route. Valid options are:

`0` - Tram, Streetcar, Light rail. Any light rail or street level system within a metropolitan area.
`1` - Subway, Metro. Any underground rail system within a metropolitan area.
`2` - Rail. Used for intercity or long-distance travel.
`3` - Bus. Used for short- and long-distance bus routes.
`4` - Ferry. Used for short- and long-distance boat service.
`5` - Cable tram. Used for street-level rail cars where the cable runs beneath the vehicle (e.g., cable car in San Francisco).
`6` - Aerial lift, suspended cable car (e.g., gondola lift, aerial tramway). Cable transport where cabins, cars, gondolas or open chairs are suspended by means of one or more cables.
`7` - Funicular. Any rail system designed for steep inclines.
`11` - Trolleybus. Electric buses that draw power from overhead wires using poles.
`12` - Monorail. Railway in which the track consists of a single rail or a beam. | +| `route_type` | Enum | **Required** | Indicates the type of transportation used on a route. Valid options are:

`0` - Tram, Streetcar, Light rail. Any light rail or street level system within a metropolitan area.
`1` - Subway, Metro. Any underground rail system within a metropolitan area.
`2` - Rail. Used for intercity or long-distance travel.
`3` - Bus. Used for short- and long-distance bus routes.
`4` - Ferry. Used for short- and long-distance boat service.
`5` - Cable tram. Used for street-level rail cars where the cable runs beneath the vehicle (e.g., cable car in San Francisco).
`6` - Aerial lift, suspended cable car (e.g., gondola lift, aerial tramway). Cable transport where cabins, cars, gondolas or open chairs are suspended by means of one or more cables.
`7` - Funicular. Any rail system designed for steep inclines.
`11` - Trolleybus. Electric buses that draw power from overhead wires using poles.
`12` - Monorail. Railway in which the track consists of a single rail or a beam.

In addition, an extension has been proposed to allow specifying route types using Hierarchical Vehicle Type (HVT) codes from the European TPEG standard.

`100` - Railway Service
`101` - High Speed Rail Service
`102` - Long Distance Trains
`103` - Inter Regional ail Service
`104` - Car Transport Rail Service
`105` - Sleeper Rail Service
`106` - Regional Rail ervice
`107` - Tourist Railway Service
`108` - Rail Shuttle (Within Complex)
`109` - Suburban Railway
`110` - Replacement Rail Service
`111` - Special Rail Service
`112` - Lorry Transport Rail ervice
`113` - All Rail Services
`114` - Cross-Country Rail Service
`115` - Vehicle Transport Rail ervice
`116` - Rack and Pinion Railway
`117` - Additional Rail Service
`200` - Coach Service
`201` - International Coach Service
`202` - National Coach Service
`203` - Shuttle Coach Service
`204` - egional Coach Service
`205` - Special Coach Service
`206` - Sightseeing Coach Service
`207` - Tourist oach Service
`208` - Commuter Coach Service
`209` - All Coach Services
`400` - Urban Railway Service
`401` - Metro Service
`402` - Underground Service
`403` - Urban Railway Service
`404` - All rban Railway Services
`405` - Monorail
`700` - Bus Service
`701` - Regional Bus Service
`702` - xpress Bus Service
`703` - Stopping Bus Service
`704` - Local Bus Service
`705` - Night Bus Service
`706` - Post Bus Service
`707` - Special Needs Bus
`708` - Mobility Bus Service
`709` - - Mobility Bus for Registered Disabled
`710` - Sightseeing Bus
`711` - Shuttle Bus
`712` - School us
`713` - School and Public Service Bus
`714` - Rail Replacement Bus Service
`715` - Demand and esponse Bus Service
`716` - All Bus Services
`800` - Trolleybus Service
`900` - Tram Service
`901` - City Tram Service
`902` - Local Tram Service
`903` - Regional Tram Service
`904` - Sightseeing Tram ervice
`905` - Shuttle Tram Service
`906` - All Tram Services
`1000` - Water Transport Service
`1100` - Air Service
`1200` - Ferry Service
`1300` - Aerial Lift Service
`1400` - Funicular ervice
`1500` - Taxi Service
`1501` - Communal Taxi Service
`1502` - Water Taxi Service
`1503` - ail Taxi Service
`1504` - Bike Taxi Service
`1505` - Licensed Taxi Service
`1506` - Private Hire ervice Vehicle
`1507` - All Taxi Services
`1700` - Miscellaneous Service
`1702` - Horse-drawn Carriage| | `route_url` | URL | Optional | URL of a web page about the particular route. Should be different from the `agency.agency_url` value. | | `route_color` | Color | Optional | Route color designation that matches public facing material. Defaults to white (`FFFFFF`) when omitted or left empty. The color difference between `route_color` and `route_text_color` should provide sufficient contrast when viewed on a black and white screen. | | `route_text_color` | Color | Optional | Legible color to use for text drawn against a background of `route_color`. Defaults to black (`000000`) when omitted or left empty. The color difference between `route_color` and `route_text_color` should provide sufficient contrast when viewed on a black and white screen. | From 0f108c1e3eaa557c8fec37824f22e26d6ea6007e Mon Sep 17 00:00:00 2001 From: Chris Roberts Date: Wed, 21 Jul 2021 19:50:42 +0100 Subject: [PATCH 2/2] Reduce route types to those supported by Google Transit APIs --- 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 1affd0cfe..fc4a8ef87 100644 --- a/gtfs/spec/en/reference.md +++ b/gtfs/spec/en/reference.md @@ -166,7 +166,7 @@ File: **Required** | `route_short_name` | Text | **Conditionally Required** | Short name of a route. Often a short, abstract identifier (e.g., "32", "100X", "Green") that riders use to identify a route. Both `route_short_name` and `route_long_name` may be defined.

Conditionally Required:
- **Required** if `routes.route_long_name` is empty.
- Optional otherwise. | | `route_long_name` | Text | **Conditionally Required** | Full name of a route. This name is generally more descriptive than the `route_short_name` and often includes the route's destination or stop. Both `route_short_name` and `route_long_name` may be defined.

Conditionally Required:
- **Required** if `routes.route_short_name` is empty.
- Optional otherwise. | | `route_desc` | Text | Optional | Description of a route that provides useful, quality information. Do not simply duplicate the name of the route.
_Example: "A" trains operate between Inwood-207 St, Manhattan and Far Rockaway-Mott Avenue, Queens at all times. Also from about 6AM until about midnight, additional "A" trains operate between Inwood-207 St and Lefferts Boulevard (trains typically alternate between Lefferts Blvd and Far Rockaway)._ | -| `route_type` | Enum | **Required** | Indicates the type of transportation used on a route. Valid options are:

`0` - Tram, Streetcar, Light rail. Any light rail or street level system within a metropolitan area.
`1` - Subway, Metro. Any underground rail system within a metropolitan area.
`2` - Rail. Used for intercity or long-distance travel.
`3` - Bus. Used for short- and long-distance bus routes.
`4` - Ferry. Used for short- and long-distance boat service.
`5` - Cable tram. Used for street-level rail cars where the cable runs beneath the vehicle (e.g., cable car in San Francisco).
`6` - Aerial lift, suspended cable car (e.g., gondola lift, aerial tramway). Cable transport where cabins, cars, gondolas or open chairs are suspended by means of one or more cables.
`7` - Funicular. Any rail system designed for steep inclines.
`11` - Trolleybus. Electric buses that draw power from overhead wires using poles.
`12` - Monorail. Railway in which the track consists of a single rail or a beam.

In addition, an extension has been proposed to allow specifying route types using Hierarchical Vehicle Type (HVT) codes from the European TPEG standard.

`100` - Railway Service
`101` - High Speed Rail Service
`102` - Long Distance Trains
`103` - Inter Regional ail Service
`104` - Car Transport Rail Service
`105` - Sleeper Rail Service
`106` - Regional Rail ervice
`107` - Tourist Railway Service
`108` - Rail Shuttle (Within Complex)
`109` - Suburban Railway
`110` - Replacement Rail Service
`111` - Special Rail Service
`112` - Lorry Transport Rail ervice
`113` - All Rail Services
`114` - Cross-Country Rail Service
`115` - Vehicle Transport Rail ervice
`116` - Rack and Pinion Railway
`117` - Additional Rail Service
`200` - Coach Service
`201` - International Coach Service
`202` - National Coach Service
`203` - Shuttle Coach Service
`204` - egional Coach Service
`205` - Special Coach Service
`206` - Sightseeing Coach Service
`207` - Tourist oach Service
`208` - Commuter Coach Service
`209` - All Coach Services
`400` - Urban Railway Service
`401` - Metro Service
`402` - Underground Service
`403` - Urban Railway Service
`404` - All rban Railway Services
`405` - Monorail
`700` - Bus Service
`701` - Regional Bus Service
`702` - xpress Bus Service
`703` - Stopping Bus Service
`704` - Local Bus Service
`705` - Night Bus Service
`706` - Post Bus Service
`707` - Special Needs Bus
`708` - Mobility Bus Service
`709` - - Mobility Bus for Registered Disabled
`710` - Sightseeing Bus
`711` - Shuttle Bus
`712` - School us
`713` - School and Public Service Bus
`714` - Rail Replacement Bus Service
`715` - Demand and esponse Bus Service
`716` - All Bus Services
`800` - Trolleybus Service
`900` - Tram Service
`901` - City Tram Service
`902` - Local Tram Service
`903` - Regional Tram Service
`904` - Sightseeing Tram ervice
`905` - Shuttle Tram Service
`906` - All Tram Services
`1000` - Water Transport Service
`1100` - Air Service
`1200` - Ferry Service
`1300` - Aerial Lift Service
`1400` - Funicular ervice
`1500` - Taxi Service
`1501` - Communal Taxi Service
`1502` - Water Taxi Service
`1503` - ail Taxi Service
`1504` - Bike Taxi Service
`1505` - Licensed Taxi Service
`1506` - Private Hire ervice Vehicle
`1507` - All Taxi Services
`1700` - Miscellaneous Service
`1702` - Horse-drawn Carriage| +| `route_type` | Enum | **Required** | Indicates the type of transportation used on a route. Valid options are:

`0` - Tram, Streetcar, Light rail. Any light rail or street level system within a metropolitan area.
`1` - Subway, Metro. Any underground rail system within a metropolitan area.
`2` - Rail. Used for intercity or long-distance travel.
`3` - Bus. Used for short- and long-distance bus routes.
`4` - Ferry. Used for short- and long-distance boat service.
`5` - Cable tram. Used for street-level rail cars where the cable runs beneath the vehicle (e.g., cable car in San Francisco).
`6` - Aerial lift, suspended cable car (e.g., gondola lift, aerial tramway). Cable transport where cabins, cars, gondolas or open chairs are suspended by means of one or more cables.
`7` - Funicular. Any rail system designed for steep inclines.
`11` - Trolleybus. Electric buses that draw power from overhead wires using poles.
`12` - Monorail. Railway in which the track consists of a single rail or a beam.

In addition, an extension has been proposed to allow specifying several route types using a relevant subset of Hierarchical Vehicle Type (HVT) codes from the European TPEG standard.

`100` - Railway Service
`101` - High Speed Rail Service
`102` - Long Distance Trains
`103` - Inter Regional ail Service
`105` - Sleeper Rail Service
`106` - Regional Rail ervice
`107` - Tourist Railway Service
`108` - Rail Shuttle (Within Complex)
`109` - Suburban Railway
`200` - Coach Service
`201` - International Coach Service
`202` - National Coach Service
`204` - Regional Coach Service
`400` - Urban Railway Service
`401` - Metro Service
`402` - Underground Service
`403` - Urban Railway Service
`405` - Monorail
`700` - Bus Service
`701` - Regional Bus Service
`702` - Express Bus Service
`704` - Local Bus Service
`715` - Demand and Response Bus Service
`800` - Trolleybus Service
`900` - Tram Service
`901` - City Tram Service
`902` - Local Tram Service
`903` - Regional Tram Service
`904` - Sightseeing Tram ervice
`905` - Shuttle Tram Service
`906` - All Tram Services
`1000` - Water Transport Service
`1200` - Ferry Service
`1300` - Aerial Lift Service
`1400` - Funicular Service
`1501` - Communal Taxi Service
`1700` - Miscellaneous Service
`1702` - Horse-drawn Carriage| | `route_url` | URL | Optional | URL of a web page about the particular route. Should be different from the `agency.agency_url` value. | | `route_color` | Color | Optional | Route color designation that matches public facing material. Defaults to white (`FFFFFF`) when omitted or left empty. The color difference between `route_color` and `route_text_color` should provide sufficient contrast when viewed on a black and white screen. | | `route_text_color` | Color | Optional | Legible color to use for text drawn against a background of `route_color`. Defaults to black (`000000`) when omitted or left empty. The color difference between `route_color` and `route_text_color` should provide sufficient contrast when viewed on a black and white screen. |