documentation requêtes perso

README.md

@@ -49,9 +49,10 @@ Il est possible de ne pas archiver en passant l'argument `-na, --no-archive`.
 Les tags peuvent être traduits grâce au fichier `traductions.json` contenant la configuration sous la forme `"clef" : "tableau_de_valeurs"` où la clef est la valeur du tag OSM à traduire et le tableau de valeurs est de la forme `"valeur" : "traduction"`. Le fichier par défaut contient l'exemple de la traduction du tag `"bicycle_parking"`.
 
 ## Umap
-Les fichiers json générés peuvent être directements utilisés dans [umap](https://umap.openstreetmap.fr/fr/) en les [important](https://wiki.openstreetmap.org/wiki/FR:UMap/Guide/Importer_un_fichier_de_donn%C3%A9es) et choisissant le format de données `osm`.
+[Utilisation avec Umap](docs/umap.md)
 
-Si vous disposez d'un serveur pour héberger le script ou ses résultats, le lien du fichier peut être utilisé directement dans umap comme `données distantes` d'un calque, en cochant `dynamique` et `avec proxy`.
+## Requêtes personnalisées
+[Requêtes personnalisées](docs/requetes_perso.md)
 
 ## Inspirations / ressources :
 ### urls ressources

docs/requetes_perso.md

@@ -0,0 +1,32 @@
+## Requêtes personnalisées
+
+Les requêtes sont stockées dans le fichier [requetes.json](../configuration/requetes.json) qui contient un tableau de requêtes.
+
+### Requêtes
+```json
+"fontaines": {
+    "commentaire": "champ de texte libre",
+    "overpass": "nwr[\"amenity\"=\"fountain\"](area:aire_de_recherche);",
+    "champs_generiques": [
+        "CHAMPS_POI",
+        "CHAMPS_ADRESSE"
+    ],
+    "champ_local": ""
+}
+```
+Un bloc de requête commence par son nom et nécessite obligatoirement :
+- la chaîne de recherche `overpass` (penser à échapper les `"` avec `\`) ([overpass turbo](https://overpass-turbo.eu/), [wiki Overpass_QL](https://wiki.openstreetmap.org/wiki/FR:Overpass_API/Overpass_QL))
+- les `champs_generiques` utilisés, qui contiennent les informations de tags osm ou géocodage
+- le `champ_local` utilisé.
+
+Il peut aussi contenir un `commentaire` qui ne serait pas interprété par rdoo.
+
+### Champs
+Les champs génériques sont stockées dans le fichier [champs_generiques.json](../configuration/champs_generiques.json) et sont divisés en 3 blocs :
+- `CHAMPS_STATIONNEMENT` pour les tags liés au stationnement vélo
+- `CHAMPS_POI` pour les tags liés aux informations classiques (nom, description, moyens de contact, addresse)
+- `CHAMPS_ADRESSE` pour les tags correspondant au géocodage inversé via Etalab.
+
+
+### Traduction
+Les traductions sont stockées dans le fichier [traductions.json](../configuration/traductions.json), le tag à traduire est suivi d'un tableau de correspondance des valeurs à traduire.

docs/umap.md

@@ -0,0 +1,11 @@
+## Utilisation avec Umap
+
+### Import
+Les fichiers json générés peuvent être directements utilisés dans [umap](https://umap.openstreetmap.fr/fr/) en les [important](https://wiki.openstreetmap.org/wiki/FR:UMap/Guide/Importer_un_fichier_de_donn%C3%A9es) et choisissant le format de données `osm`.
+
+![configuration import](umap_import.png)
+
+### Distant
+Si vous disposez d'un serveur pour héberger le script ou ses résultats, le lien du fichier peut être utilisé directement dans umap comme `données distantes` d'un calque, en cochant `dynamique` et `avec proxy`, au format de données `osm`.
+
+![configuration distante](umap_distant.png)