Intégration API API Géo
Nous développons votre connecteur API Géo
Nous branchons geo.api.gouv.fr sur vos formulaires : l'utilisateur tape une ville, votre SI récupère le code INSEE, l'EPCI et le département.
- Équipe produit senior
- connecteurs de données publiques en production
- du cadrage au monitoring
À quoi sert l'API Géo et dans quels cas l'intégrer ?
L'API Géo donne accès au découpage administratif français : communes, départements, régions, EPCI, avec leurs codes INSEE, leurs géométries et leurs données associées. Sans inscription ni clé. On l'intègre dans une application pour proposer un sélecteur de commune à partir d'un code postal, filtrer des données par territoire, ou afficher les contours d'une zone sur une carte. Elle est particulièrement utile pour les outils de gestion publique, les applications d'aide sociale, ou tout logiciel qui doit raisonner par territoire administratif.
Ce que nos clients construisent sur l'API Géo
Autocomplete commune dans un tunnel
Sortie code INSEE pour tout le SI. Avec boost=population ; sinon Nantes-en-Ratier sort devant Nantes.
Décodage code postal → communes
Un CP couvre n communes, une commune n CP. Sur un formulaire SIRET ou livraison : on propose la liste, on ne devine pas.
Rattachement GPS → commune / EPCI
Un point d'intervention terrain tombe sur le bon COG, donc sur la bonne règle d'éligibilité.
Filtre territorial d'un back-office
Région, département, EPCI sur des codes stables, pas sur une table Excel morte à la prochaine fusion.
Ce que ça change dans vos formulaires
La technique au service d'un résultat mesurable : un code INSEE comme clé, fini le modèle « ville = code postal ».
La bonne commune, dès le formulaire
Paris a 21 codes postaux : stocker le CP comme identifiant de ville casse dès le premier arrondissement. On pose le code INSEE comme clé ; le reste du SI s'aligne.
Plus d'homonymes qui bloquent le parcours
Saint-Aubin existe dans dix départements. On filtre par département ou on priorise les villes peuplées : l'utilisateur choisit la bonne, sans ambiguïté.
Un autocomplete qui reste fluide
Les contours de carte n'ont rien à faire à chaque frappe. On charge le strict nécessaire pour proposer la commune ; la carte vient ensuite, quand on en a besoin.
Adresse et découpage, chacun son rôle
L'API Adresse trouve le numéro de voie ; l'API Géo rattache la commune, l'EPCI, le département. On enchaîne les deux : données complètes, sans confusion.
Comment nous livrons votre connecteur API Géo
Cadrage
Autocomplete, décodage CP, GPS, contours ou non. On tranche fields et geometry avant d'écrire une ligne.
Développement
Debounce, fields minimaux, boost=population, cache local des 18 régions et d'environ 100 départements, proxy si le volume l'exige.
Recette
Paris 75011 → 75056, Nantes vs Nantes-en-Ratier, un homonyme, une commune fusionnée, et un repli par saisie manuelle du code INSEE.
Monitoring
Alerte sur les 5xx, taux de résolution de l'autocomplete, fraîcheur du COG. Vous voyez une fusion avant qu'elle casse le formulaire.
Ce que permet l'API Géo
- Communes et arrondissements
- Recherche par nom, code postal, code INSEE, lat/lon. Paris 75056 est une commune, ses arrondissements aussi.
- EPCI, départements, régions
- Dérivés du code commune, ou listes /departements/{code}/communes, /epcis/{code}/communes, /regions/{code}/communes. 18 régions en vigueur.
- Géométries à la demande
- centre, contour, mairie, bbox. Les contours se réservent à un fond préchargé, jamais à la frappe.
- Cache HTTP côté serveur
- cache-control public, max-age=3600, immutable (constaté en live). On s'appuie dessus, sans multiplier les appels.
Le vocabulaire de l'API Géo
- code INSEE / COG
- L'identifiant de commune. C'est la clé de stockage. Un code postal n'en est pas un : un CP = n communes, une commune = n CP, Paris 21 CP.
- boost=population
- Paramètre d'autocomplete par nom. Sans lui, Nantes-en-Ratier peut sortir devant Nantes. Constaté : scores 1 vs 0,66. Ce n'est pas un détail.
- fields
- À la frappe, on ne demande que nom, code, codesPostaux et codeDepartement. Ajouter geometry=contour à l'autocomplete est un anti-pattern (34 Mo à l'échelle d'un département).
- millésime
- Paramètre de millésime COG (2015, 2024, 2026…). Le COG évolue (communes nouvelles). Un code stocké en 2017 peut ne plus désigner la même commune après fusion. On date l'observation.
- EPCI
- Établissement public de coopération intercommunale, dérivable du code commune (codeEpci). Règles d'éligibilité, taxe d'aménagement, secteur commercial.
- API Adresse vs API Géo
- Adresse géocode un numéro de voie (BAN). Géo décode le découpage administratif. Chaînage : BAN citycode → Géo, sans rappeler /communes?nom= avec une chaîne déjà normalisée.
Les contraintes réelles de l'API Géo
Le code postal n'est pas un identifiant
Documenté dans le guide : CP d'un autre département, communes multi-CP. Clé de stockage : code INSEE. Paris 75011 → 75056 et 21 CP, vérifié en live.
Contours en autocomplete = 34 Mo
Le guide chiffre l'écart : département sans contour ~480 Ko, avec contour ~34 Mo. Fond de carte préchargé, jamais à chaque frappe.
Quota non publié
On s'appuie sur le cache 3600 s, un debounce, un proxy si le volume l'exige, et un User-Agent identifiable. On ne promet pas un débit chiffré.
wxs.ign.fr est mort pour Admin Express
Les guides géographiques citent encore l'ancien WFS. DNS mort en août 2026. Alternative : data.geopf.fr / fichiers Admin Express. Ne recopiez pas les commandes ogr2ogr sans remplacer l'hôte.
API Géo ou API Adresse ?
Deux APIs Etalab / IGN souvent enchaînées, rarement substituables.
| Critère | API GéoDécoupage admin | API AdresseGéocodage BAN |
|---|---|---|
| Objet | Commune, EPCI, département, région | Numéro de voie, POI, parcelle |
| Hôte | geo.api.gouv.fr | data.geopf.fr/geocodage |
| Clé de sortie | Code INSEE (COG) | banId + citycode |
| Code postal | Décodé vers n communes | Un champ de l'adresse normalisée |
| Contours | Oui, à ne pas charger à la frappe | Non, ce n'est pas son rôle |
| Auth | Aucune | Aucune en usage courant |
| Meilleur usage | Formulaire ville / éligibilité | Saisie d'une adresse livrable |
On les combine : Adresse pour le numéro, Géo pour l'EPCI et la région. La couche d'abstraction évite de rappeler /communes?nom= quand le citycode est déjà là.
Ce que nous mesurons sur une intégration API Géo
Les autres API publiques
Les briques que nous branchons le plus souvent à côté du découpage administratif.
API GéoNous développons votre connecteur API GéoCette page
API AdresseGéocodage BAN : le numéro de voie, puis citycode vers l'API Géo.
Météo FranceVigilance sur le département issu du code commune, via un autre canal.
URSSAFStats agrégées par département, une fois le COG connu.
SNCF & transportNous développons votre connecteur SNCFAPI Particulier
France Travail
DVF & cadastre
LegifranceNous développons votre connecteur LégifranceOn combine API Géo avec
La stack qui entoure le découpage administratif sur nos projets.
Intégration API Géo : vos questions
Un champ commune avec debounce, fields minimaux (nom, code, codesPostaux, codeDepartement), boost=population, et jamais geometry=contour à la frappe. On stocke le code INSEE, le libellé, la date d'observation et les codes postaux en tableau. Cache local des 18 régions et des départements. Proxy serveur si le volume d'IP est inconnu. Repli : saisie manuelle du code INSEE si l'API répond en 5xx. User-Agent identifiable.
L'API Adresse géocode une adresse (BAN) : numéro, rue, coordonnées, citycode. L'API Géo décode le découpage administratif : commune, EPCI, département, région, éventuellement un contour. On les enchaîne : Adresse → citycode → Géo pour l'EPCI, sans rappeler /communes?nom= avec une chaîne déjà normalisée. Ce n'est ni le cadastre, ni Admin Express IGN. Pour Admin Express France entière et les contours lourds, on sort de geo.api.gouv.fr vers la Géoplateforme ou les fichiers, pas vers wxs.ign.fr.
Parce qu'un code postal n'identifie pas une commune. Paris a 21 codes postaux et le code commune 75056 : un GET /communes?codePostal=75011 le montre. Un CP peut aussi couvrir plusieurs communes, parfois dans un autre département. La clé de tout le SI, c'est le code INSEE. Le CP reste un tableau de propriétés. Un code stocké en 2017 peut ne plus désigner la même commune après fusion : on date l'observation, et on prévoit le millésime ou un pack COG si le métier l'exige.
Gratuite, sans compte ni clé. Un quota officiel chiffré n'est pas publié. Le serveur envoie cache-control 3600 s immutable : on s'appuie dessus. Debounce, fields courts, proxy si le volume l'exige. Nous ne publions pas de plafond inventé. Attribution open data selon la fiche data.gouv. Un User-Agent identifiable et un proxy serveur suffisent dans la plupart des tunnels. Si le volume explose, on le voit au monitoring, pas via un 429 non documenté en production.
L'accès est gratuit. Le coût, c'est le connecteur : debounce, boost, persistance du COG, cache, repli. Un autocomplete commune dans un tunnel d'inscription est un chantier court. Un fond de carte avec contours, plus un outil hors ligne pour agents terrain, est un autre projet, souvent avec le pack Etalab ou les fichiers COG. Nous cadrons geometry et volume avant de chiffrer. Le chaînage Adresse (BAN) puis Géo pour l'EPCI évite un second autocomplete par nom, donc du quota et des homonymes.
Un projet d'intégration API Géo ?
Parlons-en. 30 minutes pour cadrer autocomplete, code INSEE et contours, et vous dire franchement ce qui est faisable.
Parler de mon projet API Géo