BETA

Compatible avec le géocodeur de la Géoplateforme

Géocodeur

Des adresses, des lieux et des parcelles cadastrales aux coordonnées, et des coordonnées aux adresses : mêmes chemins, mêmes paramètres, même JSON que le service de géocodage de l'IGN.

Changez l'URL de base, gardez votre code

- https://data.geopf.fr/geocodage/search?q=8+rue+des+jardins+metz
+ https://api.wymmo.dev/geocodage/search?q=8+rue+des+jardins+metz

Ce que fait l'API

Le géocodeur trouve les coordonnées d'une adresse, d'un lieu ou d'une parcelle cadastrale à partir d'un texte, et fait le chemin inverse : d'un point, il donne les adresses, les lieux et les parcelles les plus proches. Il suggère des adresses pendant la frappe, et géocode des fichiers CSV entiers.

Il cherche dans trois index, seuls ou ensemble : les adresses de la Base Adresse Nationale, les lieux nommés de la BD TOPO de l'IGN (gares, mairies, écoles, lieux-dits…) et les parcelles du Parcellaire Express.

Compatible avec le service de l'IGN

Les chemins, les paramètres et le JSON sont ceux du service de géocodage de la Géoplateforme. Pour migrer, vous changez l'URL de base ; votre code, vos filtres et la lecture des réponses restent les mêmes.

Essayez

0 adresse
Exemples :

La comparaison interroge aussi le service de géocodage de l'IGN depuis votre navigateur : il reçoit votre adresse IP et le texte saisi. wymmo.dev n'est pas affilié à ce service.

wymmo.dev
—
le service de géocodage de l'IGN
—

Temps mesurés depuis votre navigateur, réseau compris.

Tapez ou choisissez un exemple : la même requête part vers les deux API.

Les routes

MéthodeCheminCe qu'elle répond
GET/searchDu texte aux adresses, lieux et parcelles, avec des filtres et un point à privilégier
GET/reverseD'un point, d'un cercle ou d'un polygone aux adresses, lieux et parcelles les plus proches
GET/completionDes suggestions d'adresses et de lieux pendant la frappe
POST/search/csvChaque ligne d'un fichier CSV géocodée, la réponse envoyée au fil de l'eau
POST/reverse/csvL'adresse la plus proche de chaque ligne d'un fichier CSV
GET/getCapabilitiesCe que sert le géocodeur : opérations, paramètres, index
GET/completion/getCapabilitiesCe que sert l'autocomplétion

Caractéristiques

  • Trois index, seuls ou ensemble : les adresses de la Base Adresse Nationale, les lieux de la BD TOPO, les parcelles du Parcellaire Express
  • Les réponses en JSON et en GeoJSON du service de l'IGN, champ pour champ
  • Jusqu'à 50 résultats par recherche, 10 par défaut
  • Des fichiers CSV de 50 Mio et 200 000 lignes au plus, séparateur et encodage devinés
  • Appelable depuis n'importe quel site, dans le navigateur de vos visiteurs (CORS ouvert)

Performances

Drop-in, blazingly fast geocoder

Pensées dès le premier jour pour la vitesse : des réponses quasi instantanées, qui le restent quand les requêtes s'enchaînent.

Mesurez vous-même : la démo prend les temps de réponse dans votre navigateur, chez nous et chez l'État.

Démarrage rapide

Premières requêtes

Sans compte ni clé : l'URL suffit.

curl 'https://api.wymmo.dev/geocodage/search?q=8+rue+des+jardins+metz&limit=3'
curl 'https://api.wymmo.dev/geocodage/reverse?lon=6.1767&lat=49.1208'
curl 'https://api.wymmo.dev/geocodage/completion?text=rue+des+jar&type=StreetAddress'
curl 'https://api.wymmo.dev/geocodage/search?q=metz&limit=2&index=poi'
curl 'https://api.wymmo.dev/geocodage/search?index=parcel&q=57463000240142'
curl -F [email protected] -F columns=adresse 'https://api.wymmo.dev/geocodage/search/csv'

Migrer depuis la Géoplateforme

