A quick & dirty API to locate the nearest Velib stations in Paris. I'm going to use it for a Pebble smartwatch app but you can do whatever you want with it :)

Velibs are the free bike system in Paris. There's a ridiculously simplistic official API for accessing the data so I decided to build this also quite simplistic API but that returns data not accessible otherwise: the closest stations to a point. I needed that to make a Pebble app that would give me the address of the closest station near me.

This "API" is basically just a wrapper for a MySQL query that is using the Haversine formula (http://en.wikipedia.org/wiki/Haversine_formula) to get the closest Velib stations to the point specified in the call.

You need to inject the sql dump from the sql/ directory in a database and create a conf.php file that must contain the following info :

$dns = 'mysql:host=localhost;dbname=XXX'; $user = 'YYY'; $pass = 'ZZZ'; $jcdApiKey = 'APIKEY';

The three first variables are used for the PDO connection to the database and the last is the API key to connect to the JCDecaux API that will give you access to the stations availability infos (more details on https://developer.jcdecaux.com)

Ex: http://api.kovaxlabs.com/velib/api.php?position=48.9,2.37&limit=5&distance=1

"position" is a lat,lng format point "limit" is the number of results you want to retrieve "distance" is the radius around the point to locate the stations (in km)

The data come from JCDecaux official website (https://developer.jcdecaux.com/#/opendata/vls?page=static), I did correct the errors contained in the CSV file and will most likely clean the capitalization soon because it annoys me.

Cet script PHP vous permet de créer très simplement une API de géolocalisation de stations de Velib. Il suffit de l'appeler avec les coordonnées d'une position pour qu'elle vous renvoie les stations les plus proches. Elle nécessite d'importer dans une base de données les infos des stations. Ensuite c'est l'API JCDecaux qui donne accès aux données temps réels d'occupation de la station. Vous devez donc créer une clé d'API sur le site de JCDecaux pour cela.