Les données RDF de l'Insee peuvent être utilisées dans le cadre d'applications extérieures. Pour une utilisation intensive, il est recommandé de télécharger les exports RDF/Turtle qui sont mis à disposition sur les différentes pages thématiques de ce site, et de les charger dans une base RDF locale comme OpenRDF Sesame ou Apache Jena TDB.
Pour une utilisation plus ponctuelle, il est possible d'utiliser directement les données
mises en ligne par l'INSEE, au travers de requêtes HTTP. La plate-forme Datalift de
publication des données prend en charge les mécanismes standard de négociation de contenu
afin de servir les données au format attendu par le client HTTP. Outre les formats HTML
requis par les navigateurs, de nombreux formats d'utilisation applicative plus aisée sont
supportés, suivant les types de requêtes, notamment (entre parenthèses, des valeurs
correspondantes de l'en-tête HTTP 'Accept') :
application/rdf+xml, application/xml,
text/xml),
application/json, application/sparql-results+json),text/turtle, application/x-turtle),text/n3, text/rdf+n3, application/n3),
text/csv, application/csv).
Si aucune négociation de contenu n'est effectuée (en-tête 'Accept' absent de la
requête HTTP), le format RDF/XML est renvoyé par défaut.
On peut mentionner deux types de requêtes HTTP, la seconde étant en fait une forme simplifiée de la première :
Dans le premier cas, une requête SPARQL est passée comme valeur du paramètre
'query' dans une requête GET sur le point d'entrée SPARQL. La façon
habituelle d'opérer est d'inclure le paramètre dans l'URI sur laquelle se fait la requête
HTTP. Cet URI a donc pour forme :
http://rdf.insee.fr/sparql?query=[requête SPARQL URL-encodée]
Par exemple pour la requête SPARQL SELECT * WHERE { ?s ?p "42" } :
http://rdf.insee.fr/sparql?query=SELECT%20*%20WHERE%20%7B%20?s%20?p%20%2242%22%20%7D
Les résultats de la requête SPARQL sont retournés dans le contenu de la réponse HTTP.
Il est à noter que le point d'accès SPARQL supporte la syntaxe SPARQL 1.1, mais seulement en lecture : toute requête de mise à jour des données sera donc rejetée.
Dans le cas du déréférencement d'URI, la requête HTTP est faite directement sur l'URI de la ressource cherchée, par exemple :
http://id.insee.fr/geo/departement/42
La plate-forme Datalift renvoie dans ce cas une description générique de la ressource,
c'est-à-dire la liste des triplets RDF dans lesquels elle intervient comme sujet ou objet :
l'opération est en fait équivalente à la soumission d'une requête SPARQL de type
DESCRIBE sur l'URI de la ressource. Là encore, la négociation de contenu peut
être utilisée pour obtenir les triplets au format souhaité.
On trouvera ici un exemple très simple de page web permettant de rechercher un code dans la Nomenclature d'activités française (NAF) et d'obtenir le libellé correspondant. Le langage utilisé est dans ce cas Javascript, et le format de réponse demandé est donc JSON. Ce dernier permet une programmation extrêmement compacte ; les instructions essentielles sont :
var code = document.getElementById('code').value.trim().toUpperCase();
var query = "prefix skos: <http://www.w3.org/2004/02/skos/core#> select ?libelle from <http://rdf.insee.fr/graphes/codes/nafr2> ";
query += "where {?s skos:notation \"" + code + "\" . ?s skos:prefLabel ?libelle filter(lang(?libelle) = 'fr')}";
var url = "http://rdf.insee.fr/sparql?query=" + encodeURIComponent(query);
$.getJSON(url).success(function(data) {
$('#resultat').html("<p>" + code + " - " + data.results.bindings[0].libelle.value + "</p>");
})
La structure JSON des résultats de requêtes SPARQL est spécifiée dans cette note du W3C.
Ce script Python montre comment exécuter une requête SPARQL, en l'occurrence pour obtenir la liste des trois départements les moins peuplés en 2010. Là aussi, c'est le format JSON qui est utilisé pour la réponse. Ce script est disponible pour la version 2.7 et pour la version 3.3 de Python.
Pour signaler vos applications utilisant les données RDF de l'Insee et contribuer à cette page d'exemples, envoyez un message à publication-rdf@insee.fr.