doc: small corrections

nobohan 2021-10-27 14:04:22 +02:00
parent 51e157e182
commit d95dc64bd7
5 changed files with 27 additions and 20 deletions

@ -1,7 +1,7 @@
## Gestion des programmes
Dans l'interface d'administration, le troisième onglet, "Enquêtes", permet d'ajouter et de gérer les programmes d'observations de l'application. Cette accès ne permet pas de gérer les données encodées par les utilisateurs ou importées: pour cela, il faut utiliser la connexion avec QGIS ou directement via la base de données.
Dans l'interface d'administration, le troisième onglet, "Enquêtes", permet d'ajouter et de gérer les programmes d'observations de l'application. Cette accès ne permet pas de gérer les données encodées par les utilisateurs ou importées: pour cela, il faut utiliser la connexion avec QGIS ou directement via la base de données (cfr sections "Accès à la base de donnée" et "Interaction entre QGIS et la base de données").
L'interface d'administration est accessible via l'adresse "/api/admin". L'onglet "Enquêtes" se subdivise en 5 parties qui permettent d'ajouter ou d'éditer un programme:
@ -15,7 +15,7 @@ Ces onglets doivent être remplis dans cet ordre pour faire un programme car les
### 1) Projets
Création d'un projet. Un projet peut contenir plusieurs programmes. Il faut au moins un projet pour ajouter des programmes. Tous les programmes peuvent dépendre du même projet: lors du prototype, un seul projet a été créé.
Création d'un projet. Un projet peut contenir plusieurs programmes. Il faut au moins un projet pour ajouter des programmes. Tous les programmes peuvent dépendre du même projet.
### 2) Zones géographiques
@ -49,27 +49,29 @@ Au moment d'écrire ces lignes, il n'y a pas de documentation exhaustive pour co
- les "properties" définissent les données qui peuvent être encodées. Ces "properties" ont différents "types": string, integer, ...
- pour chaque "properties", le type de sélecteur puet être défini: "type": "select" avec un tableau de choix ("titleMap"), "type": "textarea", etc.
Pour créer ou modifier un formulaire, le plus facile est de partir d'un formulaire existant! On peut aussi valider le formulaire sur un site tel que <https://jsonlint.com/>.
NB: par défaut, les photos sont intégrées dans chaque rapport de visite, sans qu'il faille les ajouter au formulaire.
### 3b) Types de sites
Définition des types de sites. Chaque programme doit être qualifié par un ou plusieurs type de site. Par exemple, le programme "Bosquets, buissons, friches & lisières" est qualifié par les sites "Lisières", "Friches", "Buissons", "Bosquets".
Lors de l'ajout d'un site dans un programme, il est demandé de définir le type de site (avant l'encodage d'un rapport de visite).
Chaque type de site comporte un nom (sous "Type"), une catégorie ("Category"), un formulaire ("Custom Form") et en option un pictogramme.
Dans l'application, lors de l'encodage d'un site dans un programme, il est demandé de définir le type de site (avant l'encodage d'un rapport de visite).
### 4) Programmes
Définition des programmes d'observations. C'est l'entité finale qu'il faut définir pour voir apparaitre un programme dans l'application. Nous détaillons ici un programme de type "site":
- module: "sites" ou "observations"
- custom form: formulaire dynamique défini en 3a) pour les rapports de visites
- geometry: zone géographique défini en 2). Le programme ne pourra être utilisé que dans cette zone.
- geometry: zone géographique définie en 2). Le programme ne pourra être utilisé que dans cette zone.
- project: projet défini en 1).
- title: titre du programme, apparaissant dans l'application
- short desc: description courte, apparaissant dans l'application
- long desc: description longue. Celle-ci n'est pas utilisée dans l'application.
- long desc: description longue, apparaissant dans l'application
- geometry type: type de géométrie que l'on veut éditer. Cette géométrie peut être de 3 types: POINT, LINESTRING (ligne) ou POLYGON. Ce champ détermine le type d'encodage des géométries du programme. Il n'est pas possible de combiner plusieurs types de géométries dans un programme.
- image ou logo: chemin relatif ou absolu vers une image pour définir l'image du programme apparaissant en médaillon (voir Ajouter/changer une image d'un programme). Exemple: ../api/media/lisiere.jpg
- types de site: ajouter un ou plusieurs types de sites

@ -11,4 +11,6 @@ Pour changer l'image médaillon d'un programme, qui apparait lorsqu'on clique su
2) Indiquer l'url de l'image dans les settings du programme
Dans l'interface d'administration, aller sur Enquêtes > Programmes. Editer le programme voulu. Dans le champ Image, ajouter simplement: `../api/media/mon_image.jpg`, sans guillemets.
Dans l'interface d'administration, aller sur Enquêtes > Programmes. Editer le programme voulu. Dans le champ Image, ajouter simplement: `../api/media/mon_image.jpg`, sans guillemets.
NB: On peut directement utiliser une image servie dans un autre site web dans le champ "Image" du programme. Par exemple: `https://www.biommap.be/wp-content/uploads/ 2021/03/P1040581-scaled-e1615793514770.jpg`. Cela permet d'éviter de servir l'image (étape 1).

