Commit f49f0c52 authored by Blaise de Carné 's avatar Blaise de Carné

typo

parent bfa18ed4
Pipeline #49248 passed with stage
in 20 seconds
# Démarrage rapide
Afin d'utiliser l'API DATAtourisme, il est nécessaire de charger les données issues de la
[plateforme diffuseur](https://diffuseur.datatourisme.gouv.fr) dans une base de donnée sémantique. Cette section décrit
[plateforme diffuseur](https://diffuseur.datatourisme.gouv.fr) dans une base de données sémantiques. Cette section décrit
toutes les étapes nécessaires :
1. Récupération d'un fichier données
2. Mise en place d'une base de donnée Blazegraph
3. Chargement des données DATAtourisme dans la base de donnée
1. Récupération d'un fichier de données
2. Mise en place d'une base de données Blazegraph
3. Chargement des données DATAtourisme dans la base de données
4. Installation et utilisation de l'API
## Prérequis
......@@ -21,34 +21,39 @@ Pour vous servir de l'API DATAtourisme, vous devez d'abord récupérer des donn
1. Connectez-vous à la [plateforme diffuseur](https://diffuseur.datatourisme.gouv.fr). Il sera nécessaire de
créer un compte s'il s'agit de votre première connexion.
2. Créez et configurez un flux de donnée à l'aide de l'éditeur visuel de requête
3. Configurer le flux pour utiliser un format compatible avec l'API :
2. Créez et configurez un flux de données à l'aide de l'éditeur visuel de requête
3. Configurer le flux pour utiliser un format **compatible avec l'API** :
* RDF-XML
* Turtle
* NT
4. Téléchargez le fichier du flux une fois celui-ci disponible
Le fichier ainsi obtenu constitue votre source de donnée : il devra être chargé dans une base de donnée sémantique.
Le fichier ainsi obtenu constitue votre source de données : il devra être chargé dans une base de données sémantique.
## Mise en place d'une base de donnée Blazegraph
## Mise en place d'une base de données Blazegraph
[Blazegraph](http://www.blazegraph.com) est un système de gestion de base de données sémantique open-source. Il met
[Blazegraph](http://www.blazegraph.com) est un système de gestion de base de données sémantiques open-source. Il met
à disposition un point d'accès SPARQL permettant à l'API d'interroger son contenu pour répondre aux requêtes GraphQL.
La version JAR 2.1.5 de Blazegraph peut être téléchargée à l'adresse suivante : [blazegraph 2.1.5](https://github.com/blazegraph/database/releases/download/BLAZEGRAPH_RELEASE_CANDIDATE_2_1_5/blazegraph.jar)
La version JAR 2.1.5 de Blazegraph peut être téléchargée à l'adresse suivante :
[blazegraph 2.1.5](https://github.com/blazegraph/database/releases/download/BLAZEGRAPH_RELEASE_CANDIDATE_2_1_5/blazegraph.jar)
```bash
curl -L -o blazegraph.jar https://github.com/blazegraph/database/releases/download/BLAZEGRAPH_RELEASE_CANDIDATE_2_1_5/blazegraph.jar
```
Le lancement du serveur Blazegraph se fait simplement par :
```bash
java -jar blazegraph.jar
```
Le serveur blazegraph est alors lancé et son interface d'administration est accessible depuis l'adresse http://localhost:9999/
## Chargement des données
Le fichier téléchargé à l'étape précédente pouvant être de plusieurs types, les commandes pour charger les données dans Blazegraph peuvent varier :
Le fichier téléchargé à l'étape précédente pouvant être de plusieurs types, la commande pour charger les données dans Blazegraph peut varier :
```bash
# format RDF-XML (extension RDF)
curl -X POST -H 'Content-Type:application/rdf+xml' --data-binary '@fichier.rdf' http://localhost:9999/blazegraph/namespace/kb/sparql
......@@ -60,11 +65,11 @@ curl -X POST -H 'Content-Type:application/x-turtle' --data-binary '@fichier.ttl'
curl -X POST -H 'Content-Type:text/plain' --data-binary '@fichier.nt' http://localhost:9999/blazegraph/namespace/kb/sparql
```
Votre base de donnée sémantique est prête à être interrogée par l'API !
Votre base de données sémantiques est prête à être interrogée par l'API !
## Installation de l'API
La méthode recommandée pour installer l'API Datatourisme est d'utilisr [Composer](https://getcomposer.org/) :
La méthode recommandée pour installer l'API DATAtourisme est d'utilisr [Composer](https://getcomposer.org/) :
```bash
composer require datatourisme/api
......
......@@ -2,29 +2,28 @@
## Comment ça fonctionne ?
L'API Datatourisme est une librairie PHP permettant à l'utilisateur d'interroger facilement une base de donnée
sémantique contenant des données touristiques issues de la plateforme DATAtourisme. Elle s'appuie sur un language de
requête [GraphQL](https://graphql.org) dont le schéma de donnée est basé sur l'ontologie Datatourime.
L'API Datatourisme est une librairie PHP permettant à l'utilisateur d'interroger facilement une base de données
sémantiques contenant des données touristiques issues de la plateforme DATAtourisme. Elle s'appuie sur un language de
requête [GraphQL](https://graphql.org) dont le schéma de données est basé sur l'ontologie DATAtourisme.
Afin de mettre en oeuvre l'API, l'utilisateur doit donc :
1. Récupérer les données DATAtourisme au format sémantique sur la [plateforme diffuseur](https://diffuseur.datatourisme.gouv.fr)
2. Charger les données sémantiques dans une base de donnée sémantique (triplestore) disposant d'un point d'accès SPARQL
3. Utiliser l'API DATAtourisme pour soumettre les requêtes GraphQL à la base de donnée et récupérer les résultats
2. Charger les données sémantiques dans une base de données sémantiques (triplestore) disposant d'un point d'accès SPARQL
3. Utiliser l'API DATAtourisme pour soumettre les requêtes GraphQL à la base de données et récupérer les résultats
Il existe quelques implémentation open-source de base de donnée sémantiques :
Il existe quelques implémentations open-source de base de données sémantiques :
* [Blazegraph](https://www.blazegraph.com)
* [Virtuoso](https://github.com/openlink/virtuoso-opensource)
* [Jena/TDB](https://jena.apache.org/documentation/tdb/)
?> **A noter** : vous pouvez directement télécharger un environnement complet Docker incluant l'API, une base de donnée
?> **A noter** : vous pouvez directement télécharger un environnement complet Docker incluant l'API, une base de données
Blazegraph et des outils annexes à l'adresse suivante : https://framagit.org/datatourisme/docker-stack
!> **IMPORTANT** : L'API Datatourisme n'interroge pas directement la base de donnée nationale : elle vise à interroger
les données récupérée par l'utilisateur au travers de la [plateforme diffuseur](https://diffuseur.datatourisme.gouv.fr)
et chargées dans une base de donnée sémantique locale.
!> **IMPORTANT** : L'API DATAtourisme n'interroge pas directement la base de données nationale : elle vise à interroger
les données récupérées par l'utilisateur au travers de la [plateforme diffuseur](https://diffuseur.datatourisme.gouv.fr)
et chargées dans une base de données sémantiques locale.
## Utilisation de graphQL
......@@ -49,7 +48,7 @@ requête. Ainsi, la quantité de données interrogées et transférées est réd
}
}
```
Avec cette requête, la base de données sémantique est interrogée pour extraire l'URI, le nom et la description de
Avec cette requête, la base de données sémantiques est interrogée pour extraire l'URI, le nom et la description de
l'ensemble des POI q'elle contient. Le résultat au format JSON doit ressembler à :
```json
......
......@@ -14,9 +14,9 @@ privés.
Le projet DATAtourisme à pour mission de :
* **Aggréer** les données touristiques à partir des systèmes d'information touristique
* **Agréger** les données touristiques à partir des systèmes d'information touristique
* **Normaliser** les données par l'utilisation d'un vocabulaire touristique commun
* **Stocker** les données au sein d'une base de donnée nationale
* **Stocker** les données au sein d'une base nationale
* **Diffuser** les données auprès des réutilisateurs et diffuseurs d'information touristique
......@@ -30,7 +30,7 @@ Consortium W3C dans la perspective du Web sémantique ou Web de données (Linked
[En savoir plus sur le web sémantique](https://fr.wikipedia.org/wiki/Web_s%C3%A9mantique)
Il s'agit de structurer les points d'intérêt touristiques pour que les services tiers puissent mieux les exploiter.
Les données aggrégées par DATAtourisme sont ainsi restructurées , regroupée et enrichies par des traitements
Les données aggrégées par DATAtourisme sont ainsi restructurées , regroupées et enrichies par des traitements
automatiques et publiées selon le format descriptif du web sémantique : **RDF**.
[En savoir plus sur RDF](https://fr.wikipedia.org/wiki/Resource_Description_Framework)
......@@ -42,7 +42,7 @@ syntaxes RDF : RDF/XML, NTriple, Turtle, JSON-LD...
* **Une URI pour chaque point d'intérêt** : tous les points d'intérêt disposent d’identifiants pérennes, attribués
selon leur producteur.
* **Pour chaque point d'intérêt, un ensemble de propriétés** : associées à l’URI de la ressource et des sous-ressource
* **Pour chaque point d'intérêt, un ensemble de propriétés** : associées à l’URI de la ressource et des sous-ressources
sous forme de **triplets RDF**, selon les technologies du web sémantique et du linked open data.
## Ontologie
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment