CityBikes API

Welcome to the CityBikes API documentation page. This is a brief explanation on how to use CityBikes data.

Syntax

The system currently supports only JSON and HTML format

You can add a callback parameter to use it with JSONP

http://api.citybik.es/<call>.<format>

Calls

Networks

This call provides a list of the networks supported in CityBikes

JSON

http://api.citybik.es/networks.jsonTest

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

HTML

http://api.citybik.es/networks.html

Result

System

This call, given a system name id, provides the list of stations and availability

JSON

http://api.citybik.es/<system>.json

http://api.citybik.es/ valenbisi.json sevici.json dublin.json cyclocity.json bizi.json velib.json velo.json veloh.json villo.json bicing.json cristolib.json cyclic.json velostanlib.json bicloo.json velocite.json barclays.json ecobici.json tusbic.json goteborg.json citycycle.json wien.json velcom.json mulhouse.json levelo.json cergy.json vhello.json velam.json velov.json bixi.json melbourne.json girocleta.json capitalbikeshare.json decobike.json niceride.json chicago.json denver.json desmoines.json sanantonio.json tobike.json hawaii.json bicikelj.json hangzhou.json boulder.json bikemi.json ambiciat.json mejorenbici.json palma.json bikla.json bicileon.json mainz.json chattanooga.json bysykkel.json rome.json venice.json tigullionbike.json toronto.json svd.json gandia.json bicidorm.json madison.json vlille.json albacete.json montilla.json puertobike.json ciudad_real.json villaquilambre.json cieza.json san_pedro.json almunecar.json las_palmas.json redondela.json badajoz.json soria.json salamanca.json bicielx.json villarreal.json lalin.json aranda_de_duero.json a_rua.json ubeda.json via_verde.json novelda.json aranjuez.json paiporta.json antequera.json el_campello.json don_benito_villanueva.json puerto_lumbreras.json san_javier.json o_barco.json baeza.json pinto.json alhama_de_murcia.json bicio.json palencia.json blanca.json sant_joan.json guadalajara.json priego_de_cordoba.json jaen.json universidad_de_granada.json talavera.json mula.json vinaros.json vigo.json Test

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
• status
• description (an address..)
• ...

The point here is, use whatever available you need on the feed you use :)

HTML

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

http://api.citybik.es/<system>.html

http://api.citybik.es/ valenbisi.html sevici.html dublin.html cyclocity.html bizi.html velib.html velo.html veloh.html villo.html bicing.html cristolib.html cyclic.html velostanlib.html bicloo.html velocite.html barclays.html ecobici.html tusbic.html goteborg.html citycycle.html wien.html velcom.html mulhouse.html levelo.html cergy.html vhello.html velam.html velov.html bixi.html melbourne.html girocleta.html capitalbikeshare.html decobike.html niceride.html chicago.html denver.html desmoines.html sanantonio.html tobike.html hawaii.html bicikelj.html hangzhou.html boulder.html bikemi.html ambiciat.html mejorenbici.html palma.html bikla.html bicileon.html mainz.html chattanooga.html bysykkel.html rome.html venice.html tigullionbike.html toronto.html svd.html gandia.html bicidorm.html madison.html vlille.html albacete.html montilla.html puertobike.html ciudad_real.html villaquilambre.html cieza.html san_pedro.html almunecar.html las_palmas.html redondela.html badajoz.html soria.html salamanca.html bicielx.html villarreal.html lalin.html aranda_de_duero.html a_rua.html ubeda.html via_verde.html novelda.html aranjuez.html paiporta.html antequera.html el_campello.html don_benito_villanueva.html puerto_lumbreras.html san_javier.html o_barco.html baeza.html pinto.html alhama_de_murcia.html bicio.html palencia.html blanca.html sant_joan.html guadalajara.html priego_de_cordoba.html jaen.html universidad_de_granada.html talavera.html mula.html vinaros.html vigo.html Show

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

Happy Hacking!

Source

CityBikes API has an LGPL license.

Feel free to check the code @github

Examples using the API

gmaps_helper.js: Javascript functions used in the main page to render the map

CityBikes: Open Source App to display this information on android.