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 près de 1 400 stations réparties sur 55 communes en Métropole 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.

 

Données

 

Pour connaître le nom du projet et son fuseau horaire :
 
https://velib-metropole-opendata.smoove.pro/opendata/Velib_Metropole/system_information.json 

 

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