Le portail OpenData possède plusieurs APIs:
- Une API qui regroupe des méthodes d'actions sur l'ensemble des données du portail.
Ex: opendata.nicecotedazur.org/data/api/3/action/package_search?q=ecole.
Plus d'information
- Une API qui regroupe des méthodes d'actions sur les données tabulaires des fichiers CSV et XSL du portail.
Ex: opendata.nicecotedazur.org/data/api/3/action/datastore_search?resource_id=41307c5b-2b51-4aeb-b6d5-d418a981943b
Plus d'information
Exemple d'utilisation en javascript:
$.ajax({type: 'GET',url: "http://opendata.nicecotedazur.org/data/api/3/action/package_list",dataType: 'json',success: function(data){
$.each(data.result, function(key, value){console.log(value);});}});
Exemple d'utilisation en PHP:
<?php$result = file_get_contents("http://opendata.nicecotedazur.org/data/api/3/action/package_list");$result = json_decode($result);foreach($result->result as $value) {echo $value . '<br/>';}?>
Le portail Open Data de Nice Côte d’Azur utilise plusieurs formats de données:
- Les tableurs :
- CSV : fichier contenant les données tabulaire sous forme de valeurs séparé par des virgules
- XSL : tableur de la suite bureautique Microsoft Office
- ODS : tableur de la suite Open Office
- Les données structurées : XML, KML, JSON, GeoJSON
- Les documents textuels : PDF, DOC, ODT, PPT, ODP
- Les archives de fichier : ZIP
- Les fichiers du SIG (Système d’Information Géographique): SHP, WMS
- Les APIs (interface de programmation, contenant un ensemble normalisé de classe, fonctions ou méthodes, qui sert de façade pour récupérer des données provenant d’un service)
Le format GeoJSON :
Le format GeoJSON est un format d’encodage d’ensemble de données géospatiales simples utilisant la norme JSON. Il permet de décrire des données de type point, ligne, chaîne de caractères, ainsi que des ensembles et sous-ensembles de ces types de données et d’y ajouter des attributs d’information qui ne sont pas spatiales. Nous l’utilisons pour la visualisation des données géographiques avec la bibliothèque logicielle libre de cartographie Leaflet.
Exemple de code GeoJSON:
{ "type": "FeatureCollection","features": [{"type": "Feature","geometry": {"type": "Point", "coordinates": [102.0, 0.5]},"properties": {"Name": "Métropole Nice Côte d’Azur","Address" : "06364 Nice CEDEX 4"}},{ "type": "Feature","geometry":"type": "LineString","coordinates": [[102.0, 0.0], [103.0, 1.0], [104.0, 0.0], [105.0, 1.0]]},"properties": {"Name": "Avenue Jean Medecin"}},{ "type": "Feature","geometry": {"type": "Polygon","coordinates": [[ [100.0, 0.0], [101.0, 0.0], [101.0, 1.0],[100.0, 1.0], [100.0, 0.0] ]]},"properties": {"Name": "Arenas"}}]}
Voici un exemple de code en javascript pour récupérer un catalogue des jeu de données en .rdf:
<html><head><script src="http://code.jquery.com/jquery-1.11.0.min.js"></script><script type="text/javascript">$.ajax({type: 'GET',url: "http://opendata.nicecotedazur.org/data/api/3/action/package_list",dataType: 'json',success: function(data){$.each(data.result, function(key, value){$("#rdf").append("<a href='http://opendata.nicecotedazur.org/data/dataset/"+value+".rdf'>"+value+"</a><br/>");});}});</script></head><body><div id="rdf"></div></body></html>
Pour cela il suffit de rajouter .rdf à l'URL du jeu de données et le téléchargement se fera automatiquement.
Exemple:
URL d'un jeu de données: opendata.nicecotedazur.org/data/dataset/voies-principales-de-la-metropole-nice-cote-d-azur
URL du fichier rdf du jeu de données: opendata.nicecotedazur.org/data/dataset/voies-principales-de-la-metropole-nice-cote-d-azur.rdf
Les organisations correspondent à des espaces spécifiques dans lesquels se trouvent rangés les jeux de données, il s'agit du nom de la commune ou du nom du partenaire qui met à disposition de la donnée.
Il est possible, une fois connecté, de s'abonner à l'organisation (par exemple : Ville de Nice) afin de suivre la mise à jour de ses jeux de données ou la publication de ses nouveaux jeux de données.
À partir du moment où vous téléchargez les données publiées par la collectivité, vous acceptez automatiquement les conditions d'utilisation et d'exploitation des données précisées dans la licence. Cela implique de respecter certains engagements, comme la mention de la paternité des données ou la date de dernière mise à jour. Cela veut dire aussi que le réutilisateur est responsable de l'utilisation qu'il fait de la donnée.
Chaque ressource peut être pré-visualisée. Bien évidemment,il ne s'agit pas d'une prévisualisation de toutes les ressources, car il existe énormément de formats de fichier.
Si la ressource possède une possibilité de datavisualisation, vous pouvez l'inclure dans votre site Internet sous forme de code « embed » ou code embarqué.
Ce code est disponible sur la page de la ressource du jeu de données, dans les informations additionnelles et en cliquant sur « montrer plus ». Il suffit juste de copier ce code html, et de l’ajouter dans votre page Internet.
