wololo/docs/ajout_jeu_de_données.md

# Ajout d'un jeu de données
Pour ajouter un jeu de données et sa conversion vous devrez faire un mapper et mettre le jeu de données dans le convertisseur.

Checklist:
- [] avoir un jeu de données de Points en Geojson à convertir, dans `etalab_data`, dans un dossier thématique (arbres, parking vélo, IRVE...).
- [] un convertisseur (Mapper) qui étend le type `MappingConfigType`
- [] une page de documentation markdown liée à ce jeu de données mentionnant une commande ts-node à lancer dans `docs`.
- [] noter l'url du jeu de données source dans `get_datasets.sh`
- [] ajouter l'import de ce Mapper dans `convert_to_osm_tags.ts`
- [] tester le rendu de la conversion en plaçant la sortie output dans JOSM.

## Récupérer un jeu de données
## Créer un Mapper
Version facile:
Utilisez le script `create_mapping.ts`, celui-ci vous posera quelques questions et se chargera d'ajouter la nouvelle classe dans le fichier principal de conversion.
`ts-node create_mapping.ts`

Version avancée:
Créer un fichier ts dans mappings/converters qui expose un objet étendant `MappingConfigType`. Ici on fait un Mappeur qui ne changera qu'une seule clé en gardant toutes ses valeur, nom_amenageur sera converti en name.

```ts

export const mappingName: MappingConfigType = {
    config_name: 'testing config mappingName',
    config_author: 'tykayn <contact+geojson2osm@cipherbliss.com>',
    default_properties_of_point: {},
    tags: {
        nom_amenageur : 'name'
    },
    add_not_mapped_tags_too: true,
    source: {
        geojson_path: '',
        url: ''
    },
    filters: {},
}
```
Le détail complet des configurations de MappingConfigType est à voir dans la page [configuration_de_conversion.md]

## Ajouter le Mapper dans le point d'entrée de conversion

Choisir le jeu de données en changeant la configuration dans `convert_to_osm_tags.ts`.
Importer son Mapper dans `convert_to_osm_tags.ts` et le faire charger dans l'[Engine](engine.md) dans la partie qui réalise le chargement d'un Mapper.
Ajouter le nom du mapper dans le tableau `allowed_configs`, puis remplir une condition pour que l'Engine prenne le bon modèle de mapping.


# Debug
activer les logs dans le fichier des `utils.ts`.