Seul le domaine change, data.geopf.fr devient api.wymmo.dev : les chemins, /geocodage compris, sont ceux de l'IGN.

Chez l'IGNChez wymmo.dev
https://data.geopf.fr/geocodage/search?…https://api.wymmo.dev/geocodage/search?…
/reverse, /completion, /search/csv, /reverse/csv, /getCapabilitiesles mêmes chemins, sous https://api.wymmo.dev/geocodage

Écarts connus

Pas encore servi : l'API asynchrone /async et les réponses 304 (ETag).

Répond autrement, exprès :

  • pendant les quelques secondes qui suivent un redémarrage, une requête peut répondre 503, y compris sur /completion et les fichiers CSV, au lieu d'un 200 en erreur ;
  • un fichier CSV trop gros répond 413, un formulaire mal formé 400 ; les colonnes de sortie gardent l'ordre du fichier ;
  • depcode filtre vraiment en géocodage inverse ; un numéro de rue sans sa voie est écarté au lieu de faire échouer la requête ;
  • les paramètres répétés (q[]=) ne sont pas lus comme des listes ;
  • l'ordre des membres d'un objet JSON n'est pas promis, et un très petit nombre peut s'écrire avec un exposant : la même valeur, que tout lecteur JSON relit ;
  • getCapabilities décrit wymmo.dev et ce qu'il sert.

Limites

Jusqu'à 50 résultats par recherche (20 avec returntruegeometry), 10 par défaut ; un cercle de 500 m au plus en géocodage inverse ; des fichiers CSV de 50 Mio et 200 000 lignes au plus.

L'offre

L'API est ouverte pendant son lancement, sans compte ni clé. Rien ne sera facturé sans que vous ayez souscrit une offre.

Voir les tarifs

Licences des données

Sources

DonnéesProducteurÉdition servieLicenceSert à
Base Adresse NationaleBase Adresse Nationaleexport du jour de la dernière mise à jourLicence Ouverte 2.0les adresses : recherche, géocodage inverse, autocomplétion, fichiers CSV
BD TOPO® 3.5IGN15 mars 2026Licence Ouverte 2.0les lieux (points d'intérêt)
ADMIN EXPRESS COG 3.2IGN3 mai 2023Licence Ouverte 2.0la commune de chaque lieu
Parcellaire Express (PCI) 1.1IGN, d'après le plan cadastral de la DGFiP1er juin 2026Licence Ouverte 2.0les parcelles cadastrales
Code officiel géographique 2025, par @etalab/decoupage-administratif 5.3.0Insee, mis en forme par Etalab2025Licence Ouverte 2.0les noms et codes des communes

Ces données sont publiques : wymmo.dev les sert plus vite, il ne les produit pas et ne les corrige pas.

Mention à reprendre

Si vous rediffusez des résultats du géocodeur, la Licence Ouverte vous demande de citer la source et sa date de mise à jour. Reprenez les lignes des données que vous utilisez :

  • Source : Base Adresse Nationale — Licence Ouverte 2.0
  • Source : IGN — BD TOPO® 3.5, édition du 15 mars 2026 — Licence Ouverte 2.0
  • Source : IGN — ADMIN EXPRESS COG 3.2, édition du 3 mai 2023 — Licence Ouverte 2.0
  • Source : IGN — Parcellaire Express (PCI) 1.1, édition du 1er juin 2026 — Licence Ouverte 2.0
  • Source : Insee — Code officiel géographique 2025

Ce que la licence vous demande

La Licence Ouverte permet de réutiliser ces données librement, y compris à des fins commerciales, de les modifier et de les combiner avec d'autres. Elle demande de mentionner leur source et la date de leur dernière mise à jour, sans laisser croire que le producteur cautionne votre usage ni que vos résultats sont officiels.

Toutes les sources et leurs licences

Référence

Chaque route, chaque paramètre et chaque réponse, à essayer en ligne : la référence de l'API.

Sa spec OpenAPI : https://api.wymmo.dev/geocodage/openapi.yaml

wymmo.dev est un service indépendant, sans lien avec l'IGN, Etalab ni l'administration. Les données viennent de sources publiques : voir leurs licences.