API

Intégrateur Nominatim API : géocodage OSM sans dépendre d’un service public fragile

Nominatim transforme une adresse en candidats OSM avec /search, une coordonnée en adresse avec /reverse et des références OSM en objets avec /lookup. Dawap choisit entre l’instance publique strictement limitée, un fournisseur tiers ou une instance dédiée, puis relie résultat, attribution, identité métier, qualité et reprise.

APIs, données et infrastructures que nos projets savent connecter
Du besoin métier au run mesurable
01 Contrat versionné
02 Sécurité explicite
03 Reprise testée
04 Supervision actionnable

Réponse immédiate

L’API Nominatim n’est pas un service de géocodage public illimité.

Dawap commence par classer chaque usage : recherche déclenchée par un utilisateur, reverse, lookup, batch, autocomplete ou revente. Ce tri décide si nominatim.openstreetmap.org est admissible ou s’il faut un tiers, une instance propre ou un autre moteur.

  • Sur l’instance publique : 1 requête/s maximum pour l’application, identification, cache, attribution, confidentialité et capacité de changement.
  • Aucun autocomplete ni bulk régulier sur le service public ; exclure aussi extraction systématique, tracking et revente.
  • Conserver une identité interne : place_id n’est ni stable entre instances ni garanti dans le temps.

L’instance avant l’endpoint

Chaque requête doit prendre une route autorisée.

La qualité d’un géocodage ne compense jamais un usage incompatible. Le proxy classe le déclencheur, choisit l’hôte admissible et conserve une identité métier indépendante du résultat Nominatim.

Policy gatewayRoutage des usages
Règles actives
Instance publique OSMF 0,8 / 1 req/s

Budget cumulé par application · cache et identification obligatoires

01Public OSMF

Recherche volontaire, modérée et remplaçable.

1 req/s · sans autocomplete
02Fournisseur tiers

Volume et fonctionnalités selon contrat propre.

SLA · coût · licence
03Instance dédiée

Batch et souveraineté avec un run assumé.

import · update · capacité
Décisions du proxyFile de requêtes simulée
14:42:19
  1. GET
    /search · action utilisateurcache miss · public OSMF
    autorisé
  2. GET
    /search · frappe autocompleteappel automatique · 7/12
    bloqué
  3. JOB
    Batch · 2 840 adressesfile asynchrone · instance dédiée
    routé
  4. GET
    /reverse · application terrainrésultat déjà qualifié
    cache
Décision immédiate

L’autocomplete est refusé avant tout appel à l’instance publique. Le produit reçoit un statut explicite et une trajectoire alternative.

Aucun retry vers l’OSMF
Réponse Nominatim place_id 184736 propre à cette base
Preuve rapprochée node / 842931 source · instance · date
Identité du SI GEO-004218 stable et versionnée

Avant de solliciter l’instance

Trois usages apparemment simples fragilisent une intégration Nominatim.

La bonne architecture dépend moins de l’endpoint que du déclencheur, du volume, des données transmises et de la responsabilité que le produit accepte d’opérer.

01 Autocomplete & batch

Un appel automatique contourne la logique du service public

Chaque frappe ou traitement régulier transforme une infrastructure communautaire limitée en dépendance de production non conforme.

02 Identité

place_id devient une clé métier qui peut disparaître

L’identifiant dépend de la base Nominatim ; l’application doit conserver sa propre identité et la preuve du rapprochement.

03 Reverse

Le candidat le plus proche remplace une adresse certaine

L’objet OSM retourné peut appartenir à une autre rue ou porter un niveau trop large pour la décision attendue.

Intégration Nominatim API

L’architecture dépend d’abord de l’instance que vous avez le droit d’utiliser

La policy de nominatim.openstreetmap.org ne s’applique pas automatiquement à une instance propre ou à un fournisseur tiers. Le connecteur doit donc rendre explicites l’hôte, ses conditions, son niveau de service et le mécanisme de bascule.

01 · Nominatim

Search libre ou structuré

Choisir q ou les champs d’adresse, puis pays, langue, viewbox, format et seuil d’acceptation sans combiner des paramètres incompatibles.

02 · Nominatim

Reverse avec limite connue

Relier la coordonnée au candidat retourné en sachant que Nominatim cherche l’objet OSM approprié le plus proche, pas une vérité cadastrale.

03 · Nominatim

Identité OSM et métier

Rapprocher osm_type, osm_id et class avec une clé interne ; place_id reste propre à une base Nominatim et peut changer.

04 · Nominatim

Policy de l’instance publique

Limiter le débit, identifier l’application, attribuer OSM, cacher les réponses et exclure autocomplete, requêtes systématiques et revente.

05 · Nominatim

Fournisseur interchangeable

Le produit peut changer d’hôte sans mise à jour logicielle et compare réponse, coût, couverture, licence, SLA et règles du tiers.

