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, like mycompany-travelplanner or myname-citymonitor.
Endpoints
Auto discovery
Auto-discovery file that links to all of the other files published by the system.
Endpoint: gbfs.json (Documentation)
CURL request
curl -H "Client-Identifier: IDENTIFIER" https://gbfs.urbansharing.com/edinburghcyclehire.com/gbfs.json
Response
{
"data":{
"en":{
"feeds":[
{
"url":"https://gbfs.urbansharing.com/edinburghcyclehire.com/system_information.json",
"name":"system_information"
},
{
"url":"https://gbfs.urbansharing.com/edinburghcyclehire.com/station_information.json",
"name":"station_information"
},
{
"url":"https://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
Endpoint: system_information.json (Documentation)
CURL request
curl -H "Client-Identifier: IDENTIFIER" \ https://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
Endpoint: station_information.json (Documentation)
CURL request
curl -H "Client-Identifier: IDENTIFIER" \ https://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
Endpoint: station_status.json (Documentation)
CURL request
curl -H "Client-Identifier: IDENTIFIER" \ https://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"
}
]
}
}