From 09a1a192b6724c8331b1a0ab2e609ccf71270ecc Mon Sep 17 00:00:00 2001 From: Josee Sabourin <66266820+josee-sabourin@users.noreply.github.com> Date: Wed, 15 Dec 2021 11:43:54 -0500 Subject: [PATCH] Extending vehicle_types.json (#370) * Update gbfs.md * Update form_factor enums Replaces scooter enum and adds notes about new scooter form factors, corrects reference to home_station_id Co-authored-by: Mitch Vars --- gbfs.md | 39 ++++++++++++++++++++++++++++++++++----- 1 file changed, 34 insertions(+), 5 deletions(-) diff --git a/gbfs.md b/gbfs.md index 2e89f0cb..1b33161a 100644 --- a/gbfs.md +++ b/gbfs.md @@ -413,12 +413,15 @@ Field Name | REQUIRED | Type | Defines ---|---|---|--- `vehicle_types` | Yes | Array | Array that contains one object per vehicle type in the system as defined below. \- `vehicle_type_id` | Yes | ID | Unique identifier of a vehicle type. See [Field Types](#field-types) above for ID field requirements. -\- `form_factor` | Yes | Enum | The vehicle's general form factor.

Current valid values are:
+\- `form_factor` | Yes | Enum | The vehicle's general form factor.

Current valid values are:
\- `propulsion_type` | Yes | Enum | The primary propulsion type of the vehicle.

Current valid values are:
This field was inspired by, but differs from the propulsion types field described in the [Open Mobility Foundation Mobility Data Specification](https://github.com/openmobilityfoundation/mobility-data-specification/blob/master/provider/README.md#propulsion-types). \- `max_range_meters` | Conditionally REQUIRED | Non-negative float | If the vehicle has a motor (as indicated by having a value other than `human` in the `propulsion_type` field), this field is REQUIRED. This represents the furthest distance in meters that the vehicle can travel without recharging or refueling when it has the maximum amount of energy potential (for example, a full battery or full tank of gas). \- `name` | OPTIONAL | String | The public name of this vehicle type. +\- `wheel_count` | OPTIONAL | Non-negative Integer | Number of wheels this vehicle type has. +\- `max_permitted_speed` | OPTIONAL | Non-negative Integer | The maximum speed in kilometers per hour this vehicle is permitted to reach in accordance with local permit and regulations. +\- `rated_power` | OPTIONAL | Non-negative Integer | The rated power of the motor for this vehicle type in watts. \- `default_reserve_time`
*(added in v2.3-RC)* | OPTIONAL | Non-negative Integer | Maximum time in minutes that a vehicle can be reserved before a rental begins. When a vehicle is reserved by a user the vehicle remains locked until the rental begins. During this time the vehicle is unavailable and cannot be be reserved or rented by other users. The vehicle status in `free_bike_status.json` MUST be set to `is_reserved = true`. If the value of `default_reserve_time` elapses without a rental beginning, the vehicle status MUST change to `is_reserved = false`. If `default_reserve_time` is set to `0` the vehicle type cannot be reserved. -\- `return_type`
*(added in v2.3-RC)*| OPTIONAL | Array | The conditions for returning the vehicle at the end of the trip. For vehicles that have more than one return option, include all applicable methods in the array.

Current valid values are: