accéder au contenu principal de la page

Documentation de l'API

Documentation de l'API
Retrouvez en détails la documentation précisant le fonctionnement de l'API version 2 de data.nantes.fr

Commande "getDisponibiliteParkingsPublics"
Cette commande permet de récupérer les informations concernant la disponibilité des parkings publics de l'agglomération nantaise.

Commande "getFluiditeAxesRoutiers"
Cette commande retourne les indicateurs de fluidité du trafic sur les tronçons routiers.

Commande "getInfoTraficTANPrevisionnel"
Cette commande permet de récupérer l'info trafic prévisionnel des bus et tramway de la SEMITAN.

Commande "getInfoTraficTANTempsReel"
Cette commande permet de récupérer l'info trafic en temps réel des bus et tramway de la SEMITAN

Commande "getTempsParcours"
Indication des temps de parcours en minutes sur chaque itinéraire.

Commandes "datastore"
Cet ensemble de commandes regroupe les fonctionnalités d'interrogation du catalogue de données.
   • datastore_searchdatasets
   • datastore_getdatasets
   • datastore_getagencies
   • datastore_getfileformats
   • datastore_getlicences

getFluiditeAxesRoutiers

PrésentationgetFluiditeAxesRoutiers

Cette API renvoie un indicateur de fluidité du trafic routier sur un tronçon. Elle doit être utilisée avec le jeu de données donnant la liste des tronçons routiers (et leur géolocalisation dans les fichiers géographiques). Ainsi, une information de fluidité est associée à une poly-ligne de forme et de longueur variable.

URL d'appelgetFluiditeAxesRoutiers

L'url d'appel de la commande est la suivante :

http://data.nantes.fr/api/getFluiditeAxesRoutiers/1.0/XXXXXXXXXXXXXXX

Paramètres d'entréegetFluiditeAxesRoutiers

Aucun paramètre d'entrée n'est nécessaire pour cette commande.

Exemples d'appelgetFluiditeAxesRoutiers

Ces exemples sont basés sur une clé de démonstration qu'il convient d'utiliser uniquement dans le but de prendre connaissance du fonctionnement de l'API ou pour effectuer des tests.

Pour une utilisation réelle des API à disposition sur le site d'ouverture des données de Nantes Métropole, merci d'ouvrir un compte utilisateur et d'enregistrer votre application. Une clé d'API personnelle vous sera alors attribuée.

Exemple d'appel pour un retour XML :

data.nantes.fr/api/getFluiditeAxesRoutiers/1.0/39W9VSNCSASEOGV

Exemple d'appel pour un retour JSON :

data.nantes.fr/api/getFluiditeAxesRoutiers/1.0/39W9VSNCSASEOGV/

Résultat en sortiegetFluiditeAxesRoutiers

Exemple de flux XML en sortie :

<?xml version="1.0" encoding="UTF-8"?>
<opendata>
 
<request>data.nantes.fr/api/getFluiditeAxesRoutiers/1.0/39W9VSNCSASEOGV</request>
 
<answer>
   
<status code="0" message="OK"/>
   
<data>
     
<Troncons>
         
<Horodatage>2012-03-09T17:26:03</Horodatage>
         
<Troncon>
           
<Id>13</Id>
           
<Couleur_TP>6</Couleur_TP>
         
</Troncon>
         
<Troncon>
           
<Id>5014</Id>
           
<Couleur_TP>5</Couleur_TP>
         
</Troncon>
         ...
     
</Troncons>
   
</data>
 
</answer>
</opendata>

 

Les éléments de ce flux XML sont décrits ci-dessous :

Elément

Description

Exemple

Horodatage

Timestamp de mesure pour lequel les données sont fournies

2012-03-09T17:26:03

Id

Identifiant du tronçon

13

Couleur_TP

Code couleur permettant de définir la fluidité du trafic routier
0 : violet
1 : gris (sans indication)
2 : blanc (données manquantes ou erronées)
3 : vert (fluide)
4 : jaune (dense)
5 : orange (saturé)
6 : rouge (bloqué)

6