Skip to content

Pathways (and levels) proposal#86

Closed
LeoFrachet wants to merge 5 commits intogoogle:masterfrom
LeoFrachet:proposal/pathways
Closed

Pathways (and levels) proposal#86
LeoFrachet wants to merge 5 commits intogoogle:masterfrom
LeoFrachet:proposal/pathways

Conversation

@LeoFrachet
Copy link
Contributor

The goal is to describe the inside of a station, so that a trip planner could process the impact of an elevator being down on the accessibility (for example).

This proposal contains two new files:

Pathways describes "ways" within the stations (which can be seen as edges in a graph where the stop/station/entrance/node are the vertices), with a description of their physical characteristics (stairs vs elevator, slope, length) and on their descriptive characteristics (name, code, indication).

Levels describes the vertical distribution of a station. In most complex stations, the platforms are layered, without any indication in the current GTFS specification of this repartition.

| Field Name | Required | Details |
| ------ | ------ | ------ |
| level_id | **Required** | The **level_id** field contains an ID that identifies a level. The **level_id** is dataset unique. |
| level_index | **Required** | The **from_stop_id** field contains a numeric index of the level that indicates relative position of this level in relation to other levels (levels with higher indices are assumed to be located above levels with lower indices). Ground level should have index 0, with levels above ground indicated by positive indices and levels below ground by negative indices. |
Copy link
Contributor

@jxeeno jxeeno Jan 18, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this is meant to be level_index here (in details)?

Copy link
Contributor Author

@LeoFrachet LeoFrachet Jan 18, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed. My bad. Thanks.

| | | Note: The approximation of 1 floor = 15 stairs (or 12 for an escalator) can be used to generate approximative values. |
| pathway_name | Optional | The **pathway_name** field contains the name of the pathway, if any. Please use a name that people will understand in the local and tourist vernacular. |
| pathway_code | Optional | The **pathway_code** field contains a short text or a number that uniquely identifies the pathway for passengers. The **pathway_code** can be the same as pathway_id if it is passenger-facing. This field should be left blank for pathway without a code presented to passengers. Example: Elevator “A”. |
| signposted_as | Optional | The **signposted_as** field helps to generate schematic directions like 'follow signs to <signposted as>' where <signposted as> part represents specific text on the signs that should remain unaffected by translation into other languages. |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Did you mean "semantic directions" rather than "schematic directions" here?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@dbabramov: This question is for you.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Apologies, I am not a native speaker, so writing well-formed English sentences can be quite a challenge for me.
A native speaker I asked to take a look at this sentence suggested ditching the whole thing in favour of:
"The signposted_as field is an exact string of text from physical signage visible to transit riders. The string can be used to provide textual directions to users, such as 'follow signs to '. The language as printed on the signs should not be translated in this field."

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated.

@LeoFrachet
Copy link
Contributor Author

About the beta implementations:

@dbabramov: Can we say that Google has already implemented most of this proposal, and that we have a beta consumer?

@DaveBarker for MBTA, @kurtraschke for NYMTA, @antrim for Trillium or @sdjacobs for CS: Is one of you planning to release a test GTFS with those fields in the close future?

@dbabramov
Copy link
Contributor

We have not implemented the full spec yet.
At the moment we only have a very basic implementation that does not yet allow for levels or generic station nodes, with several data providers supporting this basic version.

@LeoFrachet
Copy link
Contributor Author

Quick update, we are currently working with the STM (Montréal, CA-QC) to have a beta implementation of this proposal in theirs GTFS. They already have the station entrances in their GTFS.

| | | * **(empty)** - Unknown travel time. |
| | | * **-1** - Pathway not wheelchair accessible. |
| | | * **(non-negative integer)** - Number of seconds needed to travers this pathway in a wheelchair. |
| ramp_slope | Optional | The **ramp_slope** field specifies the slope ratio of the pathway. Valid values for this field are: |
Copy link
Contributor

@barbeau barbeau Aug 16, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

How exactly is ramp_slope calculated? Is it the steepest slope between stops?

After some discussion with @astein6 who lead a research center on accessible transportation it sounds like this may need to be split into two values - steepest incline and decline, or perhaps positive and negative elevation change.

Here's how Google shows elevation change in walking directions:

image

Do we have any producers providing the slope data yet? I'm interested to see how this translates to real data.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

True.

My assumption was that Pathways would only describe paths inside a human-made construction, and that therefore they wouldn't be any complex slope.

But now I'm thinking about those _/ slopes you find when tunnel go under tracks... Either we modelize them with two distinct ramps, or we need indeed two values.

Do you have an example where this could be needed, knowing that this is just for a pathway and not for a full 40min journey?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@LeoFrachet I (unfortunately) don't have an exact real-world example off the top of my head, which is why I was curious to see real producer data for slope values.

@barbeau barbeau added the GTFS Schedule Issues and Pull Requests that focus on GTFS Schedule label Aug 27, 2018
@LeoFrachet LeoFrachet closed this Sep 13, 2018
@LeoFrachet LeoFrachet mentioned this pull request Mar 12, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

GTFS Schedule Issues and Pull Requests that focus on GTFS Schedule

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants