Skip to content

Latest commit

 

History

History
93 lines (79 loc) · 3.09 KB

Additions to GBFS.md

File metadata and controls

93 lines (79 loc) · 3.09 KB
Raw

Additions to GBFS

Sharedmobility.ch is based on the General Bikeshare Feed Specification (GBFS) Version 2.0. GBFS is optimized to represent one single system. In order to represent multiple systems in one feed, the following additions to GBFS V2.0 were made:

⚠️ Additions were only made to GBFS 2.0 endpoint. Please use GBFS 2.3 which is 100% GBFS compliant!

Add providers.json

Providers.json was added as an additional JSON-File to the GBFS-Feed. Providers.json describes metainformation of every system. Fields are identical to system_information.json. The following fields were added:

  • provider_id was added (see also List of shared mobility providers).
  • vehicle_type is added. The following vehicle types are possible: Bike, E-Bike, CargoBike, E-CargoBike, Scooter, E-Scooter, Moped, E-Moped, Car, E-Car, Taxi, E-Taxi, Other, E-Other

Changes in station_information.json

  • The field station_id comprises the merged fields provider_id and station_id
  • provider_id is added to stations as followed:
{
 "last_updated" : 1605098383,
 "ttl" : 60,
 "version" : "2.0",
 "data" : {
   "stations" : [ {
     "station_id" : "carvelo2go:e4d4f78a-861d-49a9-c216-be6e288dec5a",
     "name" : "8610 im Stadtpark ",
     "lat" : 47.34867,
     "lon" : 8.71413,
     "address" : "Landihalle",
     "region_id" : "carvelo2go:936ccc56-80e6-441f-959b-da5747118c61",
     "post_code" : "8610",
     "provider_id" : "carvelo2go"
   }

Changes in station_status.json

  • The field station_id comprises the merged fields provider_id and station_id
  • provider_id is added to stations as followed:
{
 "last_updated" : 1605098165,
 "ttl" : 60,
 "version" : "2.0",
 "data" : {
   "stations" : [ {
     "station_id" : "donkey_thun:17447",
     "num_bikes_available" : 0,
     "num_docks_available" : 25,
     "last_reported" : 1605096513,
     "provider_id" : "donkey_thun"
   }

Changes in free_bike_status.json

  • The field bike_id comprises the merged fields provider_id and bike_id
  • provider_id is added to bikes as followed:
{
 "last_updated" : 1605099018,
 "ttl" : 60,
 "version" : "2.0",
 "data" : {
   "bikes" : [ {
     "bike_id" : "airbie-6759c:IszKSTulW6rLO0cJ",
     "lat" : 47.17566,
     "lon" : 8.515347,
     "is_disabled" : 0,
     "is_reserved" : 0,
     "provider_id" : "airbie-6759c"
   }

Changes in geofencing_zones.json

  • provider_id is added to the properties of a geofencing zone as followed:
"properties" : {
  "name" : "Bond Zürich",
  "rules" : [
    {
      "ride_allowed" : "true",
      "ride_trough_allowed" : "true"
    }
 ],
 "provider_id" : "bond_ch"
}

Differences

  • According to GBFS V2 the field bike_id in free_bike_status.json has to be rotated to a random string, at a minimum, after each trip to protect privacy. This is not fully supported by all providers.