outils_OSM/README.md

77 lines
2.9 KiB
Markdown
Raw Normal View History

2021-10-23 19:56:20 +02:00
# RDOO
Récupération de Données OSM via Overpass
2021-11-06 19:45:19 +01:00
## Prérequis
`pip3 install requests`
`pip3 install pyexcel-ods3`
2021-10-23 19:56:20 +02:00
## 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.
2021-10-21 22:36:08 +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.
2021-10-23 19:56:20 +02:00
## 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 :
2021-10-22 22:27:17 +02:00
- Puy de Dôme : 7406
- Clermont : 110866
2021-10-23 19:56:20 +02:00
### 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
2021-10-23 19:55:12 +02:00
### Log
2021-10-23 22:11:11 +02:00
`-l, --log-level`, choisir le niveau de log (INFO par défaut)
2021-10-23 19:56:20 +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`.
2021-12-29 20:50:24 +01:00
### Traductions
Les tags peuvent être traduits grâce au fichier `traductions.json` contenant la configuration sous la forme `"clef" : "tableau_de_valeurs"` où la clef est la valeur du tag OSM à traduire et le tableau de valeurs est de la forme `"valeur" : "traduction"`. Le fichier par défaut contient l'exemple de la traduction du tag `"bicycle_parking"`.
2021-11-06 19:45:19 +01:00
## Umap
2021-12-30 11:18:10 +01:00
[Utilisation avec Umap](docs/umap.md)
2021-11-06 19:45:19 +01:00
2021-12-30 11:59:29 +01:00
## Requêtes personnalisées
[Requêtes personnalisées](docs/requetes_perso.md)
2021-10-23 19:56:20 +02:00
## Inspirations / ressources :
2021-10-21 22:36:08 +02:00
### 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
2021-10-21 22:36:08 +02:00
### usage des tags :
- https://taginfo.openstreetmap.org/tags/?key=amenity&value=bicycle_parking#combinations
2021-10-21 22:36:08 +02:00
### exemple URL données pour umap :
- https://www.velocite63.fr/velocite63/OSM/stationnements_velos_publics.json
2021-10-21 22:36:08 +02:00
penser à cocher "proxy" dans la rubrique "données distantes" du calque
### export ODS :
- https://pythonhosted.org/pyexcel-ods/
2021-10-22 07:53:59 +02:00
2021-10-23 19:56:20 +02:00
## Licence
2021-10-22 22:15:38 +02:00
Ce script est placé sous Licence GPL.