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

datastore_getfileformats

Présentationdatastore_getfileformats

Cette commande permet de récupérer la liste complète des formats de fichier disponibles en téléchargement sur le site "Open Data" de la Ville de Nantes et de Nantes Métropole (ou NOD).

URL d'appeldatastore_getfileformats

Voici l'url d'appel de la commande :

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

Paramètres d'entréedatastore_getfileformats

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

Exemples d'appeldatastore_getfileformats

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/datastore_getfileformats/1.0/39W9VSNCSASEOGV

Exemple d'appel pour un retour JSON :

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

Résultat en sortiedatastore_getfileformats

Exemple de flux XML en sortie :

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<opendata>
  <request>data.nantes.fr/api/datastore_getfileformats/1.0/39W9VSNCSASEOGV</request>
  <answer>
    <status code="0" message="OK"/>
    <data>
      ...
      <fileformat>
        <id>2</id>
        <name>CSV</name>
        <description></description>
        <mimetype>text/csv</mimetype>
        <extension>csv</extension>
        <picto>csv.png</picto>
        <sorting>1152</sorting>
      </fileformat>
      <fileformat>
        <id>4</id>
        <name>KMZ</name>
        <description>Keyhole Markup Language Zipped</description>
        <mimetype>application/vnd.google-earth.kmz</mimetype>
        <extension>kmz</extension>
        <picto>kmz_v2.png</picto>
        <sorting>1512</sorting>
      </fileformat>
      ...
    </data>
  </answer>
</opendata>