Realtime data

Real time data is available in the GBFS format (General Bikeshare Feed Specification). More details are available on GitHub. The data is updated every 10 seconds.

The data is published under the Open Government Licence (OGL) v3.0

Identification in header

All requests to our real time API should send the "Client-Identifier" header. This should contain a value that describes the application accessing the API. The value should contain your company/organization name, follwed by a dash and the application's name.

Examples

  mycompany-travelplanner
myname-citymonitor

Endpoints

Auto discovery

Auto-discovery file that links to all of the other files published by the system.

CURL request


  curl -H "Client-Identifier: IDENTIFIER" \
    http://gbfs.urbansharing.com/edinburghcyclehire.com/gbfs.json
                  

Response

{
  "data":{
    "en":{
      "feeds":[
        {
          "url":"http://gbfs.urbansharing.com/edinburghcyclehire.com/system_information.json",
          "name":"system_information"
        },
        {
          "url":"http://gbfs.urbansharing.com/edinburghcyclehire.com/station_information.json",
          "name":"station_information"
        },
        {
          "url":"http://gbfs.urbansharing.com/edinburghcyclehire.com/station_status.json",
          "name":"station_status"
        }
      ]
    }
  },
  "ttl":10,
  "last_updated":1542035150
}

System

Machine readable basic information about Just Eat Cycles

CURL request


  curl -H "Client-Identifier: IDENTIFIER" \
    http://gbfs.urbansharing.com/edinburghcyclehire.com/system_information.json
                  

Response

{
  "last_updated": 1540309639,
  "ttl": 10,
  "data": {
    "system_id": "edinburgh-city-bikes",
    "language": "en",
    "name": "Just Eat Cycles",
    "operator": "SERCO",
    "timezone": "Europe/London",
    "phone_number": "+4401312783000",
    "email": "support@edinburghcyclehire.com"
  }
}

Stations

Information about all stations, including geolocation, addresses and descriptions

CURL request


  curl -H "Client-Identifier: IDENTIFIER" \
    http://gbfs.urbansharing.com/edinburghcyclehire.com/station_information.json
                  

Response

{
 "last_updated": 1540310074,
 "data": {
    "stations": [
       {
          "address": "Ocean Drive",
          "capacity": 25,
          "lon": -3.176351263805259,
          "name": "Ocean Terminal",
          "station_id": "285",
          "lat": 55.981286014792985
       },
       {
          "address": "Vanburgh Place",
          "capacity": 37,
          "lon": -3.1668846170233564,
          "name": "Leith Links",
          "station_id": "284",
          "lat": 55.96919856910954
       },
       {
          "address": "Near Waitrose Car Park Entrance",
          "capacity": 20,
          "lon": -3.2234280553759618,
          "name": "Waitrose, Comely Bank",
          "station_id": "277",
          "lat": 55.959504176688824
       }
     ]
   }
 }

Availability

Bike and dock availability

CURL request


  curl -H "Client-Identifier: IDENTIFIER" \
    http://gbfs.urbansharing.com/edinburghcyclehire.com/station_status.json
                  

Response

{
  "last_updated": 1540219230,
  "data": {
    "stations": [
      {
        "is_installed": 1,
        "is_renting": 1,
        "num_bikes_available": 7,
        "num_docks_available": 5,
        "last_reported": 1540219230,
        "is_returning": 1,
        "station_id": "175"
      },
      {
        "is_installed": 1,
        "is_renting": 1,
        "num_bikes_available": 4,
        "num_docks_available": 8,
        "last_reported": 1540219230,
        "is_returning": 1,
        "station_id": "47"
      },
      {
        "is_installed": 1,
        "is_renting": 1,
        "num_bikes_available": 4,
        "num_docks_available": 9,
        "last_reported": 1540219230,
        "is_returning": 1,
        "station_id": "10"
      }
    ]
  }
}

Historical data

You may also download anonymised trip records