Validation d'adresse et géocodification

Les services d'adresse DQE valident, normalisent et enrichissent les adresses postales en temps réel. Cet article décrit chaque service d'adresse et ce qu'il renvoie.

DQE fournit deux ensembles de endpoints API d'adresse aux fonctionnalités équivalentes :

• Legacy WS — les endpoints originaux de type WS, toujours entièrement pris en charge.
• RESTful — les nouveaux endpoints REST, recommandés pour les nouvelles intégrations.

Validation d'adresse

La validation d'adresse vérifie si une adresse soumise peut être reconnue, standardisée et évaluée par rapport aux données de référence disponibles pour le pays concerné. DQE fournit plusieurs endpoints de validation :

• CheckAddress — valide une adresse complète et renvoie un format postal normalisé avec un indicateur de délivrabilité. Pour les adresses françaises, DQE s'appuie sur les données de référence de La Poste (RNVP — Rectification et Normalisation des adresses en Vue de la Poste).
  Legacy WS : /RNVP/ — RESTful : /{VERSION}/checkaddress/

Pour les adresses internationales, le niveau de précision varie selon le pays et la couverture disponible.

Autocomplétion d'adresse

L'autocomplétion d'adresse suggère et complète les adresses au fur et à mesure de la saisie de l'utilisateur, réduisant les erreurs de saisie à la source. Elle est conçue pour une utilisation dans des champs de formulaire en temps réel.

• Mode Funnel — guide l'utilisateur étape par étape : code postal → rue → complément.
  Legacy WS : /CP/ → /ADR/ → /COMPL/ — RESTful : /{VERSION}/funnelpostcode/ → /{VERSION}/funneladdress/ → /{VERSION}/funnelcompl/
• Mode Single — renvoie des suggestions à partir d'une saisie en texte libre, puis une étape de complément pour les détails de bâtiment ou d'appartement.
  Legacy WS : /SINGLEV2/ → /COMPLV2/ — RESTful : /{VERSION}/single/ → /{VERSION}/compl/

Géocodification

La géocodification renvoie les coordonnées géographiques (latitude et longitude) pour une adresse donnée. Le niveau de précision dépend des données de référence disponibles :

• Précision au niveau de la rue lorsque l'adresse complète est reconnue
• Précision au niveau de la ville lorsque la rue ne peut pas être identifiée
• Aucune coordonnée renvoyée lorsque l'adresse ne peut pas être géolocalisée

Legacy WS : /LATLG/

Géocodification inversée

La géocodification inversée renvoie des informations d'adresse à partir d'un jeu de coordonnées géographiques. Elle est utile pour enrichir des données de localisation lorsque vous disposez de coordonnées mais pas d'adresse postale.

Legacy WS : /SINGLE/ (avec les paramètres lat/lng)

Format de réponse

Tous les services d'adresse renvoient des réponses au format JSON, incluant les composants d'adresse normalisés et des indicateurs de qualité décrivant le niveau de validation atteint.

Articles associés

• Comment DQE valide-t-il les adresses postales ?
• Pourquoi DQE normalise-t-il une adresse différemment de ce qui était attendu ?
• Pourquoi une adresse n'est-elle pas renvoyée par DQE ?