outils_OSM/README.md

# RDOO

Récupération de Données OSM via Overpass

## Prérequis
`pip3 install requests`

`pip3 install pyexcel-ods3`


## But
Ce script sert à récupérer (en JSON et tableau ods) les infos de stationnement vélo, d'ateliers, d'associations, vendeurs, réparateurs et fabricants de vélo.

Il appelle Overpass par des requêtes successives et récupère les tags des objets OSM.

Un géocodage inverse permet de transformer latitude et longitude en adresses.

## Options
### Zone géographique
`-z, --zone`, définit la zone cible du script, par défaut le Puy-de-Dôme.
L'identifiant des objets s'obtient depuis la carte openstreetmap.org :
- clic-droit dans la zone concernée
- interroger les objets
- choisir la relation dans les « Objets englobants »
- noter l'ID

Examples :
- Puy de Dôme : 7406
- Clermont : 110866

### Géocodage inverse
`-gi, --geocoding-inverse`, activer le géocodage inverse (valeur par défaut)

`-ngi, --no-geocoding-inverse`, désactiver le géocodage inverse

### Log
`-l, --log-level`, choisir le niveau de log (INFO par défaut)

### Dossiers de résultats et d'archivage
`-r, --dossier-resultats`, pour indiquer le dossier d'enregistrement des JSON et ods (par défaut `resultats/`)

`-a, --dossier-archive`, pour indiquer le dossier d'archivage des JSON et ods (par défaut `resultats/archives/`). L'archivage crée un sous-dossier daté de la date des fichiers à archiver.

Ces chemins sont relatifs à `rdoo.py`, il est possible de passer des chemins absolus comme `/home/user/rdoo/archives/`. Attention à ne pas oublier le `/` final !

Il est possible de ne pas archiver en passant l'argument `-na, --no-archive`.

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

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

## Inspirations / ressources :
### urls ressources
- https://towardsdatascience.com/loading-data-from-openstreetmap-with-python-and-the-overpass-api-513882a27fd0
- https://geo.api.gouv.fr/adresse
- https://wiki.cartocite.fr/doku.php?id=umap:10_-_je_valorise_les_donnees_openstreetmap_avec_umap
- https://sites-formations.univ-rennes2.fr/mastersigat/Cours/Intro_Overpass.pdf

### usage des tags :
- https://taginfo.openstreetmap.org/tags/?key=amenity&value=bicycle_parking#combinations

### exemple URL données pour umap :
- https://www.velocite63.fr/velocite63/OSM/stationnements_velos_publics.json
penser à cocher "proxy" dans la rubrique "données distantes" du calque

### export ODS :
- https://pythonhosted.org/pyexcel-ods/


## Licence
Ce script est placé sous Licence GPL.
renommage du script principal 2021-10-23 19:56:20 +02:00			`# RDOO`

			`Récupération de Données OSM via Overpass`

close #9 documenter json avec umap 2021-11-06 19:45:19 +01:00			`## Prérequis`
			`pip3 install requests`

			`pip3 install pyexcel-ods3`


renommage du script principal 2021-10-23 19:56:20 +02:00			`## But`
#2 ajout d'une option pour la zone géographique 2021-10-22 22:09:41 +02:00			`Ce script sert à récupérer (en JSON et tableau ods) les infos de stationnement vélo, d'ateliers, d'associations, vendeurs, réparateurs et fabricants de vélo.`
ajout d'un README sommaire 2021-10-21 22:36:08 +02:00
ajout d'une option pour le géocodage inverse 2021-10-22 22:35:56 +02:00			`Il appelle Overpass par des requêtes successives et récupère les tags des objets OSM.`

			`Un géocodage inverse permet de transformer latitude et longitude en adresses.`

renommage du script principal 2021-10-23 19:56:20 +02:00			`## Options`
			`### Zone géographique`
