Recherche volontaire, modérée et remplaçable.
1 req/s · sans autocompleteInté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.
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.
Budget cumulé par application · cache et identification obligatoires
Volume et fonctionnalités selon contrat propre.
SLA · coût · licenceBatch et souveraineté avec un run assumé.
import · update · capacité-
GET
/search · action utilisateurcache miss · public OSMFautorisé
-
GET
/search · frappe autocompleteappel automatique · 7/12bloqué
-
JOB
Batch · 2 840 adressesfile asynchrone · instance dédiéerouté
-
GET
/reverse · application terrainrésultat déjà qualifiécache
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’OSMFAvant 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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Classer chaque déclencheur
Distinguer recherche volontaire, reverse, lookup, autocomplete, batch, tracking et revente.
Choisir l’hôte admissible
Arbitrer service public, fournisseur tiers ou instance dédiée avec leurs conditions propres.
Stabiliser l’identité métier
Rapprocher clé interne, osm_type, osm_id, source, instance, date et candidats concurrents.
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.
Ce que le cadrage doit trancher
Usage & déclencheur Action utilisateur ou automatique, search, reverse, lookup, batch et données transmises.
Hôte & conditions OSMF, tiers ou instance propre, débit, attribution, cache, confidentialité et SLA.
Identité & qualité Clé métier, références OSM, candidats, ambiguïté, seuil, date et correction opérateur.
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.
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.
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.
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.
Maillage API
Poursuivre dans le bon univers API
Ces liens permettent de repartir vers la page principale ou vers les univers proches quand le besoin dépasse le seul connecteur.
Avis & exigence projet
Ce qu’on sécurise avec Nominatim
Service public, tiers et instance propre gardent chacun leurs conditions et responsabilités.
place_id, références OSM et clé métier ne sont plus confondus.
Candidat, ambiguïté, source, date, fallback et correction restent auditables.
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