Releases: MobilityData/gbfs
v3.1-RC
MINOR release - Backwards compatible with v3.0
What's Changed
manifest.json (updated)
area (new) is a GeoJSON MultiPolygon that describes the operating area (#572).
country_code (new) is the ISO 3166-1 alpha-2 country code of the operating area (#572).
system_pricing_plans.json (updated)
reservation_price_per_min (new) is the cost, described as per minute rate, to reserve the vehicle prior to beginning a rental (#457).
reservation_price_flat_rate (new) is the cost, described as a flat rate, to reserve the vehicle prior to beginning a rental (#457).
Contributors
Full Changelog: v3.0...v3.1-RC
Contributors
Assets 2
v3.0
Released April 11, 2024
Modified April 11, 2024
MAJOR Release - not backwards compatible.
What's Changed
For all files
Timestamps MUST now be strings in RFC3339 format (eg: 2024-01-24T12:52:40+01:00) (#522).
IDs MUST now be in the ASCII printable character range, space excluded, and SHOULD be restricted to A-Z, a-z, 0-9 and .@:/_- (eg: D9:N_c) (#545).
Enum values MUST now be lowercase (eg: bicycle) (#474).
gbfs.json (updated)
last_updated (updated) is now a string in RFC3339 format (eg: 2024-01-24T12:52:40+01:00) (#522).
manifest.json (new)
This new endpoint is an index, required for publishers of feeds for multiple cities (#462).
gbfs_versions.json (updated)
last_updated (updated) is now a string in RFC3339 format (eg: 2024-01-24T12:52:40+01:00) (#522).
system_information.json (updated)
last_updated (updated) is now a string in RFC3339 format (eg: 2024-01-24T12:52:40+01:00) (#522).
languages (new) allows to list the languages used in Localized Strings (required) (#460).
name (updated) is now an Array of Localized Strings (#460).
opening_hours (new) allows to specify the hours and dates of operation for the system (required). It replaces system_hours.json and system_calendar.json (#328).
short_name (updated) is now an Array of Localized Strings (#460).
operator (updated) is now an Array of Localized Strings (#460).
termination_date (new) allows to notify data consumers of a permanent (non-seasonal) shutdown of the feeds (#497).
phone_number (updated) is now in E.164 format (#351).
feed_contact_email (updated) is now required (#454).
manifest_url (new) allows pointing to the manifest.json file (#462).
license_id (new) allows to specify if the dataset is provided under a standard license (#182).
license_url (updated) is now required if the dataset is provided under a customized license (#182).
attribution_organization_name (new) and attribution_url (new) allow to specify if the feed license requires attribution (#182).
terms_url (updated) is now an Array of Localized Strings (#460).
privacy_url (updated) is now an Array of Localized Strings (#460).
vehicle_types.json (updated)
last_updated (updated) is now a string in RFC3339 format (eg: 2024-01-24T12:52:40+01:00) (#522).
form_factor (updated) enum no longer allows the value scooter. It was replaced by scooter_standing and scooter_seated (#370).
eco_labels (updated) replaces eco_label (#559).
name (updated) is now an Array of Localized Strings (#460).
make (updated) is now an Array of Localized Strings (#460).
model (updated) is now an Array of Localized Strings (#460).
description (new) allows to add a description of the vehicle type outlining special features or how-tos (#470).
station_information.json (updated)
last_updated (updated) is now a string in RFC3339 format (eg: 2024-01-24T12:52:40+01:00) (#522).
name (updated) is now an Array of Localized Strings (#460).
short_name (updated) is now an Array of Localized Strings (#460).
station_opening_hours (new) allows to specify the hours of operation for the station (#328).
vehicle_types_capacity (updated) is now an Array of Objects to model the parking capacity of virtual stations for each vehicle type. It replaces vehicle_capacity (#547).
vehicle_docks_capacity (updated) is now an Array of Objects to model the docking capacity of a station for each vehicle type. It replaces vehicle_type_capacity (#547).
station_status.json (updated)
last_updated (updated) is now a string in RFC3339 format (eg: 2024-01-24T12:52:40+01:00) (#522).
num_vehicles_available (updated) replaces num_bikes_available (#354).
num_vehicles_disabled (updated) replaces num_bikes_disabled (#354).
vehicle_status.json (updated) (formerly free_bike_status.json)
This endpoint replaces free_bike_status.json (#354).
last_updated (updated) is now a string in RFC3339 format (eg: 2024-01-24T12:52:40+01:00) (#522).
vehicles (updated) replaces bikes (#354).
vehicle_id (updated) replaces bike_id (#354).
rental_uris.[android,ios,web] (updated) vehicle identifiers within deep links MUST now be rotated after each rental to avoid unintentionally exposing private vehicle trip origins and destinations (#247).
system_hours.json (removed)
This endpoint was replaced by the field opening_hours in system_information.json.
system_calendar.json (removed)
This endpoint was replaced by the field opening_hours in system_information.json.
system_regions.json (updated)
last_updated (updated) is now a string in RFC3339 format (eg: 2024-01-24T12:52:40+01:00) (#522).
name (updated) is now an Array of Localized Strings (#460).
system_pricing_plans.json (updated)
last_updated (updated) is now a string in RFC3339 format (eg: 2024-01-24T12:52:40+01:00) (#522).
name (updated) is now an Array of Localized Strings (#460).
price (updated) may now only be a Non-Negative Float (eg: 1.50) (#352).
description (updated) is now an Array of Localized Strings (#460).
system_alerts.json (updated)
last_updated (updated) is now a string in RFC3339 format (eg: 2024-01-24T12:52:40+01:00) (#522).
url (updated) is now an Array of Localized Strings (#460).
summary (updated) is now an Array of Localized Strings (#460).
description (updated) is now an Array of Localized Strings (#460).
geofencing_zones.json (updated)
last_updated (updated) is now a string in RFC3339 format (eg: 2024-01-24T12:52:40+01:00) ([#522](https://github.co...
Contributors
Assets 2
v3.0-RC2
Released November 14, 2023
Modified November 14, 2023
MAJOR Release - not backwards compatible.
New features:
#497 - New Field - termination_date
#522 - Field Type - RFC3339 for Timestamp
#542 - Field Name - vehicle_type_ids in geofencing zones
#545 - Field Type - Character range for ID
#546 - Field Type - Float for interval in system pricing plans
#547 - Data Structure - vehicle_types_capacity and vehicle_dock_capacity
#559 - Field Name - eco_labels plural in vehicle types
v3.0-RC
Released March 10, 2023
Modified April 12, 2023
MAJOR Release - not backwards compatible.
New features:
#182 - Require license_url, add attribution fields
#247 - Required rotation of deeplinks vehicle identifier
#328 - Change to OSM Opening Hours format for times and dates
#351 - Add Phone Number to Field Types
#352 - Remove string field type from price field
#354 - Semantic Changes: Bike becomes Vehicle
#370 - Extending vehicle_types.json
#384 - File requirements and Clarifying changes
#407 - Changes to data structures
#454 - Feed_contact_email required
#457 - Reservation price
#460 - Internationalization of free-form text
#462 - New endpoint - manifest.json
#470 - Add description to vehicle_types
#474 - Require lowercase enums
#481 - Geofencing refactor
v2.3
Released April 5, 2022.
Updated April 29, 2022
MINOR release - Backwards compatible with v2.0, v2.1, v2.2
New Features:
- #329 - Add vehicle drop off restrictions
- #330 - Adding vehicle icons & brand information
- #331 - Reserve time for vehicle types and pricing plans
- #335 - Add pricing plans to vehicle types
- #336 - Add fields for terms and privacy policy
- #340 - Add field to designate stations that support vehicle charging
- #349 - Add optional station_parking rule to
geofencing_zones.json - #350 - Carsharing extension
- #370 - Extending
vehicle_types.json - #386 - Versioning and Long Term Support
- #400 - Changes to
return_typesfield
v2.2
v2.1
v1.1
Released March 16, 2020.
Updated April 26, 2022
MINOR release - Backwards compatible with v1.0
New features:
v2.3-RC2
Released January 31, 2022.
Updated March 28, 2002
MINOR release - Backwards compatible with v2.0, v2.1, v2.2
New Features: