Choisir une solution de validation des adresses

Organigramme présentant les étapes de test de manière générale.

Objectif

La validation d'adresse est utile pour de nombreux cas d'utilisation. Nous vous suggérons d'examiner les principales considérations au-delà de la qualité brute des résultats des tests. Par exemple, une vue globale des produits compatibles dans un flux utilisateur tel que Place Autocomplete et Maps, la disponibilité régionale et la fiabilité et la confiance des entreprises.

Une fois que vous avez atteint le point d'évaluation de l'API Address Validation, voici quelques consignes que nous vous recommandons d'utiliser lors de vos tests.

Les objectifs de ce test sont les suivants :

  1. Vérifiez que l'API Address Validation convient à votre cas d'utilisation.
  2. Vérifiez comment l'API Address Validation répond aux exigences de vos solutions, par exemple :
    • Identifier les adresses de bonne qualité.
    • Alertes pour les entrées de mauvaise qualité.
    • Correction des données d'adresse, y compris les inférences, les remplacements et les corrections orthographiques.
    • Indiquez une adresse de livraison formatée.
    • Alertes en cas de données de sous-établissement manquantes ou incorrectes (États-Unis uniquement)
  3. Assurez-vous de bénéficier d'un avantage mesurable en implémentant l'API.

Après avoir effectué votre test, vous pourrez répondre aux questions ci-dessus et déterminer si l'API est adaptée à votre activité.

Préparer vos données

Votre test doit être effectué sur un échantillon de vos données d'adresse existantes. Ne sélectionnez pas manuellement les données de test, mais choisissez des échantillons aléatoires représentatifs des zones géographiques dans lesquelles vous opérez. Cela signifie que si vous exercez votre activité à la fois aux États-Unis et au Royaume-Uni, mais que 70 % de votre activité est réalisée au Royaume-Uni et 30 % aux États-Unis, l'échantillon doit refléter cette répartition.

Utilisez les adresses à partir du point de capture. Par exemple, si vous prévoyez d'implémenter la validation d'adresse dans le processus de paiement de votre site d'e-commerce, utilisez les adresses telles qu'elles ont été saisies par vos clients dans le formulaire, avant tout traitement existant qui pourrait être remplacé par l'implémentation de l'API Address Validation.

Préparez un échantillon d'environ 5 000 à 10 000 enregistrements pour le test.

Appeler l'API

Prérequis de la section : comprendre comment envoyer une demande de validation d'adresse.

Une fois les données préparées, vous devrez exécuter chaque enregistrement d'adresse par rapport à l'API.

Consultez la documentation de l'API Address Validation pour savoir comment appeler l'API. Nous avons également un article décrivant les bonnes pratiques à suivre pour utiliser l'API Address Validation afin de traiter un grand nombre d'adresses.

À l'issue de cette étape, vous devriez obtenir des données de l'API pour chaque enregistrement d'adresse. Vous pourrez ensuite analyser les résultats pour déterminer si l'API convient à votre cas d'utilisation. Vous pouvez utiliser une feuille de calcul, une base de données ou un autre outil.

Étudier les résultats

Prérequis de la section : comprendre comment gérer la réponse de validation, en particulier les concepts de corriger, confirmer et accepter.

Dans cette section, nous aborderons les scénarios de résultats que vous pouvez analyser pour évaluer l'adéquation de la solution.

Présentation des principaux champs d'API abordés dans ce document

Données de réponse

De quoi s'agit-il ?

Comment évaluer

En quoi cela vous aide-t-il ?

verdict.inputGranularity

Décrit la précision de l'adresse saisie.

SUB_PREMISE

PREMISE

PREMISE_PROXIMITY

BLOQUER

ROUTE

AUTRE

Vous permet de déterminer si l'adresse saisie contient suffisamment de données pour être potentiellement valide.

verdict.validationGranularity

Décrit la validation globale de l'adresse.

SUB_PREMISE

PREMISE

PREMISE_PROXIMITY

BLOQUER

ROUTE

AUTRE

