Welcome to the CityBikes API documentation page. This is a brief explanation on how to use CityBikes data.
The system currently supports only JSON and HTML format
You can add a callback parameter to use it with JSONP
This call provides a list of the networks supported in CityBikes
This returns a JSON Array with a set of JSON objects with these variables:
- id: CityBikes id for this network
- name: Network idname
- lat: City Latitude
- lng: City Longitude
This call, given a system name id, provides the list of stations and availability
There are some variables that all systems share:
- id: CityBikes station id
- name: Station name
- lat: Latitude in E6 format
- lng: Longitude in E6 format
- bikes: Number of bikes in the station
- free: Number of free slots
- timestamp: The last time the station has been updated
And sometimes, there are Community Bike systems that provide more info than usual (for example in Wien). In these cases you will see more info in the feed, like:
- internal_id: The real station id
- description (an address..)
The point here is, use whatever available you need on the feed you use :)
Let's say you want to include the list of stations in your blog (who doesn't?). Just call the html, or render it inside an iframe
Terms of Service
CityBikes is a cost free service. However, it HAS a license (LGPL). Basically:
If your project is using this API (as in, doing calls), you should indicate it on your app, or website, linking the project page.
If your project is using PyBikes (as in, downloading the external data by yourself) you should also mention it.
Source, source, source
CityBikes API has an LGPL license.
Feel free to check the code @github
Examples using the API
CityBikes: Open Source App to display this information on android.