facebook twitter instagram

Bienvenue sur la page Open Data du service Vélib' Métropole

 

Sur cette plateforme, vous avez accès aux données relatives à Vélib’ Métropole afin de comprendre et analyser le fonctionnement du service.

Vélib’ Métropole, ce sont plus de 1400 stations réparties sur une soixante de communes du Grand Paris et près de 400 km² desservis, soit le plus grand service de vélos partagés au monde incluant des vélos électriques rechargeables en station.

Les données mises à disposition sont des données de type dynamique permettant de suivre l’évolution du service en temps réel. Le moment de la dernière mise à jour est renseigné dans chaque base. Ces données vous permettront de connaître en temps réel le nombre de vélos mécaniques/électriques à chaque station ainsi que le nombre de bornettes libres.

Toutes les API proposées ici sont accessibles sans clé et au format JSON en UTF-8 en accord avec la RFC 4627. Ces jeux de données sont actualisés chaque minute selon la norme GBFS 1.0, standard pour la mise à disposition de flux d’informations pour des services de mobilité partagée.

 

 

Lience d'utilisation

Vélib’ Métropole a choisi de mettre à disposition ses données sous « Licence Ouverte / Open License ».

Cette licence a été conçue par la mission Etalab dans le cadre de la politique du Gouvernement en faveur de l’ouverture des données publiques (« Open Data »). Elaborée en concertation avec l’ensemble des acteurs concernés, elle vise à faciliter et encourager la réutilisation des données publiques mises à disposition gratuitement.

Le texte complet de la licence est disponible en version française et en version anglaise.

La « Licence Ouverte / Open License » présente les caractéristiques suivantes :

  1.  Une grande liberté de réutilisation des informations.
  • Une licence ouverte, libre et gratuite, qui apporte la sécurité juridique nécessaire aux producteurs et aux réutilisateurs des données publiques ;
  • Une licence qui promeut la réutilisation la plus large en autorisant la reproduction, la redistribution, l’adaptation et l’exploitation commerciale des données ;
  • Une licence qui s’inscrit dans un contexte international en étant compatible avec les standards des licences Open Data développées à l’étranger et notamment celles du gouvernement britannique (Open Government Licence) ainsi que les autres standards internationaux (ODC-BY, CC-BY 2.0).
  1. Une exigence forte de transparence de la donnée et de qualité des sources en rendant obligatoire la mention de la paternité.
  1. Une opportunité de mutualisation pour les autres données publiques en mettant en place un standard réutilisable par les collectivités territoriales qui souhaiteraient se lancer dans l’ouverture des données publiques.
La présentation de la « Licence Ouverte / Open License » ci-dessus ne constitue pas un contrat de licence en soit mais uniquement des éléments informatifs, seul le texte complet du contrat de licence fait foi.

 

 

Données

Pour connaître le nom du projet et son fuseau horaire :

 

La table system_information a le format suivant :

{
  "data": {
    "language": "string",
    "name": "string",
    "system_id": "string",
    "timezone": "string",
    "url": "string"
  },
  "lastUpdatedOther": 0,
  "ttl": 0
}
 
Avec :
  • language : langue utilisée dans l’ensemble des fichiers
  • name : nom du système
  • system_id : identifiant unique du système
  • timezone : zone horaire associée au système
  • url :adresse associée au système
  • lastUpdatedOther : date de dernière mis-à jour des informations de la ville
  • ttl : « time to live » , durée de vie de l’information au-delà de laquelle elle doit être considérée comme obsolète

 

Pour connaître les flux existants :

https://velib-metropole-opendata.smoove.pro/opendata/Velib_Metropole/gbfs.json

 

La table gbfs a le format suivant :

{
  "data": {
    "en": {
      "feeds": [
        {
          "name": "string",
          "url": "string"
        }
      ]
    }
  },
  "lastUpdatedOther": 0,
  "ttl": 0
}

 

Avec :

  • name : noms des bases 
  • url : adresse des différentes bases

 

Pour connaître le nombre de vélos et de bornettes disponibles par station :

https://velib-metropole-opendata.smoove.pro/opendata/Velib_Metropole/station_status.json

 

La table stations_status a le format suivant :

{
  "data": {
    "stations": [
      {
        "is_installed": 0,
        "is_renting": 0,
        "is_returning": 0,
        "last_reported": 0,
        "numBikesAvailable": 0,
        "numDocksAvailable": 0,
        "num_bikes_available": 0,
        "num_bikes_available_types": [
          {
            "ebike": 0,
            "mechanical": 0
          }
        ],
        "num_docks_available": 0,
        "station_id": 0
      }
    ]
  },
  "lastUpdatedOther": 0,
  "ttl": 0
}

 

Avec :

  • station_id : numéro unique d’identification de la station. Ce numéro identifie la station au sein du service Vélib’ Métropole
  • is_installed : variable binaire indiquant si la station est. La station a déjà été déployée (1) ou est encore en cours de déploiement (0) 
  • is_renting : variable binaire indiquant si la station peut louer des vélos (is_renting=1 si le statut de la station est Operative)
  • is_returning : variable binaire indiquant si la station peut recevoir des vélos (is_renting=1 si le statut de la station est Operative)
  • last_reported : date de la dernière mise-à-jour 
  • numBikesAvailable : nombre de vélos disponibles
  • numDocksAvailable : nombre de bornettes disponibles
  • num_bikes_available : nombre de vélos disponibles
  • num_bikes_available_types : nombre de vélos disponibles avec distinctions entre Vélib’ mécanique et électrique

 

Caractéristiques et localisation des stations Vélib’ ​:

https://velib-metropole-opendata.smoove.pro/opendata/Velib_Metropole/station_information.json

 

La table station_information a le format suivant :

{
  "data": {
    "stations": [
      {
        "capacity": 0,
        "lat": 0,
        "lon": 0,
        "name": "string",
        "station_id": 0
      }
    ]
  },
  "lastUpdatedOther": 0,
  "ttl": 0
}

 

Avec :

  • capacity : nombre de bornettes dans la station
  • lat : latitude de la station (au format WGS84)
  • lon : longitude de la station (au format WGS84)
  • name : nom de la station
  • station_id : identifiant unique associé à la station. Ce numéro identifie la station au sein du service Vélib’ Métropole

 

 

Exemple de requête et d'erreurs

Voici ci-après la requête à effectuer pour avoir les statuts des stations :

Requête statut des stations :

GET https://velib-metropole-opendata.smoove.pro/opendata/Velib_Metropole/station_status.json

Les messages d’erreurs les plus fréquents pour ces requêtes sont :

Type d’erreur Description Commentaire
Error 404 Page non trouvée L’orthographe de la requête est incorrecte
Error 502 Serveur inaccessible Le serveur est momentanément indisponible