Service
Autocomplétion d'adresse
française en temps réel
Proposez des suggestions d'adresses instantanées pendant la frappe. Tolérante aux fautes, basée sur la BAN, avec coordonnées GPS incluses dans chaque résultat.
Pourquoi c'est compliqué
- Les champs d'adresse en texte libre produisent des données inexploitables
- Les utilisateurs font des fautes, abrègent ou inversent les termes
- Construire une autocomplétion maison nécessite infrastructure + index de recherche
- Les solutions propriétaires coûtent cher à l'échelle et exposent vos données
Ce que fait TrustyData
- Suggestions en quelques millisecondes, adaptées à l'usage en frappe temps réel
- Fuzzy matching : tolère fautes et abréviations courantes
- Coordonnées GPS WGS84 et Lambert 93 incluses dans chaque suggestion
- Filtre par département, code postal ou commune
- Données BAN open data française : 26 millions d'adresses
- Données Datanova pour une meilleure recherche sur les lieu-dits
Démo API
Exemple de requête / réponse
Résultats de recherche après 3 caractères tapés. Réponse en moins de 30 ms.
Requête
GET /v1/address/autocomplete
?q=1+rivoli+Paris
&limit=2
Réponse JSON
{
"status": "OK",
"message": "",
"choices": [
{
"score": 0.96,
"adresse": "1 Rue de Rivoli, 75004 Paris 4e Arrondissement",
"id": "a459aed8-3ae4-4b20-b640-3ea8767f5aed",
"numero": "1",
"rep": "",
"nom_voie": "Rue de Rivoli",
"code_postal": "75004",
"nom_commune": "Paris 4e Arrondissement",
"code_insee": "75104",
"id_fantoir": "75104_8249",
"code_insee_ancienne_commune": "",
"nom_ancienne_commune": "",
"nom_ld": "",
"libelle_acheminement": "PARIS",
"nom_afnor": "RUE DE RIVOLI",
"source_position": "commune",
"certification_commune": true,
"cad_parcelles": null,
"id_ban": "75104_8249_00001",
"geolocalisation": {
"lat": 48.855534,
"lon": 2.359276,
"x": 652987.24,
"y": 6861912.49,
"type_position": "parcelle"
},
"geocoding": {
"iris": "1401",
"code_iris": "751041401",
"nom_iris": "Saint-Gervais 1",
"type_iris": "H"
},
"statistical_grid": {
"id_inspire": "CRS3035RES200mN2889200E3761200",
"id_carr1km": "CRS3035RES1000mN2889000E3761000",
"i_est_cr": 0,
"id_carr_n": "CRS3035RES200mN2889200E3761200",
"groupe": 859061,
"depcom": "75104",
"i_pauv": 0,
"id_car2010": "CRS3035RES200mN2889200E3761200",
"ind": 1163.5,
"men": 647,
"men_pauv": 99,
"men_1ind": 336,
"men_5ind": 15,
"men_prop": 170,
"men_fmp": 67,
"ind_snv": 39730452.1,
"men_surf": 34127,
"men_coll": 630,
"men_mais": 17,
"log_av45": 570,
"log_45_70": 0,
"log_70_90": 28,
"log_ap90": 47,
"log_inc": 2,
"log_soc": 180,
"ind_0_3": 45,
"ind_4_5": 17,
"ind_6_10": 41.5,
"ind_11_17": 58.5,
"ind_18_24": 46.5,
"ind_25_39": 296,
"ind_40_54": 261,
"ind_55_64": 162,
"ind_65_79": 134,
"ind_80p": 63,
"ind_inc": 39,
"i_est_1km": 0
}
},
{
"score": 0.64,
"adresse": "1 Rue Rivoli Véronèse, 31810 Venerque",
"id": "64b2d72b-3b9a-4a74-a8be-8e601e9808eb",
"numero": "1",
"rep": "",
"nom_voie": "Rue Rivoli Véronèse",
"code_postal": "31810",
"nom_commune": "Venerque",
"code_insee": "31572",
"id_fantoir": "31572_0240",
"code_insee_ancienne_commune": "",
"nom_ancienne_commune": "",
"nom_ld": "",
"libelle_acheminement": "VENERQUE",
"nom_afnor": "RUE RIVOLI VERONESE",
"source_position": "commune",
"certification_commune": true,
"cad_parcelles": [
"315720000I0661"
],
"id_ban": "31572_0240_00001",
"geolocalisation": {
"lat": 43.433809,
"lon": 1.446187,
"x": 574144.53,
"y": 6260649.54,
"type_position": "entrée"
},
"geocoding": {
"iris": "0000",
"code_iris": "315720000",
"nom_iris": "Venerque",
"type_iris": "Z"
},
"statistical_grid": {
"id_inspire": "CRS3035RES200mN2297800E3628200",
"id_carr1km": "CRS3035RES1000mN2297000E3628000",
"i_est_cr": 0,
"id_carr_n": "CRS3035RES1000mN2297000E3628000",
"groupe": 456152,
"depcom": "31572",
"i_pauv": 0,
"id_car2010": "CRS3035RES200mN2297800E3628200",
"ind": 156,
"men": 70,
"men_pauv": 16,
"men_1ind": 24,
"men_5ind": 4,
"men_prop": 12,
"men_fmp": 20,
"ind_snv": 2744405.5,
"men_surf": 5175,
"men_coll": 36,
"men_mais": 34,
"log_av45": 1,
"log_45_70": 4,
"log_70_90": 3,
"log_ap90": 62,
"log_inc": 0,
"log_soc": 55,
"ind_0_3": 2.5,
"ind_4_5": 2,
"ind_6_10": 8.5,
"ind_11_17": 23,
"ind_18_24": 16,
"ind_25_39": 22,
"ind_40_54": 39,
"ind_55_64": 16,
"ind_65_79": 16,
"ind_80p": 5,
"ind_inc": 6,
"i_est_1km": 0
}
}
]
}
Données fournies
Champs retournés par l'API
Les champs retournés dépendent du plan souscrit.
Coordonnées Dès Starter
Coordonnées GPS WGS84 et Lambert 93 de l'adresse
Adresse Discovery - Gratuit
Adresse vérifieée et complète
score Discovery - Gratuit
Indice de confiance de 0 à 1
Détail de l'adresse Discovery - Gratuit
Numéro, la voie, le code postal, le lieu-dit et la commune.
Informations officielles Discovery - Gratuit
Code INSEE, code FANTOIR et la certification de la commune.
Géocodage IRIS Dès Growth
Code et nom de l'IRIS.
CarroyageBusiness
Code carreau 200m.
Infos socio-démoBusiness
Indice de pauvreté, le nombre de ménages, tranche d'âge, etc.
Cas d'usage
Secteurs qui utilisent l'autocomplétion d'adresse
E-commerce & Livraison
Saisie d'adresse de livraison sans erreur
Guidez l'utilisateur vers une adresse valide dès les premiers caractères. Réduisez les erreurs de saisie et les retours colis liés à des adresses incorrectes.
SaaS & CRM
Enrichissement automatique des champs adresse
À la sélection d'une suggestion, remplissez automatiquement rue, code postal, commune et coordonnées GPS. Vos données sont propres dès la création du contact.
Assurance & Banque
Formulaire de souscription guidé
Proposez une saisie assistée lors de la déclaration de domicile. Accélérez le parcours client et garantissez la cohérence des dossiers sans traitement a posteriori.
Formules
Quel plan pour l'autocomplétion d'adresses ?
Disponible dès le plan Discovery gratuit. Passez à un plan supérieur pour un quota plus élevé.
Discovery
5 000 req / mois
- ✓ Plan gratuit
- ✓ Autocomplétion d'adresses
- ✓ Autocomplétion de communes
- ✓ Score de confiance
Starter
50 000 req / mois
- ✓ Vérification unitaire
- ✓ Géolocalisation GPS
- ✓ Géolocalisation inverse
FAQ
Questions fréquentes
-
Combien de suggestions sont retournées par appel ?
Par défaut, l'API retourne 20 suggestions classées par pertinence. Ce nombre est configurable via le paramètrelimit. -
L'autocomplétion est-elle tolérante aux fautes de frappe ?
Oui, l'API utilise une recherche approximative (fuzzy matching) qui tolère les erreurs de frappe courantes, les inversions de caractères et les variantes orthographiques de voies françaises. -
Puis-je filtrer par département ou code postal ?
Oui. L'API utilise un moteur de reconnaissance sémantique qui décompose les adresses saisies en composants (voie, code postal, commune, département). C'est donc l'api qui décide d'ajouter ou de supprimer les filtres pour vous rendre les propositions les plus pertinentes. -
Comment intégrer l'autocomplétion dans mon formulaire ?
Déclenchez un appelfetchà chaque frappe (avec un debounce de 200ms) et affichez les résultats dans une liste déroulante. -
Les coordonnées GPS sont-elles incluses dans les suggestions ?
Oui, chaque suggestion inclutlatitudeetlongitudeWGS84 et Lambert 93 si votre abonnement le permet. Vous pouvez donc placer l'adresse sur une carte dès la sélection, sans appel supplémentaire. -
Avec le plan Business, le volume d'informations par item est important. Est ce que cela peut nuire à la performance ?
En effet, le plan Business inclut des données supplémentaires (géocodage IRIS et carreaux) qui augmentent la taille de la réponse. Il est possible de limiter les informations retournées avec l'optiondetails. Dans ce cas, l'API ne retourne que l'adresse, le score et l'id qui permet de faire unviewpour récupérer le détail de l'adresse sélectionnée.
Aidez vos utilisateurs à vous donner la bonne adresse
Disponible gratuitement dès le plan Discovery. Aucune carte bancaire requise.
Services liés