Nominatim (OSM) API
Géocodage et géocodage inverse open source à partir des données OpenStreetMap.
Nominatim est un moteur de géocodage open source qui s'appuie sur les données d'OpenStreetMap. Il permet de convertir un nom de lieu ou une adresse en coordonnées (géocodage), de retrouver l'adresse correspondant à des coordonnées (géocodage inverse) et de rechercher des lieux par requête libre ou structurée. C'est le moteur qui alimente la recherche du site officiel OpenStreetMap. Il s'adresse aux développeurs qui veulent du géocodage gratuit et auto-hébergeable, sans dépendre d'un fournisseur commercial.
Que propose l'API Nominatim (OSM) ?
Tarifs de l'API Nominatim (OSM)
Logiciel open source gratuit. L'API publique hébergée par la fondation OpenStreetMap est gratuite mais soumise à une politique d'usage stricte ; pour un usage intensif, il faut auto-héberger sa propre instance ou passer par un fournisseur commercial basé sur Nominatim.
Offre gratuite — L'API publique nominatim.openstreetmap.org est gratuite, plafonnée à 1 requête par seconde maximum (4 requêtes par minute pour le géocodage en masse). L'autocomplétion, le géocodage en masse intensif et le scraping systématique sont interdits, et une attribution OpenStreetMap doit être affichée. Le logiciel lui-même est libre et auto-hébergeable sans limite.
Authentification & intégration
Aucune clé requise sur l'API publique. Chaque requête doit en revanche fournir un User-Agent (ou Referer HTTP) identifiant l'application. Une instance auto-hébergée fixe ses propres règles.
API REST en HTTP GET, réponses en JSON, JSONv2, GeoJSON, XML ou GeoCodeJSON selon le paramètre format. Endpoints search, reverse, lookup, details et status. Utilisable via l'instance publique ou via une instance auto-hébergée.
Cas d'usage de l'API Nominatim (OSM)
- Convertir des adresses saisies par les utilisateurs en coordonnées pour les afficher sur une carte.
- Retrouver l'adresse d'un point à partir de coordonnées GPS (géocodage inverse).
- Ajouter un géocodage gratuit et open source à un projet sans dépendre d'un fournisseur commercial.
- Auto-héberger un moteur de géocodage pour un usage intensif sans coût par requête.
- Rechercher des lieux ou points d'intérêt OpenStreetMap par nom dans une application.
- Enrichir des données géographiques avec les attributs d'OpenStreetMap (type de lieu, hiérarchie administrative).
✓ Points forts
- Entièrement open source et gratuit, sans coût par requête en auto-hébergement.
- Données mondiales issues d'OpenStreetMap, mises à jour par la communauté.
- Géocodage et géocodage inverse dans un même moteur, avec plusieurs formats de sortie.
- Auto-hébergeable, du laptop pour une seule ville au planet complet sur serveur.
- Aucune clé API ni inscription nécessaire pour l'instance publique.
⚠ Limites
- L'API publique est limitée à 1 requête/seconde et interdit l'autocomplétion et le géocodage en masse.
- Pas de SLA ni de garantie de disponibilité sur l'instance publique gratuite.
- L'auto-hébergement demande des ressources serveur importantes et de l'expertise technique.
- Attribution OpenStreetMap obligatoire et usages intensifs proscrits sur l'instance publique.
- La qualité du géocodage dépend de la complétude des données OpenStreetMap selon les régions.
Questions fréquentes sur l'API Nominatim (OSM)
Nominatim est-il gratuit ?
Oui. Le logiciel est open source et gratuit, et l'API publique hébergée par la fondation OpenStreetMap est gratuite. Cette dernière est toutefois soumise à une politique d'usage stricte ; pour un usage intensif, il faut auto-héberger sa propre instance.
Faut-il une clé API ?
Non, l'API publique ne demande pas de clé. En revanche, chaque requête doit fournir un User-Agent (ou un Referer HTTP) identifiant clairement l'application qui l'émet.
Quelles sont les limites de l'API publique ?
Au maximum 1 requête par seconde, et 4 requêtes par minute pour le géocodage en masse. L'autocomplétion, le scraping systématique et le téléchargement de zones entières sont interdits, et une attribution OpenStreetMap doit être affichée.
Quelle différence entre géocodage et géocodage inverse ?
Le géocodage (endpoint search) convertit un nom de lieu ou une adresse en coordonnées, tandis que le géocodage inverse (endpoint reverse) part de coordonnées pour retrouver l'adresse et l'objet OpenStreetMap correspondant.
Peut-on l'utiliser pour un usage intensif ?
Pas via l'API publique, dont les limites sont volontairement basses. Pour un volume élevé, la solution recommandée est d'installer sa propre instance Nominatim, ce qui supprime le coût par requête, ou de passer par un fournisseur commercial basé sur Nominatim.
Quels formats de réponse sont disponibles ?
Selon le paramètre format : JSON, JSONv2, GeoJSON, GeoCodeJSON et XML. Les endpoints principaux sont search, reverse, lookup, details et status.
