mapping-geojson-osm/README.md

# Wololo! Conversion de jeux de données geojson en tags OSM
Ce dépot propose des outils de conversion et de mise en qualité de jeux de données à partir de geojson ou de csv afin de les importer dans OpenStreetMap.
Pour réaliser les conversions de jeux de données ce dépot propose un ensemble de déclarations dans un simple objet JS.

# installation
utiliser npm, yarn ou pnpm
```bash
pnpm i
```
## Tout convertir faire d'un coup
Pour récupérer le jeu de données pour les bornes elec et convertir le geojson en fichier osm, lancer le script bash
```bash
make irve
```

Export depuis overpass turbo dans OSM
https://overpass-turbo.eu/s/1yhY

## config  
Configurer le filtre de département et les autres options dans convert_to_osm_tags.ts.

## utilisation
Après avoir bien installé les paquets et récupéré un fichier Geojson de données ouvertes, vous devez avoir une configuration de conversion, puis lancer le script principal de conversion.
```bash
ts-node convert_to_osm_tags.ts
```
Plusieurs options sont disponible pour affiner la conversion:
``` 
--source=chemin/mon_fichier.geojson
--department=12 (aucun filtre de département par défaut)
--engine=true (true par défaut)
--engine-config=mappingIssy2Roues (mappingIRVE par défaut)
--output-file=autre_nom_de_sortie.json
```



La sortie est filtrée selon le mappage donné et la zone de code postal de la config.
Vous obtenez un résultat converti en json dans le dossier /output. Il s'agit toujours d'un Geojson mais nettoyé selon votre convertisseur, il peut ensuite être converti en fichier osm à ajouter dans JOSM.
Pour le convertir, utiliser geojsontoosm, une dépendance du projet.
` geojsontoosm mon_fichier_converti.json > le_fichier_pour_josm.osm`

Ce projet a été réalisé pour l'intégration des bornes de recharge élec dans OSM à partir des données data gouv.
## Exemple parkings 2 roues d'Issy les moulineaux
Fichier de mapping: `mappings/converters/configIssy_OpenData_2roues.ts`
Fichier de données: `etalab_data/cyclabilité/issy_les_mx_cyclabilité.json`
Commande de conversion: 
```bash 
ts-node convert_to_osm_tags.ts --source=etalab_data/cyclabilité/issy_les_mx_cyclabilité.json --o
utput-file=issy_parking_2roues.json --engine-config=mappingIssy2Roues
```
Résultat: `output/my_converted_data_set__mappingIssy2Roues.json`

# Projets d'intégrations de données
## Ajout d'un jeu de données et de sa conversion
[doc sur l'ajout d'un jeu de données](ajout_jeu_de_données.md)
## Tests
[doc sur les tests Jest](testing.md)

## Examen des jeux de données Osmose
Osmose permet la détection et suggestion de corrections de données dans OSM. On peut utiliser un export de ces données à la conversion d'un Mapper.
Pour cela, récupérez un jeu de données et utilisez le convertisseur Osmose de votre choix sur ces données afin d'en faire un nouveau jeu de données.
[doc sur l'ajout d'un jeu de données](ajout_jeu_de_données.md)

## Bornes de recharge - IRVE
Graphique des bornes de recharges à ajouter selon l'analyse Osmose:
[!https://osmose.openstreetmap.fr/en/issues/graph.png?item=8410](https://osmose.openstreetmap.fr/en/issues/graph.png?item=8410)

![graphique des bornes à ajouter](https://osmose.openstreetmap.fr/en/issues/graph.png?item=8410 "graphique")
* Tableau de conversion de l'open data:

https://wiki.openstreetmap.org/wiki/France/data.gouv.fr/Bornes_de_Recharge_pour_V%C3%A9hicules_%C3%89lectriques


# Ressources
Documentation website fait avec mkdocs:
`mkdocs serve` et aller sur http://localhost:8000

# Contactez l'auteur, contribuez
contact at cipherbliss.com
sur Mastodon : mastodon.cipherbliss.com/@tykayn

# Roadmap
## Correctifs sur les données ajoutées
## bornes de recharge
Corrections à mettre dans le mappeur [./mappings/converters/configIRVE.ts]() et à modifier par édition en masse dans JOSM.

* ne pas mettre ref si la valeur vaut "non concerné"
* convertir les "False" et "0" en "no" pour les clés
  * authentication:none
  * fee (désactivé, l'open data est trop pourrie pour l'utiliser)
  * socket:type2_cable
* convertir les numéros de téléphone avec un préfixe international +33 si commençant par 0

Données possible d'intégrer en plus avec le même jeu de données:
* ne pas mettre ref:EU:EVSE si la valeur vaut "non concerné"
* ajouter les références européennes ref:EU:EVSE.
* l'accessibilité => wheelchair pour certaines valeurs limitées.
 
## projets à venir
### Toilettes publiques
### Défibrillateurs - DAE
### Centres de santé
### Bus