Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

MDS-Agency Stops Specification #430

Closed
wants to merge 3 commits into from
Closed

MDS-Agency Stops Specification #430

Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
7f002f6
Add agency stops definition
avatarneil Jan 23, 2020
fedbe23
Alignment with recent changes in Provider version
avatarneil Jun 10, 2020
5ef7383
Add stop_id to telemetry payload
avatarneil Jun 11, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
61 changes: 61 additions & 0 deletions agency/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -251,6 +251,67 @@ A standard point of vehicle telemetry. References to latitude and longitude impl
| `gps.satellites` | Integer | Required if Available | Number of GPS or GNSS satellites
| `charge` | Float | Required if Applicable | Percent battery charge of vehicle, expressed between 0 and 1 |

## Stops

The `/stops` endpoint allows an agency to register Stops.

Endpoint: `/stops`
Method: `POST`

| Field | Type | Required/Optional | Description |
|---------------------|-----------------------------------------------------------------------------------|-------------------|------------------------------------------------------------------------------------------------------------------------------------------------------|
| stop_id | UUID | Required | Unique ID for stop |
| stop_name | String | Required | Name of stop |
| lat | Double | Required | Latitude of the location |
| lng | Double | Required | Longitude of the location |
| capacity | {vehicle_type: number} | Required | Number of total spots per vehicle_type |
| geography_id | UUID | Optional | Pointer to the Geography that represents the stop geospatially |
| region_id | string | Optional | ID of the region where station is located, see [GBFS Station Information](https://github.com/NABSA/gbfs/blob/master/gbfs.md#station_informationjson) |
| short_name | String | Optional | Abbreviated stop name |
| address | String | Optional | Postal address (useful for directions) |
| post_code | String | Optional | Postal code (e.g. `10036`) |
| rental_methods | [Enum](https://github.com/NABSA/gbfs/blob/master/gbfs.md#station_informationjson) | Optional | Payment methods accepted at stop, see [GBFS Rental Methods](https://github.com/NABSA/gbfs/blob/master/gbfs.md#station_informationjson) |
| timezone | String | Optional | Timezone stop is located in |
| cross_street | String | Optional | Cross street of where the station is located. |
| wheelchair_boarding | Boolean | Optional | Is this stop handicap accessible? |
| parent_stop | UUID | Optional | Describe a basic hierarchy of stops (e.g.a stop inside of a greater stop) |

Endpoint: `/stops`
Method: `PUT`

| Field | Type | Required/Optional | Description |
|---------------------|------------------------|-------------------|-------------------------------------------------------------------------|
| stop_id | UUID | Required | Unique ID for stop |
| num_spots_available | {vehicle_type: number} | Optional | How many spots are free to be populated with vehicles at this stop? |
| num_spots_disabled | {vehicle_type: number} | Optional | How many docks are disabled and unable to accept vehicles at this stop? |

Endpoint: `/stops/{stop_id}`
Method: `GET`

| Field | Type | Required/Optional | Description |
|------------------------|-----------------------------------------------------------------------------------|-------------------|------------------------------------------------------------------------------------------------------------------------------------------------------|
| stop_id | UUID | Required | Unique ID for stop |
| stop_name | String | Required | Name of stop |
| lat | Double | Required | Latitude of the location |
| lng | Double | Required | Longitude of the location |
| capacity | {vehicle_type: number} | Required | Number of total spots per vehicle_type |
| num_vehicles_available | {vehicle_type: number} | Required | How many vehicles are available per vehicle_type at this stop? |
| num_vehicles_disabled | {vehicle_type: number} | Required | How many vehicles are unavailable/reserved per vehicle_type at this stop? |
| geography_id | UUID | Optional | Pointer to the Geography that represents the stop geospatially |
| region_id | string | Optional | ID of the region where station is located, see [GBFS Station Information](https://github.com/NABSA/gbfs/blob/master/gbfs.md#station_informationjson) |
| short_name | String | Optional | Abbreviated stop name |
| address | String | Optional | Postal address (useful for directions) |
| post_code | String | Optional | Postal code (e.g. `10036`) |
| rental_methods | [Enum](https://github.com/NABSA/gbfs/blob/master/gbfs.md#station_informationjson) | Optional | Payment methods accepted at stop, see [GBFS Rental Methods](https://github.com/NABSA/gbfs/blob/master/gbfs.md#station_informationjson) |
| cross_street | String | Optional | Cross street of where the station is located. |
| num_spots_available | {vehicle_type: number} | Optional | How many spots are free to be populated with vehicles at this stop? |
| num_spots_disabled | {vehicle_type: number} | Optional | How many docks are disabled and unable to accept vehicles at this stop? |
| wheelchair_boarding | Boolean | Optional | Is this stop handicap accessible? |
| parent_stop | UUID | Optional | Describe a basic hierarchy of stops (e.g.a stop inside of a greater stop) |

### GBFS Compatibility
Some of the fields in the `Stops` definition are using notions which are currently not in MDS, such as `rental_methods`. These fields are included for compatibility with GBFS.

## Enum Definitions

### Area Types
Expand Down