accéder au contenu principal de la page

Documentation de l'api V1

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


Les commandes associées :

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

getInfoTraficTANTempsReel

PrésentationgetInfoTraficTANTempsReel

Cette commande permet de récupérer l'info trafic en temps réel des bus et tramway de la SEMITAN. Les travaux et déviations sont indiqués accompagnés des dates et heures de début et fin de perturbation.

URL d'appelgetInfoTraficTANTempsReel

Voici l'url d'appel de la commande :

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

Paramètres d'entréegetInfoTraficTANTempsReel

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

Exemples d'appelgetInfoTraficTANTempsReel

Ces exemples sont basés sur une clé de démonstration qu'il ne convient pas de réutiliser autrement qu'à but de prise de connaissance du fonctionnement de l'API ou à but de tests.

Pour une utilisation réelle des API offertes par le site Open Data 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/getInfoTraficTANTempsReel/1.0/39W9VSNCSASEOGV

Exemple d'appel pour un retour JSON :

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

Résultat en sortiegetInfoTraficTANTempsReel

Exemple de flux XML en sortie :

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<opendata>
 
<request>data.nantes.fr/api/getInfoTraficTANTempsReel/1.0/39W9VSNCSASEOGV</request>
 
<answer>
   
<status code="0" message="OK"/>
   
<data>
     
<ROOT>
       
<LISTE_INFOTRAFICS>
         
<INFOTRAFIC>
           
<CODE>97344996</CODE>
           
<LANGUE>0</LANGUE>
           
<INTITULE>Travaux secteur République à
            Nantes
</INTITULE>
           
<RESUME>En raison de travaux rue Babin Chevaye à
            Nantes, l'itinéraire de la ligne 58 et du circuit
            B est modifié, entre les arrêts
            République et Hangar à Bananes, dans
            les 2 sens.
</RESUME>
           
<TEXTE_VOCAL>En raison de travaux rue Babin Chevaye
            à Nantes, l'itinéraire de la ligne 58
            et du circuit B est modifié, entre les
            arrêts République et Hangar
            à Bananes, dans les 2 sens.
</TEXTE_VOCAL>
           
<DATE_DEBUT>25/07/2011</DATE_DEBUT>
           
<DATE_FIN>25/12/2011</DATE_FIN>
           
<HEURE_DEBUT>06:00</HEURE_DEBUT>
           
<HEURE_FIN />
           
<PERTURBATION_TERMINEE>0</PERTURBATION_TERMINEE>
           
<TRONCONS>[58/-/-/-];[B/-/-/-]</TRONCONS>
         
</INFOTRAFIC>
          ...
       
</LISTE_INFOTRAFICS>
     
</ROOT>
   
</data>
 
</answer>
</opendata>

 

Voici la description des éléments de ce flux XML :

Elément

Description

Exemple

CODE

Code de l’info trafic

97344996

LANGUE

Langue (0 = français)

0

INTITULE

Intitulé de l’info trafic

Travaux secteur République à Nantes

RESUME

Résumé

En raison de travaux rue Babin Chevaye ... dans les 2 sens.

TEXTE_VOCAL

Texte vocal

En raison de travaux rue Babin Chevaye ... dans les 2 sens.

DATE_DEBUT

Date de début de perturbation

25/07/2011

DATE_FIN

Date de fin de perturbation

25/12/2011

HEURE_DEBUT

Heure de début de perturbation

06:00

HEURE_FIN

Heure de fin de perturbation

 

PERTURBATION_TERMINEE

Flag

0

TRONCONS

Tronçons concernés

<tt>[58/-/-/-];[B/-/-/-]</tt>