gestionnaire-de-taches-simple/doc/tuto-projet/index.md

---
title: Tutoriel création de projet
date: 2024-09-02
---

On va voir ici comment créer un projet avec l’application en partant d’un
exemple simple et réel.

## Introduction

On souhaite cartographier les croix des bords de chemin dans le Beaujolais.
Circulant régulièrement dans le coin, on a établi une liste d’emplacements et
la description d’un certain nombre de ces édifices qui ne sont probablement
pas tous mappés dans OSM.

D’après le [wiki
OSM](https://wiki.openstreetmap.org/wiki/FR:Tag:historic%3Dwayside_cross) ce
genre de chose s’étiquette `historic=wayside_cross` ou `man_made=cross`.

On recherche dans Overpass `historic=wayside_cross or man_made=cross around
Villefranche-sur-Saône` ce qui donne la requête suivante :

```overpass
(
  node["historic"="wayside_cross"](around:10000,45.9864749,4.726611);
  node["man_made"="cross"](around:10000,45.9864749,4.726611);
);
```

On sait qu’il faudra tirer de notre description des monuments un cerain nombre
d’informations qui serviront à étiqueter les éléments à créer. Ici des nœuds.
Les étiquettes que l’on retient sont
[`inscription`](https://wiki.openstreetmap.org/wiki/FR:Key:inscription),
[`material`](https://wiki.openstreetmap.org/wiki/FR:Key:material) et
[`start_date`](https://wiki.openstreetmap.org/wiki/FR:Key:start_date).

[Le XML OSM](https://wiki.openstreetmap.org/wiki/FR:OSM_XML) à envoyer à JOSM
devra donc ressembler à quelque-chose comme :

```xml
<?xml version="1.0" encoding="UTF-8"?>
<osm version="0.6">
    <node id="-9" lat="…" lon="…" visible="true">
        <tag k="historic" v="wayside_cross"/>
        <tag k="material" v="…"/>
        <tag k="inscription" v="…"/>
        <tag k="start_date" v="…"/>
    </node>
</osm>
```

Dès lors on peut produire le fichier CSV des tâches à importer, dont voici l’intégralité :

```csv
name,description,osm,geojson,status
à Blacé,"Croix de fer forgé ajourée, sur table et socle pierre massif. Le socle porte l'inscription: ""PATER AVE / 40 JOURS D'INDULGENCE / 1896"". ","<?xml version=""1.0"" encoding=""UTF-8""?><osm version=""0.6""><node id=""-9"" lat=""46.02815836904756"" lon=""4.643540183466797"" visible=""true""><tag k=""historic"" v=""wayside_cross""/><tag k=""material"" v=""metal""/><tag k=""inscription"" v=""PATER AVE / 40 JOURS D'INDULGENCE / 1896""/><tag k=""start_date"" v=""1896""/></node></osm>","{""type"":""FeatureCollection"",""features"":[{""type"":""Feature"",""geometry"":{""coordinates"":[4.643540183466797,46.02815836904756],""type"":""Point""}}]}",todo
ã Rivolet,Grande croix de fer ajourée sur socle pierre. Une plaque métallique rivetée à la base de la croix porte la mention: « J. JURON / AN 1820 ». ,"<?xml version=""1.0"" encoding=""UTF-8""?><osm version=""0.6""><node id=""-9"" lat=""45.99655341186141"" lon=""4.616699908153549"" visible=""true""><tag k=""historic"" v=""wayside_cross""/><tag k=""material"" v=""metal""/><tag k=""inscription"" v=""J. JURON/AN 1820""/><tag k=""start_date"" v=""1820""/></node></osm>","{""type"":""FeatureCollection"",""features"":[{""type"":""Feature"",""geometry"":{""coordinates"":[4.616699908153549,45.99655341186141],""type"": ""Point""}}}",todo
```

On a inclus le GeoJSON ici mais il ne servira pas à grand chose dans le mesure
où les donnmées seront déjà chargées avec la télécommande via le XML OSM.

On ne met qu’un point par tâche ici pour l’exemple mais on pourrait très bien
imaginer en mettre plusieurs, tous dans un même carré ou dans les limites d’une
commune par exemple.

## Création du projet

Une fois connecté, ils est possible de créer un nouveau projet sur la page des
Projets.

![Créer un projet](illus-nouveau-projet.png)

On peut alors renseigner le formulaire avec les paramètres que l’on souhaite.

![Formulaire projet](illus-form-projet.png)

Champ | Valeur
-- | --
Nom | Croix du Beaujolais
Description | Pour faciliter l’ajouter des croix de bords de chemin près de chez nous.
Hashtags | AdopteUneCommune
Source | survey
Imagerie | `osmfr`
Overpass | `(node["historic"="wayside_cross"](around:10000,45.9864749,4.726611);node["man_made"="cross"](around:10000,45.9864749,4.726611););`

La **description** accepte le [Markdown](https://fr.wikipedia.org/wiki/Markdown),
On peut donc y mettre un peu ce que l’on veut, genre des liens, des tableaux,
des images, etc.

Les **hashtags** sont des mots séparés par des espaces. Ça sert à construire le
commentaire suggéré pour le groupe de modification. Cf [le wiki
OSM](https://wiki.openstreetmap.org/wiki/FR:Bons_commentaires_de_groupe_de_modifications).

Pour le moment le commentaire suggéré est composé du nom du projet, du nom de
la tâche et des hashtags fournis.

La **source** sert également pour la suggestion lors de l’envoi des données dans
JSOM. Cf [le wiki OSM](https://wiki.openstreetmap.org/wiki/FR:Key:source).

Ici on met `survey` comme source parce que l’on part de nos observations.

L’**imagerie** est celle que l’on souhaite voir chargée dans JOSM via la
télécommande.

Enfin le champ **Overpass** contient le bout de requête qui nous sert à
visualiser ce que l’on souhaite voir apparaître avec ces contributions.

Les **étiquettes** de projet ne sont pas utilisées pour le moment mais permettront
à terme de les catégoriser.

Il ne reste plus qu’à cliquer sur le bouton « Créer » pour créer le projet.

![Projet créé](illus-projet-cree.png)

On peut maintenant ajouter des tâches dans le projet. Pour commencer cliquons
sur « Voir le détail ».

## Import des tâches

On vient de créer le projet et il est vide.

![Pas de tâche, pas de carte.](illus-projet-vide.png)

Pour importer des tâches, il suffit d’utiliser l’outil « Importer des tâches »
et de charger le fichier CSV constitué plus tôt.

![Importer des tâches](illus-importer-taches.png)

Les tâches devraient apparaître sur la carte.

![Les nouvelles tâches apparaissent](illus-nouvelles-taches.png)

Notons que l’on peut cliquer sur l’outil « Requête Overpass » pour charger les données existantes dans OSM également sur la carte.

Le zoom de la carte est réglé sur les tâches et pas sur les données Overpass.
Dans notre cas, pour voir la différence il faut un peu zommer en arrière car il
y a peu de tâches.

![Dézoomer pour mieux voir les données existantes](illus-dezoom-overpass.png)

Et voilà, prêt à contribuer collaborativement !