Vous permet de déterminer la qualité globale de l'adresse dans la sortie de l'API.

verdict.hasInferredComponents

Indique si l'API a déduit un composant.

Vrai ou faux

L'API peut ajouter des composants manquants lorsqu'elle peut inférer les données. Par exemple, un code d'État manquant.

verdict.hasReplacedComponents

Indique si l'API a remplacé un composant.

Vrai ou faux

Dans certains cas, l'API peut remplacer les composants incorrects par les données appropriées.

verdict.addressComplete

Indique si l'adresse est complète.

Vrai ou faux

Si l'API détermine que l'adresse de sortie comporte tous les composants nécessaires, la valeur est "true".

address.missingComponentTypes

Signal pour avertir si l'adresse comporte des composants manquants.

Consultez le tableau 2 pour connaître les valeurs.

Mettez en évidence les composants manquants d'une adresse incomplète.

Examiner les adresses valides

Triez les données renvoyées par l'API pour déterminer l'ensemble des adresses que votre système accepterait comme valides. Voici les principaux signaux à rechercher dans l'API :

  • verdict.validationGranularity contient PREMISE ou une version ultérieure.
  • verdict.addressComplete correspond à true.
  • Aucun composant inféré ni remplacé.

Pour en savoir plus, consultez Accepter une adresse.

Le résultat de cet exercice doit être un sous-ensemble des données d'adresse qui seraient acceptées comme valides par votre système. À ce stade, vous pouvez déterminer les éléments suivants :

  • Le taux d'acceptation est-il acceptable ?
  • Si vous utilisez un workflow de validation d'adresse existant, le taux d'acceptation est-il équivalent ou meilleur ?

Exemple : Adresse valide

Adresse saisie

Région

76 Buckingham Palace Road, Londres SW1W 9TQ

Royaume-Uni

Verdict

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true
}

Examiner les adresses non valides

Cette étape vous permet d'examiner manuellement certaines des données d'adresse qui ont été marquées comme non valides et de vérifier si, sans utiliser l'API Address Validation, cette adresse non valide pourrait entraîner des problèmes en aval.

Triez les données renvoyées par l'API pour déterminer l'ensemble des adresses que votre système marquerait comme non valides. Voici les principaux signaux à rechercher dans l'API :

  • verdict.validationGranularity défini sur OTHER ou ROUTE selon votre niveau de risque.
  • verdict.addressComplete correspond à false.

Pour en savoir plus, consultez Corriger une adresse.

Le résultat de cet exercice doit être un sous-ensemble des données d'adresse qui seraient marquées comme non valides par votre système. À ce stade, vous pouvez déterminer si le pourcentage de taux non valides est acceptable.

Il est important de noter que le marquage des adresses comme non valides est une fonctionnalité essentielle de l'API Address Validation. Un taux élevé d'adresses marquées comme non valides ne reflète pas nécessairement une mauvaise qualité de l'API. L'API vous indique qu'il y a un problème avec l'adresse. Cela peut rendre votre workflow plus efficace en détectant les erreurs plus tôt, avant qu'elles ne causent des problèmes en aval.

Exemple : Adresse non valide

Adresse saisie

Région

21 45 40th street

USA

Verdict

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

Examiner les composants manquants ou non confirmés

À ce stade, vous pouvez également examiner les composants manquants ou non confirmés. Cela fait partie de l'objet Address dans la réponse. Les deux champs sont missingComponentTypes et unconfirmedComponentTypes.

Utilisez ces champs pour identifier la raison pour laquelle une adresse est marquée comme non valide par l'API. Collectez les informations correctes pour l'adresse afin qu'elle soit valide en renvoyant au point de collecte de données le ou les champs spécifiques qui sont incorrects. C'est une façon pour l'API de vous apporter de la valeur en vous fournissant des informations spécifiques sur la qualité de vos données.

Exemple : Composant manquant et non confirmé

Adresse saisie

Région

Fake St, New York, NY 10011

USA

Verdict