@ -3,9 +3,9 @@
## Introduction
Pour certains programmes, il est possible d'importer des données externes à GeoNature et de pouvoir les requalifier dans l'application GeoNature-citizen. L'intérêt est que cela permet de profiter d'un encodage déjà existant et qu'une partie des propriétés peuvent être directement importés, sans qu'il soit nécessaire de les mesurer/observer. Par exemple, nous avons importé des données issues du géoportail wallon indiquant les [arbres remarquables](http://geoportail.wallonie.be/catalogue/d594f5a3-34ac-4cc2-a357-aae5d5263f35.html) dans le programme "Arbres" de Biommap. Des propriétés telles que la hauteur de l'arbre et la circonférence ont pu être importées. Nous avons également investigué l'import de données OpenStreetMap (arbres et haies).
Pour certains programmes, il est possible d'importer des données externes à GeoNature et de pouvoir les requalifier dans l'application GeoNature-citizen. L'intérêt est que cela permet de profiter d'un encodage déjà existant et qu'une partie des propriétés peuvent être directement importées, sans qu'il soit nécessaire de les mesurer/observer. Par exemple, nous avons importé des données issues du géoportail wallon indiquant les [arbres remarquables](http://geoportail.wallonie.be/catalogue/d594f5a3-34ac-4cc2-a357-aae5d5263f35.html) dans le programme "Arbres" de Biommap. Des propriétés telles que la hauteur de l'arbre et la circonférence ont pu être importées. Nous avons également investigué l'import de données OpenStreetMap (arbres et haies).
A terme, cela permettrait d'améliorer des jeux de données existants, d'une part en ajoutant de nouveaux éléments et d'autre part en mettant à jour ou ajoutant des propriétés manquantes d'un élément existant. Biommap permet aussi de qualifier de manière plus riche ces données, notamment en permettant d'y ajoindre des photographies.
A terme, cela permettrait d'améliorer des jeux de données existants, d'une part en ajoutant de nouveaux éléments et d'autre part en mettant à jour ou ajoutant des propriétés manquantes d'un élément existant. Biommap permet aussi de qualifier de manière plus riche ces données, notamment en permettant d'y adjoindre des photographies.
## Fonctionnement du script d'import
@ -56,18 +56,23 @@ La donnée a été téléchargée via la page <http://geoportail.wallonie.be/cat
Pour mémoire, voici la liste des colonnes et la liste des valeurs correspondantes pour la table des sites:
\scriptsize
```
column_list = ['id_site', 'uuid_sinp', 'id_program', 'name', 'geom', 'timestamp_create', 'id_type', 'obs_txt']
values_list = ['__ID__', '__UUID__', '2', 'properties.SPFR', '__POINT__', '__NOW__', '1', 'géoportail wallon' ]
column_list = ['id_site', 'uuid_sinp', 'id_program', 'name', 'geom', 'timestamp_create', 'id_type', 'obs_txt']
values_list = ['__ID__', '__UUID__', '2', 'properties.SPFR', '__POINT__', '__NOW__', '1', 'géoportail wallon' ]
```
\normalsize
Voici la liste des colonnes et la liste des valeurs correspondantes pour la table des visites:
\scriptsize
```
column_list = ['id_site', 'json_data', 'timestamp_create', 'obs_txt']
values_list = ['__ID__', '__JSON__', '__NOW__', 'import']
column_list = ['id_site', 'json_data', 'timestamp_create', 'obs_txt']
values_list = ['__ID__', '__JSON__', '__NOW__', 'import']
```
\normalsize

@ -11,10 +11,8 @@ Une nouvelle page "tableau de bord" a été ajoutée à <https://biomap.champs-l
1) Données de base
2) Occupation du sol
3) Les linéaires
4) Les éléments isolés
5) Les éléments surfaciques
6) Le suivi via BiomMap (des données externes)
3) Les programmes
4) La biomasse
### Données du tableau de bord

@ -15,7 +15,7 @@ Ces points d'accès peuvent aussi être utilisés pour avoir, sans authentificat
- url: `api/programs`
- exemple: <https://biomap.champs-libres.be/api/programs>
Expose tous les programmes définis, mais sans les données (observations ou sites) de ces programmes. Peut-être utile pour retrouver l'id d'un programme afin de voir le détail du programme (point 2) ou ses observations ou sites (point 3).
Expose tous les programmes définis, mais sans les données (observations ou sites) de ces programmes. Peut être utile pour retrouver l'id d'un programme afin de voir le détail du programme (point 2) ou ses observations ou sites (point 3).
#### 2) Point d'API d'un programme
@ -45,10 +45,10 @@ Expose le détail d'un site. Comprend les photos (noms des fichiers uniquement)
Les données des sites peuvent être directement intégré 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.
![utilisation d'un point d'API dans QGIS](img/qgis-api.png)
![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".
Un projet QGIS avec ces points d'API a été préparé. Une capture d'écran de ce projet est dans la figure suivante:
![Projet QGIS "lecture biommap](img/qgis-lecture-projet.png)
![Projet QGIS "lecture biommap"](img/qgis-lecture-projet.png)