FR:Downloading data
Il est possible de télécharger les données cartographiques à partir du jeu de données OpenStreetMap de différentes manières. La base de données complète est disponible dans la partie téléchargement du site OpenStreetMap. Il est également possible de sélectionner des aires plus petites. Les données sont sous la forme de fichiers .osm au format XML. Pour simplement utiliser une « carte » (ex : pour un appareil GPS) ce n’est probablement pas la meilleure approche, voir les autres options de téléchargement des données OpenStreetMap.
À noter :
- La planète représente un nombre important de données. Commencez par une région permet de s’assurer que l’installation fonctionne correctement. Des outils tel que Osmosis ou des utilitaires d’importation de base de données peuvent mettre des heures voire des jours pour importer les données en fonction des performances matérielles.
- OpenStreetMap est un projet fédératif. La majorité des ressources essentielles sont prodiguées par des sources tierces où il est préférable de s’orienter en priorité. Les serveurs officiels ne sont pas de grands centres de données et ont des ressources limitées servant principalement au support du flux de données.
Toutes les données
Planet.osm contient la planète entière. C’est une image des données, datant généralement du dernier mercredi. Cela représentait 100 GB de données compressées en 2020 qui continue de grossir.
L’historique de la planète contient l’historique des éléments et est encore plus lourd.
La méthode la plus simple et rapide de télécharger la planète est d’utiliser un client Bittorrent.
Autrement, il est possible d’utiliser l’outil download-osm de OpenMapTiles pour télécharger la planète à partir de multiples sources simultanément sans surcharger le serveur principal. L’outil s’assure de la vérification du hash MD5 et peut également servir à télécharger et vérifier des données régionales à partir de Geofabrik, BBBike, et OSM.fr.
La méthode la plus simple d’utiliser l’outil est à l’aide de Docker. Tout argument après -- est passée à aria2c. Un exemple de commande sous Linux/Mac, qui devrait être similaire sous Windows :
docker run --rm -it -v $PWD:/download openmaptiles/openmaptiles-tools \
download-osm planet -- -d /download
Pour la documentation, utiliser download-osm --help.
Quantités importantes de données
Plusieurs jeux de données permettent de télécharger des lots de la taille d’un continent à une partie de pays. Osmosis, osmconvert et osmfilter permettent d’en extraire des données spécifiques.
XAPI, Overpass API et l’l’outil d’export permettent de télécharger des jeux de données personnalisés tels que zones délimitées de façon arbitraire, des clés spécifiques, etc…
Faibles quantités de données
Voir Processed data providers, en particulier le service d’extraction personnalisé de BBBike.org.
Outils dédiés
Overpass API, Overpass Turbo est un outil très utile décrit sur sa propre page.
Il est possible de télécharger toutes les données d’une zone ou d’utiliser des filtres.
L’onglet export permet de sélectionner une partie de la carte à télécharger en différents formats dont OSM XML. La fonction est intentionnellement limitée à des niveaux de zoom élevé.
Pour des modifications
L’API principal peut être utilisé pour télécharger des données en vue de modification.
Une opération basique de l’API OpenStreetMap est la requête 'map' (Voir la documentation). De plus, l’API principal permet de télécharger les éléments au format XML incluant leur historique. Étant dédiée à la modification nous vous demandons de ne pas l’utiliser pour des requêtes en masse très consommatrices en ressources. Pour ça, utiliser Overpass API ou XAPI.
L’interface JOSM permet de sélectionner, télécharger et visualiser une zone. Il est alors possible de modifier les données pour le téléverser ultérieurement. Il est également possible de sauvegarder les données au format .osm (format de fichier JOSM). Basée sur l’API principal, les même restrictions s’appliquent.
L’usage de l’API (en particulier le téléchargement de zones délimitées) est soumis à notre charte d’utilisation de l’API. Un usage important (ou d’un nombre important de personnes) doit utiliser une des alternatives ci-dessus.
Choisir une région
La région est délimitée par une boîte englobante, qui est la combinaison de latitudes et longitudes minimales et maximales. Une zone plus petite représente un fichier plus léger, un temps de téléchargement réduit et moins de charge pour les serveurs. Ces derniers peuvent rejeter votre requête si celle-ci est plus grande que ¼ de degré.
Il existe différentes manières de trouver la latitude et la longitude. Pour une boîte englobante, la manière la plus simple est d’utiliser la fonction de sélection de l’onglet d’export. Sur la page principale cliquer sur le bouton 'Exporter' en haut de l’écran, la fenêtre affiche les coordonnées de la zone à l’écran.
Construire une URL pour l’API HTTP
Une requête API requiert une URL telle que spécifiée dans la documentation. Dans l’URL, la boîte englobante est représentée par quatre nombres séparés par des virgules dans cet ordre : gauche, bas, droite, haut (lon min, lat min, long max, lat max) et exprimés en degrés décimaux (Une latitude est positive au nord, négative au sud, la longitude est négative à l’ouest et positive à l’est).
Exemple :
https://api.openstreetmap.org/api/0.6/map?bbox=11.54,48.14,11.543,48.145
Télécharger les données
Il est possible de directement taper l’URL dans un navigateur, mais cette méthode ne fonctionnera probablement pas dans le cas d’une large zone. Il est préférable d’utiliser des outils en ligne de commande tels que wget et curl.
Une zone comportant beaucoup de données peut générer un délai dans la réponse HTTP pendant que le serveur traite la requête. En cas d’erreur 'timeout', essayer en utilisant un plus long délai ou sélectionner une zone plus petite.
Exemple pour wget:
wget -O muenchen.osm "https://api.openstreetmap.org/api/0.6/map?bbox=11.54,48.14,11.543,48.145"