06 · Nominatim

Instance Nominatim dédiée

Dimensionner PostgreSQL/PostGIS, import régional ou global, mises à jour OSM, index, sauvegarde, monitoring et procédure d’upgrade.

Méthode

On refuse d’abord les usages incompatibles, puis on mesure la qualité

Le pilote assemble des adresses réelles autorisées, des homonymes, des coordonnées limites, des objets OSM modifiés et des pannes d’instance. Il valide architecture, précision et reprise avant généralisation.

01

Classer chaque déclencheur

Distinguer recherche volontaire, reverse, lookup, autocomplete, batch, tracking et revente.

02

Choisir l’hôte admissible

Arbitrer service public, fournisseur tiers ou instance dédiée avec leurs conditions propres.

03

Stabiliser l’identité métier

Rapprocher clé interne, osm_type, osm_id, source, instance, date et candidats concurrents.

04

Tester la sortie de secours

Prouver cache, limitation, refus, changement de fournisseur, reprise et rematching.

Premier lot Nominatim

Classer un flux réel avant de choisir l’instance.

Nous prenons un parcours d’adresse concret et décidons où chaque requête peut être envoyée, quelle identité votre SI conserve et comment le produit réagit quand l’hôte refuse, ralentit ou change.

1 usage réel 1 hôte admissible 1 bascule testée

Ce que le cadrage doit trancher

01

Usage & déclencheur Action utilisateur ou automatique, search, reverse, lookup, batch et données transmises.

02

Hôte & conditions OSMF, tiers ou instance propre, débit, attribution, cache, confidentialité et SLA.

03

Identité & qualité Clé métier, références OSM, candidats, ambiguïté, seuil, date et correction opérateur.

04

Run & réversibilité Rate limit, déduplication, refus, fallback, supervision, rematching et changement d’hôte.

Recette Nominatim

Trois contre-tests qui protègent vraiment le service

Le lot pilote doit prouver qu’un usage interdit ne part pas vers l’instance publique, qu’un identifiant instable ne devient pas clé métier et qu’un reverse ambigu ne remplace pas une adresse certaine.

01 · Policy publique

Une saisie autocomplete ne doit jamais arroser nominatim.openstreetmap.org

Chaque frappe, un batch distribué ou un produit de tracking transformerait le service public à capacité limitée en dépendance de production non conforme. Un simple retry ne corrige pas ce défaut d’architecture.

Entrée
Déclencheur utilisateur ou automatique, hôte, débit cumulé, User-Agent/Referer, cache, attribution, données transmises et capacité de bascule.
Sortie
Matrice d’usage autorisé/interdit et routage vers public, tiers, instance dédiée, Overpass ou autre source.
Décision
Servir, ralentir, refuser ou changer de moteur avant que le flux ne touche l’OSMF.
02 · Identité

place_id ne doit pas devenir la clé permanente d’un client ou d’un site

place_id est interne à une base Nominatim et peut changer après réimport. Même les références OSM peuvent évoluer quand un objet est supprimé, scindé ou recréé.

Entrée
Identifiant métier, place_id, osm_type, osm_id, class, coordonnées, adresse normalisée, source, instance et date de validation.
Sortie
Table de rapprochement versionnée avec clé interne stable, preuve géographique et mécanisme de rematching.
Décision
Conserver, rematcher, mettre en quarantaine ou demander une validation avant propagation.
03 · Reverse

Le candidat le plus proche n’est pas toujours l’adresse du point demandé

Nominatim recherche l’objet OSM approprié le plus proche. En zone dense, il peut appartenir à une autre rue ; en zone peu cartographiée, le niveau retourné peut être trop large.

Entrée
Coordonnée, distance au candidat, niveau d’adresse, catégorie, pays, couverture OSM, format, langue et règle métier attendue.
Sortie
Règles d’acceptation par usage avec seuils, fallback, correction opérateur et état “ambigu” explicite.
Décision
Accepter, compléter, comparer une seconde source ou refuser le reverse pour le parcours sensible.

Avis & exigence projet

Ce qu’on sécurise avec Nominatim

5/5★★★★★Avis clients Dawap
Service public, tiers et instance propre gardent chacun leurs conditions et responsabilités.
Hôte assumé
place_id, références OSM et clé métier ne sont plus confondus.
Identité maîtrisée
Candidat, ambiguïté, source, date, fallback et correction restent auditables.
Décision observable
Preuves OSM & adresse

Trois projets adjacents, avec leurs limites technologiques

Ils démontrent géodata, normalisation et exploitation de flux critiques sans inventer un cas client Nominatim.

Carte interactive Attractivité-locale.fr alimentée par API publiques Intégration API Attractivité-locale.fr : carte API des entreprises locales Voir le projet
  • 12 juillet 2025
  • Lecture ~11 min

