mapping-geojson-osm/docs/ajout_jeu_de_données.md

44 lines
1.9 KiB
Markdown

# 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
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`.