Autocomplétion d'adresse — Démo interactive
Commencer votre saisie, l'API vous renvoie jusqu'à 5 suggestions classées par score, basées sur la Base Adresse Nationale (BAN), le code officiel géographique (COG) et Datanova (La Poste)
Voir la réponse en plan :
Plan Discovery : validation + données postales (sans géocodage). Plan Starter : géocodage uniquement (sans IRIS). Plan Growth : géocodage + IRIS (sans carroyage). Plan Business : toutes les données (géocodage + IRIS + carroyage 200 m).
Aucune suggestion pour 215 acac ste euph. Essayez une saisie plus précise.
curl -X GET "https://api.trustydata.app/services/v1/address/autocomplete?q=215%20acac%20ste%20euph&limit=5" \
-H "Authorization: Bearer VOTRE_CLE_API"import requests
url = "https://api.trustydata.app/services/v1/address/autocomplete"
headers = {"Authorization": "Bearer VOTRE_CLE_API"}
params = {"q": "215 acac ste euph", "limit": 5}
response = requests.get(url, headers=headers, params=params)
print(response.json()){
"message": "No results found",
"status": "NO_RESULTS"
}Comprendre la réponse
L'API /address/autocomplete répond à une saisie partielle en
proposant les adresses les plus probables, classées par score, dès les
premiers caractères. Voici les champs clés retournés et ce qu'ils signifient :
- Score : valeur entre 0 et 1 issue du fuzzy matching. Plus la saisie est proche d'une adresse existante, plus le score est élevé.
id_ban: identifiant stable de l'adresse dans la BAN. À conserver dans votre base pour suivre l'adresse si elle est renommée ou renumérotée.source_position: indique la précision de la géolocalisation : entrée (porte du bâtiment), parcelle (cadastre), interpolation (estimée entre deux voisins).- IRIS (plan Growth et Business) : découpage INSEE des communes > 10 000 habitants, utilisé pour croiser vos adresses avec les statistiques socio-démographiques. En savoir plus.
- Carroyage 200 m (plan Business) : maillage INSEE sans respect des limites administratives, idéal pour des analyses fines (population, ménages, revenus, logement autour de l'adresse).
Comparez les plans : sélectionnez Discovery, Starter, Growth ou Business ci-dessus pour voir la même requête renvoyer plus ou moins de champs. Chaque passage consomme un test de votre quota horaire.