API de géocodage : convertir une adresse en coordonnées, et l'inverse

Les humains décrivent un lieu par une adresse, les logiciels par deux nombres. Une API de géocodage fait la traduction entre les deux, et c'est ce qui rend possible tout le reste : afficher une commande sur une carte, calculer une distance, déterminer si un client est dans votre zone de livraison, regrouper vos ventes par territoire.

Géocodage direct : de l'adresse aux coordonnées

Le géocodage direct prend une adresse, ou un fragment d'adresse, et renvoie une latitude et une longitude. La conversion elle-même n'a rien de compliqué ; toute la difficulté est dans la mise en correspondance.

Le texte que vous envoyez est ambigu. Il existe des dizaines de « rue de la République », plusieurs Saint-Étienne, et beaucoup de numéros qui n'existent pas dans la voie saisie. Un bon géocodeur ne se contente donc pas de renvoyer un point : il indique ce qu'il a trouvé, à quel niveau de précision, et avec quel degré de confiance. Ignorer ces champs revient à accepter un résultat sans savoir s'il vaut quelque chose.

Géocodage inverse : des coordonnées à l'adresse

Le géocodage inverse fait le trajet contraire : vous avez un couple de coordonnées, issu d'un téléphone, d'un boîtier télématique ou d'un clic sur une carte, et vous voulez l'adresse correspondante.

Les usages classiques sont l'application du livreur qui confirme devant quel bâtiment il se trouve, le formulaire pré-rempli à partir de la position de l'utilisateur, et la transformation d'une trace GPS en quelque chose de lisible dans un rapport.

Ce sens a une ambiguïté que le sens direct n'a pas : un point au milieu d'une rue est proche de plusieurs adresses et à l'intérieur d'aucune. Attendez-vous à une correspondance « la plus proche » assortie d'une distance, et prévoyez le cas où il s'agit du bâtiment d'en face.

La précision, le champ qui décide de tout

Les fournisseurs emploient des mots différents pour les mêmes trois idées, et l'écart entre elles peut dépasser la centaine de mètres :

• Au numéro (ou à la porte) : le point est sur le bâtiment. C'est le seul niveau acceptable pour livrer ou pour mesurer en mètres.
• À la voie : le point est interpolé le long de la rue à partir de la numérotation connue. Généralement correct à quelques portes près, parfois du mauvais côté de la chaussée.
• À la commune ou au code postal : le point est un centroïde. Parfait pour une carte de chaleur ou un découpage commercial, inutilisable pour un GPS.

Décidez du niveau dont vous avez besoin avant de comparer les offres. Payer pour une précision au numéro afin de dessiner une carte de répartition des ventes est du gaspillage ; utiliser un centroïde de commune pour router un livreur est une livraison ratée.

Géocoder en France : les particularités locales

Quelques réalités françaises qui influencent le taux de correspondance :

• Les lieux-dits. En zone rurale, l'adresse n'a pas toujours de numéro et de voie au sens classique. Un géocodeur calibré sur les zones urbaines s'y comporte mal.
• Les communes fusionnées. Les communes nouvelles ont changé la carte administrative ces dernières années, et les référentiels ne sont pas tous à jour au même moment.
• Les compléments d'adresse. Bâtiment, résidence, escalier : ces éléments n'aident pas le géocodage et perturbent souvent la correspondance. Envoyez-les dans un champ séparé plutôt que collés à la voie.
• Le CEDEX. Une adresse CEDEX est une adresse de distribution, pas une localisation géographique. La géocoder au numéro n'a pas toujours de sens.

Géocoder un fichier entier

Pour un traitement de masse, l'approche naïve consiste à boucler sur des appels unitaires. Elle fonctionne, à trois conditions.

Nettoyez avant de géocoder. Un géocodeur alimenté avec des données sales renvoie des coordonnées plausibles plutôt qu'une erreur, et une réponse fausse mais crédible est bien pire qu'un échec. Normaliser les adresses en amont fait monter le taux de correspondance et baisser le nombre d'erreurs silencieuses.

Respectez les quotas et mettez en cache. Dans une base clients, la même adresse revient souvent. Un cache local sur l'entrée normalisée réduit fortement le volume d'appels.

Surveillez la distribution des précisions, pas seulement le taux de réussite. Un lot « géocodé à 97 % » dont la majorité des points sont des centroïdes de commune ne vous a pas donné ce que vous vouliez.

Le géocodage gratuit et ses limites

Trois familles d'offres gratuites, avec trois contraintes différentes :

• Les services publics, dont la Géoplateforme pour la France. Excellente qualité sur le territoire national, quotas d'usage, aucun engagement de disponibilité. Notez que le service a récemment changé d'opérateur et de point d'entrée : voir la migration de l'API Adresse BAN.
• Les services ouverts fondés sur OpenStreetMap. Couverture mondiale, précision très variable selon les zones, et des conditions d'usage qui interdisent en pratique l'usage automatisé intensif sans héberger sa propre instance.
• Les paliers gratuits des API commerciales. Confortables pour développer, et dont la limite arrive plus vite qu'on ne le croit en production. Vérifiez surtout si la licence vous autorise à stocker les coordonnées : certaines plateformes cartographiques l'interdisent en dehors de leur propre carte.

Ce que propose Pro6PP

Pro6PP renvoie des coordonnées avec chaque complétion d'adresse pour la France, ainsi que le géocodage inverse, la recherche par zone et le calcul de distance à vol d'oiseau ou par la route. La même API couvre les Pays-Bas, la Belgique, l'Allemagne, le Luxembourg, le Danemark, l'Autriche, la Suisse, l'Espagne et le Royaume-Uni, avec un format de réponse identique.

Si le vocabulaire du géocodage ne vous est pas familier, l'explication du principe est un meilleur point de départ que cette page. Le géocodage n'arrive jamais seul, et notre guide des API d'adresse en France montre où il se place par rapport à la recherche et à la validation.

Questions fréquentes

Quelle est la différence entre géocodage direct et géocodage inverse ?

Le géocodage direct convertit une adresse en coordonnées. Le géocodage inverse convertit des coordonnées en adresse. Les deux sont proposés par les mêmes services, généralement sur deux points d'entrée distincts.

Quelle précision peut-on attendre en France ?

Au numéro dans les zones bien référencées, ce qui couvre l'essentiel des adresses urbaines. En zone rurale et sur les lieux-dits, la précision descend souvent à la voie ou à la commune, et le champ de précision renvoyé par l'API est votre seul moyen de le savoir.

Peut-on stocker les coordonnées renvoyées par une API ?

Cela dépend entièrement de la licence. Certains fournisseurs l'autorisent sans restriction, d'autres imposent une durée de conservation, et certaines plateformes cartographiques interdisent l'affichage des résultats hors de leur propre carte. Vérifiez avant de construire un pipeline qui suppose le contraire.

Comment améliorer un taux de correspondance médiocre ?

Nettoyez et normalisez les adresses avant l'appel, séparez les compléments d'adresse du libellé de voie, et envoyez le code postal et la commune plutôt qu'une chaîne libre quand vous les avez.

Le géocodage suffit-il pour valider une adresse ?

Non. Un géocodeur peut renvoyer un point correct pour une adresse qui n'est pas distribuable, et un point plausible pour une adresse qui n'existe pas. La vérification postale est un contrôle différent.

Pour aller plus loin

• Consulter la documentation API
• Créer un compte
• Se connecter
• Toutes les actualités