update utilisation API

nobohan 2022-09-19 16:11:24 +02:00
parent dccb158829
commit 03e91f7418
2 changed files with 6 additions and 6 deletions

@ -4,9 +4,9 @@
## Utilisation via l'API
L'application GeoNature-citizen expose les données des programmes, des observations et des sites au travers de points d'API pour le fonctionnement de l'application.
L'application GeoNature-citizen expose les données des programmes, des observations et des sites au travers de points d'API pour le fonctionnement de l'application.
Ces points d'accès peuvent aussi être utilisés pour avoir, sans authentification requise, un accès direct aux données.
Ces points d'accès peuvent aussi être utilisés pour avoir, sans authentification requise, un accès direct aux données.
### Détails de points d API les plus utiles
@ -30,24 +30,24 @@ Expose le détail d'un programme, comme dans le point d'API précédent, sans le
- url: `api/sites/programs/{id}`
- exemple: <https://biomap.champs-libres.be/api/sites/programs/1>
Expose tous les sites encodés d'un programme. Donne un geojson valide qui peut être utilisé dans QGIS.
Expose tous les sites encodés d'un programme. Donne un geojson valide qui peut être utilisé dans QGIS.
#### 4) Point d'API du détail d'un site
- url: `api/sites/{id}`
- exemple: <https://biomap.champs-libres.be/api/sites/1>
Expose le détail d'un site. Comprend les photos (noms des fichiers uniquement) et tous les rapports de visites qui contiennent les informations rentrées par les utilisateurs dans le formulaire des visites.
Expose le détail d'un site. Comprend les photos (noms des fichiers uniquement) et tous les rapports de visites qui contiennent les informations rentrées par les utilisateurs dans le formulaire des visites.
### Utilisation de ces points d'API avec QGIS
Les données des sites peuvent être directement intégrées dans un projet QGIS. Ajouter une couche vectorielle au projet en tant que fichier en spécifiant l'adresse du point d'API des sites d'un programme, par exemple https://biomap.champs-libres.be/api/sites/programs/1. La figure suivante montre une capture d'écran de cet ajout.
Les données des sites peuvent être directement intégrées dans un projet QGIS. Ajouter une couche vectorielle au projet en tant que fichier en spécifiant l'adresse du point d'API des sites d'un programme, par exemple https://biomap.champs-libres.be/api/sites/programs/1. La figure suivante montre une capture d'écran de cet ajout. Conseil: dans les options d'ajout de la couche, mettre l'argument FLATTEN_NESTED_ATTRIBUTES à "Oui" pour disposer des rapports de visites dans des champs séparés et non pas dans un seul champ json.
![Utilisation d'un point d'API dans QGIS](img/qgis-api.png)
Ces points d'API de données par programme sont en lecture seule. Un projet QGIS peut donc être partagé avec ces points d'API sans risquer que l'utilisateur modifie les données. Pour utiliser QGIS en ayant la possibilité d'éditer les données, voir le point "Interaction QGIS - base de données".
Ces points d'API de données par programme sont en lecture seule. Un projet QGIS peut donc être partagé avec ces points d'API sans risquer que l'utilisateur modifie les données. Pour utiliser QGIS en ayant la possibilité d'éditer les données, voir le point "Interaction QGIS - base de données".
Un projet QGIS avec ces points d'API a été préparé. Une capture d'écran de ce projet est dans la figure suivante:

Binary file not shown.

Before

Width:  |  Height:  |  Size: 83 KiB

After

Width:  |  Height:  |  Size: 115 KiB