Attractivité-locale.fr rassemble des données publiques d’entreprises dans une carte territoriale utile aux citoyens, élus et acteurs économiques. Dawap a normalisé les sources, fiabilisé les fiches et rendu la recherche plus exploitable pour transformer des API dispersées en service local lisible au quotidien.

Visuel éditorial du moteur de calcul de trajets Saybus Intégration API Saybus : moteur API de devis transport Voir le projet
  • 3 janvier 2021
  • Lecture ~23 min

Le module de calcul Saybus devait produire des devis transport fiables sans recalcul manuel permanent. Dawap a automatisé distances, coûts, péages et règles métier, puis relié réservation, paiement MangoPay et SI groupe pour fluidifier le parcours jusqu’à la commande exploitable.

Architecture futuriste flottante pour le middleware API CHL Logistics Intégration API CHL Logistics : middleware API multi-transporteurs Voir le projet
  • 14 janvier 2026
  • Lecture ~16 min

CHL Logistics avait besoin d’une API métier simple pour cotation, création d’expédition, étiquettes et tracking DHL. Dawap a conçu un middleware Symfony découplé, traçable et prêt pour le multi-transporteurs, avec files asynchrones, back-office de suivi et reprise maîtrisée des flux.

Guides Nominatim & adresse

Deux guides pour séparer géocodage Nominatim et extraction OSM

Le guide Nominatim couvre search/reverse/lookup et la policy ; Overpass traite les extractions OSM. La BAN reste reliée comme alternative française dans le maillage API.

API Nominatim : search, reverse et OSM sans abus Intégration API API Nominatim : search, reverse et OSM sans abus Lire l'article
  • 28 janvier 2026
  • Lecture ~22 min

Nominatim sert à faire du search, reverse et lookup sur les données OpenStreetMap, mais son instance publique exige cache, attribution, User-Agent clair et usages très limités. L'article cadre formats JSON, GeoJSON, GeocodeJSON, OSM IDs, place_id, filtres, proxy, policy, fallback, fournisseur tiers et instance dédiée.

API Overpass OpenStreetMap : requêtes OSM sans dette Intégration API API Overpass OpenStreetMap : requêtes OSM sans dette Lire l'article
  • 25 janvier 2026
  • Lecture ~23 min

Overpass sert à interroger OpenStreetMap par tags, zones et objets OSM, pas à calculer un itinéraire ou une ETA. L'article cadre Overpass QL, nodes, ways, relations, bbox, areas, sorties JSON, cache, limites publiques, qualité des tags, ODbL, attribution et reprise pour transformer une extraction utile en connecteur exploitable.

Questions d’achat

Questions fréquentes sur l’intégration Nominatim API

Questions fréquentes sur Nominatim, son API publique, search, reverse, lookup, autocomplete, bulk, identifiants et instance dédiée.

01Peut-on utiliser nominatim.openstreetmap.org en production ?

Seulement pour un usage modéré et directement déclenché par l’utilisateur, avec un maximum absolu d’une requête par seconde pour l’application, identification valide, attribution, cache et capacité de changer de service. Un usage commercial critique doit prévoir le retrait possible de cet accès.

02Peut-on faire de l’autocomplete avec l’API publique Nominatim ?

Non. La policy interdit explicitement l’autocomplete côté client sur l’instance publique. Il faut choisir un fournisseur qui l’autorise, une instance propre ou un moteur conçu pour ce parcours.

03Nominatim convient-il au géocodage batch ?

Pas comme dépendance régulière de l’instance publique. Les petits traitements ponctuels restent soumis à des règles strictes ; un batch récurrent ou volumique doit utiliser un tiers compatible ou une instance dédiée.

04place_id est-il un identifiant permanent ?

Non. Il dépend de la base Nominatim et peut changer après réimport. Dawap conserve une clé métier interne et rapproche la preuve avec osm_type, osm_id, class, coordonnées, source et date.

05Le reverse geocoding renvoie-t-il toujours l’adresse exacte ?

Non. Nominatim cherche l’objet OSM approprié le plus proche ; en zone dense ou peu cartographiée, le résultat peut désigner une autre rue ou un niveau administratif trop large. La recette doit gérer ambiguïté et fallback.

06Que faut-il opérer sur une instance Nominatim dédiée ?

Le périmètre des données OSM, PostgreSQL/PostGIS, l’import initial, les mises à jour, les index, la capacité, les sauvegardes, la supervision et les upgrades deviennent votre responsabilité ou celle du prestataire managé.

Intégration Nominatim et géocodage OSM

Vous devez choisir entre API publique, fournisseur Nominatim et instance dédiée ?

On cadre les usages autorisés, le contrat adresse, la qualité OSM et la trajectoire de run avant de brancher le premier flux.

Cadrer mon architecture Nominatim