Gérer les adresses aux États-Unis

Ce produit ou cette fonctionnalité est en Preview (pré-DG). La prise en charge des fonctionnalités et produits pré-DG peut être limitée, et il se peut que les modifications apportées à ces fonctionnalités ou produits ne soient pas compatibles avec d'autres versions pré-DG. Les offres en pré-DG sont couvertes par les Conditions spécifiques du service Google Maps Platform. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Ce document traite de la validation des adresses aux États-Unis :

• Utiliser les données USPS dans votre workflow
• Champs USPS Delivery Point Verification (dpv)
• Messages de sécurité

Données USPS dans votre workflow

Lors de la validation d'adresses aux États-Unis, l'API Address Validation peut également remplir la partie uspsData de la réponse.

Point clé : Si votre système traite principalement ou exclusivement des adresses aux États-Unis, vous pouvez choisir d'utiliser cet objet de réponse comme premier point de référence dans votre logique de vérification. Toutefois, il est important de savoir que l'objet uspsData n'est pas garanti d'être entièrement renseigné pour chaque adresse validée par le service.

Étant donné que cet objet n'est pas toujours renseigné, vous ne devez pas vous fier à cette propriété comme seul moyen de valider les adresses. Vous devez plutôt intégrer également le verdict et les composants d'adresse dans votre système.

USPS Delivery Point Verification (DPV)

Dans le cadre de la réponse uspsData, le champ dpvConfirmation renvoie un seul caractère pour vous indiquer si l'USPS peut livrer à l'adresse fournie.

Vous pouvez utiliser ce champ pour déterminer les éléments suivants :

• la validité de l'adresse.
• si un numéro de sous-local est manquant dans l'adresse.
• si le numéro de sous-bâtiment n'existe pas dans le système de données de l'USPS.

Le service renvoie l'une des quatre valeurs dpvConfirmation ou ne renvoie aucune valeur dpvConfirmation. Le tableau ci-dessous indique le comportement recommandé que votre logique doit utiliser pour chacun des cinq résultats possibles. Pour en savoir plus sur cette logique, consultez Présentation du workflow dans Créer votre logique de validation.

Valeur	Comportement	Description
N ou vide	Corriger l'adresse	L'adresse n'a pas été validée par le DPV. Cela signifie que l'USPS ne reconnaît pas le numéro de bâtiment saisi sur la rue (ou la route) indiquée et ne peut pas y effectuer de livraison.
D	Corriger l'adresse	L'adresse a été validée par DPV pour le numéro principal uniquement, et les informations sur le numéro secondaire étaient manquantes. Cela signifie que le numéro de bâtiment saisi existe dans la rue indiquée, mais qu'un numéro de sous-bâtiment valide doit également être fourni pour que l'adresse soit entièrement validée et que le colis puisse être livré. En d'autres termes, la sous-prémisse était manquante dans l'entrée.
S	Confirmer l'adresse	L'adresse a été validée par DPV pour le numéro principal uniquement. Les informations sur le numéro secondaire étaient présentes, mais n'ont pas été validées. Cela signifie que le numéro de bâtiment saisi existe sur l'itinéraire indiqué, mais que le sous-bâtiment fourni n'existe pas dans ce bâtiment, selon l'USPS.
O	Accepter l'adresse	L'adresse a été confirmée par la validation du point de distribution pour le numéro principal et les numéros secondaires. Cela signifie que l'adresse est entièrement distribuable par l'USPS, y compris le numéro de sous-local, le cas échéant.

Le reste de cette section décrit des scénarios concrets qui utilisent les codes DPV.

Exemple de DPV N : corriger l'adresse

Cet exemple utilise un numéro de rue inexistant dans une adresse par ailleurs valide.

• Adresse saisie : 12 Amphitheatre Parkway, Mountain View, CA, 94043
• Région : États-Unis
• Le champ dpvConfirmation renvoie : N

Il s'agit d'un signal extrêmement fort indiquant que ce numéro de local n'existe pas sur cet itinéraire. Comme pour les autres adresses problématiques, votre système doit inviter l'utilisateur à apporter des corrections.

Exemple de DPV D : corriger l'adresse

Cet exemple utilise le bureau Google à New York, mais ne contient pas de sous-établissement, qui est une partie obligatoire de l'adresse. Pour le vérifier, utilisez l'adresse dans la démonstration sans informations sur la sous-adresse.

• Adresse saisie : 111, 8e avenue, New York, NY, 10011
• Région : États-Unis
• Le champ dpvConfirmation renvoie : D

Cela confirme que la sous-propriété manquait dans l'entrée. Pour obtenir une valeur DPV de Y, vous devez inclure une sous-prémisse valide dans l'entrée. Par exemple, vous pouvez inclure un sous-local valide FL 4 (4e étage) pour obtenir une valeur dpvConfirmation de "Y".

Exemple de DPV S : confirmer l'adresse

Cet exemple utilise un numéro de sous-adresse qui n'existe pas dans le bâtiment :

• Adresse saisie : 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
• Région : États-Unis
• Le champ dpvConfirmation renvoie : S

Cela indique que, bien que 1600 Amphitheatre Parkway existe en tant qu'adresse pouvant recevoir du courrier, le sous-lieu Ste 101 ne fait pas partie de l'adresse. Votre système doit confirmer ces informations avec l'utilisateur et lui permettre de les corriger.

Exemple de DPV Y : accepter l'adresse

Cet exemple utilise l'adresse du Googleplex à Mountain View, en Californie, comme adresse de qualité connue.

• Adresse saisie : 1600 Amphitheatre Parkway, Mountain View, CA, 94043
• Région : États-Unis
• Le champ dpvConfirmation renvoie : Y

L'adresse est entièrement desservie par USPS. Vous pouvez ainsi être sûr que l'API a renvoyé une adresse de bonne qualité et l'utiliser telle quelle.

Remarque : Le DPV n'indique pas si l'API Address Validation a apporté des modifications à l'entrée, comme une correction orthographique.

Messages de sécurité pour les adresses aux États-Unis

Cette section décrit les indicateurs de sécurité fournis dans les données USPS pour les adresses créées artificiellement. Cette mesure de sécurité est conçue pour empêcher la création artificielle de listes d'adresses. Elle détecte les adresses qui semblent avoir été construites artificiellement et non obtenues de manière légitime. Cela ne devrait se produire que très rarement.

Lorsque l'USPS identifie une adresse créée artificiellement, le champ errorMessage de la propriété uspsData de la réponse contient un message d'erreur décrivant le problème. Exemple :

AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.

Remarque : Lorsque uspsData indique une adresse artificielle, la réponse pour les autres propriétés de la réponse de l'API Address Validation reste inchangée.