{
     "inputGranularity": "ROUTE",
     "validationGranularity": "OTHER",
     "geocodeGranularity": "OTHER",
     "hasUnconfirmedComponents": true
}

Composants manquants et non confirmés

"missingComponentTypes": [
    "street_number"
],
"unconfirmedComponentTypes": [
    "route"
]

Examiner les adresses avec corrections

L'API Address Validation peut corriger les données saisies, en prenant une adresse potentiellement non valide et en générant des données d'adresse valides. C'est l'une des façons dont l'API apporte de la valeur. Il est important de l'inclure dans le test.

Voici les principaux signaux à rechercher :

  • inferred, replaced ou spellCorrected défini sur true dans l'un des addressComponents.
  • verdict.hasInferredComponents ou verdict.hasReplacedComponents défini sur true.

Pour en savoir plus, consultez Confirmer une adresse.

Le résultat de cet exercice doit être un sous-ensemble des données d'adresse auxquelles l'API a appliqué une correction.

Une partie de ces données peut être examinée manuellement pour déterminer si l'API apporte des corrections à vos données qui réduiraient les frictions dans votre workflow en aval.

Exemple : Adresse avec une correction

Adresse saisie

Région

76 Bruckingm Palace Road, Londres SW1W 9TQ

Royaume-Uni

Route addressComponent

{
    "componentName": {
        "text": "Buckingham Palace Road",
        "languageCode": "en"
    },
    "componentType": "route",
    "confirmationLevel": "CONFIRMED",
    "spellCorrected": true
}

[États-Unis uniquement] Examiner une adresse dont les informations sur le sous-lieu sont manquantes ou incorrectes

L'API Address Validation peut déterminer si un complément d'adresse est manquant ou incorrect pour les adresses aux États-Unis.

Voici les principaux signaux à rechercher :

  • Dans l'objet Address :
    • unconfirmedComponentTypes contient subpremise
    • missingComponentTypes contient subpremise
  • Dans l'objet UspsData :
    • dpvConfirmation est D (sous-préfecture manquante)
    • dpvConfirmation est S (sous-établissement non confirmé)

Pour en savoir plus, consultez Gérer les adresses aux États-Unis.

Ce test permet de déterminer si vos données comportent des problèmes liés à des sous-lieux manquants ou incorrects, comme des numéros d'appartement. Cela peut entraîner des problèmes en aval, en particulier pour les cas d'utilisation de diffusion. L'API Address Validation peut apporter de la valeur à votre workflow en identifiant ces problèmes plus tôt, ce qui vous permet de mettre en œuvre des étapes pour collecter des données corrigées.

Exemple : Sous-lieu manquant

Adresse saisie

Région

111 8th Avenue, Manhattan, NY 10011

États-Unis

Pièce manquante

"missingComponentTypes": [
    "subpremise"
]

Confirmation DPV des données USPS

"dpvConfirmation": "D"

[États-Unis uniquement] Examiner l'adresse standardisée USPS

L'API Address Validation renvoie également l'adresse normalisée USPS pour les adresses aux États-Unis. Cela est particulièrement important si vous avez besoin d'imprimer des adresses au format USPS sur vos étiquettes de livraison.

Vous pouvez examiner UspsAddress pour afficher ces données et déterminer si elles apportent de la valeur à votre workflow.

Exemple : Adresse standardisée USPS

"standardizedAddress": {
    "firstAddressLine": "111 8TH AVE FL 11",
    "cityStateZipAddressLine": "NEW YORK NY 10011-5201",
    "city": "NEW YORK",
    "state": "NY",
    "zipCode": "10011",
    "zipCodeExtension": "5201"
}

Conclusion

Commencez à tester l'API Address Validation dès aujourd'hui pour vous assurer d'obtenir des données d'adresse précises, améliorer l'expérience client et rationaliser vos opérations commerciales. Après avoir suivi les scénarios de test décrits ci-dessus, vous disposerez des informations nécessaires pour déterminer si l'API Address Validation apportera de la valeur à votre workflow.

Lectures complémentaires suggérées :

Contributeurs

Henrik Valve | Ingénieur DevX