fix #10 options pour les répertoires de résultats et d'archive 2021-10-24 08:24:41 +02:00			`-z, --zone`, définit la zone cible du script, par défaut le Puy-de-Dôme.
#2 ajout d'une option pour la zone géographique 2021-10-22 22:09:41 +02:00			`L'identifiant des objets s'obtient depuis la carte openstreetmap.org :`
			`- clic-droit dans la zone concernée`
			`- interroger les objets`
			`- choisir la relation dans les « Objets englobants »`
			`- noter l'ID`

			`Examples :`
Mise à jour de 'README.md' 2021-10-22 22:27:17 +02:00			`- Puy de Dôme : 7406`
			`- Clermont : 110866`
#2 ajout d'une option pour la zone géographique 2021-10-22 22:09:41 +02:00
renommage du script principal 2021-10-23 19:56:20 +02:00			`### Géocodage inverse`
ajout d'une option pour le géocodage inverse 2021-10-22 22:35:56 +02:00			`-gi, --geocoding-inverse`, activer le géocodage inverse (valeur par défaut)

			`-ngi, --no-geocoding-inverse`, désactiver le géocodage inverse

description de l'option de log 2021-10-23 19:55:12 +02:00			`### Log`
loglevel par défaut à INFO 2021-10-23 22:11:11 +02:00			`-l, --log-level`, choisir le niveau de log (INFO par défaut)
renommage du script principal 2021-10-23 19:56:20 +02:00
fix #10 options pour les répertoires de résultats et d'archive 2021-10-24 08:24:41 +02:00			`### Dossiers de résultats et d'archivage`
			`-r, --dossier-resultats`, pour indiquer le dossier d'enregistrement des JSON et ods (par défaut `resultats/`)

			`-a, --dossier-archive`, pour indiquer le dossier d'archivage des JSON et ods (par défaut `resultats/archives/`). L'archivage crée un sous-dossier daté de la date des fichiers à archiver.

			Ces chemins sont relatifs à `rdoo.py`, il est possible de passer des chemins absolus comme `/home/user/rdoo/archives/`. Attention à ne pas oublier le `/` final !

			Il est possible de ne pas archiver en passant l'argument `-na, --no-archive`.

close #9 documenter json avec umap 2021-11-06 19:45:19 +01:00			`## 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`.

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

renommage du script principal 2021-10-23 19:56:20 +02:00			`## Inspirations / ressources :`
ajout d'un README sommaire 2021-10-21 22:36:08 +02:00			`### urls ressources`
#2 ajout d'une option pour la zone géographique 2021-10-22 22:09:41 +02:00			`- https://towardsdatascience.com/loading-data-from-openstreetmap-with-python-and-the-overpass-api-513882a27fd0`
			`- https://geo.api.gouv.fr/adresse`
			`- https://wiki.cartocite.fr/doku.php?id=umap:10_-_je_valorise_les_donnees_openstreetmap_avec_umap`
			`- https://sites-formations.univ-rennes2.fr/mastersigat/Cours/Intro_Overpass.pdf`
ajout d'un README sommaire 2021-10-21 22:36:08 +02:00
			`### usage des tags :`
#2 ajout d'une option pour la zone géographique 2021-10-22 22:09:41 +02:00			`- https://taginfo.openstreetmap.org/tags/?key=amenity&value=bicycle_parking#combinations`
ajout d'un README sommaire 2021-10-21 22:36:08 +02:00
			`### exemple URL données pour umap :`
#2 ajout d'une option pour la zone géographique 2021-10-22 22:09:41 +02:00			`- https://www.velocite63.fr/velocite63/OSM/stationnements_velos_publics.json`
ajout d'un README sommaire 2021-10-21 22:36:08 +02:00			`penser à cocher "proxy" dans la rubrique "données distantes" du calque`

			`### export ODS :`
#2 ajout d'une option pour la zone géographique 2021-10-22 22:09:41 +02:00			`- https://pythonhosted.org/pyexcel-ods/`
Mise à jour de 'README.md' 2021-10-22 07:53:59 +02:00

renommage du script principal 2021-10-23 19:56:20 +02:00			`## Licence`
merge Readme 2021-10-22 22:15:38 +02:00			`Ce script est placé sous Licence GPL.`