Qu’est-ce que l’API Overpass ?

OpenStreetMap est une carte gratuite du monde créée par des bénévoles. Outre les routes et les bâtiments, elle recense des millions de magasins, cafés, bancs, défibrillateurs et fontaines à eau, chacun décrit par des tags tels que amenity=cafe ou shop=bakery. L’API Overpass est un service de recherche en lecture seule pour ces données : vous demandez tous les éléments portant un certain tag dans une zone, et elle renvoie les lieux correspondants avec leur nom, leur adresse et leurs horaires d’ouverture.

Plusieurs groupes gèrent des serveurs Overpass publics et gratuits. Ils sont partagés par tout le monde. Aux heures de pointe, l’un d’eux peut donc être lent ou refuser des requêtes, tandis qu’un autre répond immédiatement.

Description de l’outil

Déplacez et zoomez la carte jusqu’à la zone que vous souhaitez explorer, puis choisissez ce que vous recherchez : une catégorie telle que Pharmacies ou Toilettes publiques, un tag OSM personnalisé, ou Tout élément portant un nom, avec un nom à rechercher. Vous pouvez aussi affiner une catégorie par nom, par exemple rechercher les supermarchés dont le nom contient Lidl. Cliquez sur Rechercher dans la zone affichée pour lancer la recherche dans la zone visible sur la carte. Le bouton situé sous les boutons de zoom sur la carte vous localise.

Les lieux apparaissent sous forme de points sur la carte et dans un tableau sous les paramètres de recherche, avec le nom, le tag et l’adresse de chacun. Cliquez sur un point ou une ligne du tableau pour afficher également les horaires d’ouverture et le site web du lieu, ainsi qu’un lien permettant de l’ouvrir sur OpenStreetMap. Le tableau peut être trié selon n’importe quelle colonne et les résultats peuvent être enregistrés au format CSV ou JSON.

Par défaut, l’outil choisit lui-même le serveur : en Europe, il interroge un serveur qui ne contient que des données européennes et qui est souvent moins sollicité. Ailleurs, il passe au serveur suivant lorsqu’un serveur est occupé, et en interroge également un autre si le premier tarde à répondre. Vous pouvez aussi choisir un serveur vous-même. La ligne d’état indique quel serveur a répondu et à quel point sa copie des données cartographiques est à jour.

Votre recherche est envoyée directement depuis votre navigateur au serveur Overpass : celui-ci reçoit la zone et les critères de recherche, et rien ne transite par notre serveur.

Fonctionnalités

  • Recherche dans la zone affichée sur une carte OpenStreetMap, avec accès à votre position en un clic
  • Catégories courantes, recherche par tag OSM et recherche par nom
  • Serveurs Overpass publics et gratuits, sans clé API, avec basculement automatique lorsqu’un serveur est occupé
  • Résultats affichés sur la carte et dans un tableau triable à côté, avec les noms, les tags et les adresses
  • Fenêtres contextuelles avec les horaires d’ouverture, le site web et un lien vers le lieu sur OpenStreetMap
  • Exportation des résultats au format CSV ou JSON

Conseils

  • Recherchez une ville ou un quartier plutôt qu’une région entière : les zones plus petites donnent des réponses plus rapidement et respectent les limites imposées par les serveurs publics.
  • Pour utiliser un tag personnalisé, recherchez sa clé et sa valeur dans la liste des éléments cartographiques du wiki OpenStreetMap. Une clé seule, comme wheelchair ou opening_hours, permet de trouver tous les éléments qui possèdent cette clé, quelle que soit sa valeur.
  • La recherche de noms ne tient pas compte des majuscules et peut trouver une correspondance n’importe où dans le nom. Ainsi, bank trouve aussi « Swedbank » et « Bank of Ireland ».
  • Si le choix automatique échoue à répétition, il se peut que tous les serveurs soient occupés en même temps. Attendez une minute et réessayez, ou choisissez vous-même un serveur.
  • Les lieux qui ne figurent pas dans OpenStreetMap ne peuvent pas être trouvés ici. Vous pouvez ajouter vous-même un magasin ou un banc manquant sur openstreetmap.org.