Choisir une solution de validation des adresses

Objectif

La validation des adresses est utile pour divers cas d'utilisation. Nous vous suggérons d'explorer d'autres considérations clés au-delà de la qualité brute des résultats des tests. Par exemple: une vue globale des produits compatibles dans un parcours utilisateur, tels que Place Autocomplete et Maps, la disponibilité régionale et la fiabilité et confiance des entreprises.

Une fois que vous êtes arrivé à l'étape d'évaluation de l'API Address Validation, voici quelques consignes que nous vous recommandons de suivre 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é
   • Alerte en cas de saisie d'adresses de mauvaise qualité
   • Corriger les données d'adresse, y compris les inférences, les remplacements et les corrections d'orthographe
   • Indiquer une adresse de livraison formatée
   • Alerte en cas de données de sous-site manquantes ou incorrectes (États-Unis uniquement)
3. Assurez-vous que l'implémentation de l'API vous apportera un avantage mesurable.

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

Préparer vos données

Votre test doit être effectué sur un échantillon de vos données d'adresses existantes. Ne sélectionnez pas manuellement les données pour le test, mais choisissez des échantillons aléatoires représentatifs des zones géographiques dans lesquelles vous exercez votre activité. 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 du point de capture. Par exemple, si vous prévoyez d'implémenter la validation des adresses dans votre processus de paiement d'e-commerce, utilisez les adresses 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: savoir envoyer une demande de validation d'adresse

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

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

Le résultat de cette étape doit être la sortie de 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. Que vous utilisiez une feuille de calcul, une base de données ou un autre outil, c'est à vous de décider.

Étudier les résultats

Prérequis de la section: savoir gérer la réponse de validation, en particulier le concept de correction, de confirmation et d'acceptation.

Dans cette section, nous allons examiner les scénarios de sortie que vous pouvez analyser pour évaluer l'adéquation de la solution.

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

Vérifier les adresses valides

Triez les données renvoyées par l'API pour déterminer l'ensemble d'adresses que votre système acceptera 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é ou 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

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 marquées comme non valides et de voir 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 d'adresses que votre système marquera comme non valides. Voici les principaux signaux à rechercher dans l'API:

• verdict.validationGranularity défini sur OTHER ou ROUTE en fonction de 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 taux de pourcentage non valide est acceptable.

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

Exemple: Adresse non valide

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. Il fait partie de l'objet Address dans le retour. 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 et collecter les informations correctes pour l'adresse qui la rend valide, en renvoyant au point de collecte des données le ou les champs spécifiques qui sont incorrects. C'est ainsi que l'API apporte de la valeur en vous fournissant des informations spécifiques sur la qualité de vos données.

Exemple: Composant manquant et non confirmé

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 d'entrée, en prenant une adresse potentiellement non valide et en renvoyant des données d'adresse valides. C'est l'un des avantages de l'API, et il est important de le capturer dans le cadre du test.

Voici les principaux signaux à rechercher:

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

Pour en savoir plus, consultez Confirmer une adresse.

La sortie de cet exercice doit être un sous-ensemble des données d'adresses auxquelles une correction a été appliquée par l'API.

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 correction

Itinéraire addressComponent

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

[États-Unis uniquement] Vérifier les adresses avec des données de sous-établissement 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-premise manquant)
  • dpvConfirmation est S (non confirmé sur site)

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

Ce test indique si vos données présentent un problème avec des sous-établissements manquants ou incorrects, tels que 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 ajouter de la valeur à votre workflow en identifiant ce problème plus tôt, ce qui vous permet d'implémenter des étapes pour collecter des données corrigées.

Exemple: Sous-prémisse manquante

Composant manquant

"missingComponentTypes": [
    "subpremise"
]

Confirmation de la DPV des données USPS

"dpvConfirmation": "D"

[États-Unis uniquement] Examiner standardizedAddress USPS

L'API Address Validation renvoie également l'adresse standardisée USPS pour les adresses aux États-Unis. Cela est particulièrement important si vous souhaitez que les adresses au format USPS soient imprimées sur vos étiquettes de livraison.

Vous pouvez consulter 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 : commencez à tester l'API Address Validation dès aujourd'hui pour vous assurer de la précision des données d'adresse, améliorer l'expérience client et simplifier 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:

• Documentation destinée aux développeurs de l'API Address Validation
• Utiliser l'API Address Validation pour traiter un grand nombre d'adresses
• Validation des adresses pour le règlement dans l'e-commerce

Contributeurs

Henrik Valve | Ingénieur DevX