Ce document décrit plusieurs scénarios concrets dans lesquels L'API Address Validation fournit des signaux de réponse qui justifient un comportement d'acceptation. de votre système. Voir Présentation des processus dans Utilisez la réponse de validation pour obtenir du contexte.
Exemple courant: accepter
Dans ce scénario, une adresse à laquelle votre système peut accepter une adresse IP l'adresse saisie par le client.
Adresse saisie | Région |
---|---|
76 Buckingham Palace Road, Londres SW1W 9TQ | Royaume-Uni |
Verdict d'une adresse acceptable
L'exemple ci-dessous met en évidence les signaux importants.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
De plus, la réponse indique ce qui suit:
hasUnconfirmedComponents
reste inchangé et vautfalse
hasInferredComponents
reste inchangé et vautfalse
hasReplacedComponents
reste inchangé et vautfalse
Lorsqu'ils sont combinés, ces signaux indiquent une adresse de haute qualité.
<ph type="x-smartling-placeholder">Exemples de cas limites: accepter
Les exemples suivants couvrent les situations dans lesquelles verdict
indique une adresse
les problèmes de qualité qui nécessitent
une enquête plus approfondie. Ces exemples
illustrer comment votre logique peut voyager de l'évaluation aux composants d'adresse ;
pour obtenir une image plus complète afin d'améliorer
la logique de votre système.
Numéro de rue non confirmé aux États-Unis
Cet exemple illustre la saisie d'une adresse en Italie avec tous les composants d'adresse
et aucun composant inféré ni remplacé. Toutefois,
validationGranularity
est ROUTE
.
Adresse saisie | Région |
---|---|
Via Fonte Grugnale, 14 unité 2, 66054 vasto CH, Italie | IT |
Verdict d'un numéro de rue non confirmé
{
"inputGranularity": "SUB_PREMISE",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE",
"addressComplete": true,
"hasUnconfirmedComponents": true
}
Un examen plus approfondi des composants de l'adresse révèle que la rue
numéro : UNCONFIRMED_BUT_PLAUSIBLE
.
{
"text": "14",
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
Numéro de rue non confirmé (États-Unis)
Cet exemple illustre la saisie d'une adresse aux États-Unis avec tous les composants d'adresse
sans composants déduits ni remplacés. Toutefois,
validationGranularity
est PREMISE_PROXIMITY
.
Adresse saisie | Région |
---|---|
975 Carson Dr, Sunnyvale, CA 94086, États-Unis | États-Unis |
Données USPS pour un numéro de rue non confirmé
{
"firstAddressLine": "975 CARSON DR",
"cityStateZipAddressLine": "SUNNYVALE CA 94086",
"city": "SUNNYVALE",
"state": "CA",
"zipCode": "94086"
"dpvConfirmation": "N",
"dpvFootnote": "AAM3",
"carrierRoute": "C031",
"carrierRouteIndicator": "D",
"postOfficeCity": "SUNNYVALE",
"postOfficeState": "CA",
"fipsCountyCode": "085",
"county": "SANTA CLARA",
}
Données USPS incomplètes pour une adresse confirmée
Cet exemple illustre la saisie d'une adresse aux États-Unis avec tous les composants d'adresse
et n'inclut aucun composant déduit ni remplacé, et une
validationGranularity
sur PREMISE
. Cependant, uspsData
n'est pas complètement
est renseigné et ne contient pas de valeur dpvConfirmation
.
Adresse saisie | Région |
---|---|
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 | États-Unis |
Verdict d'une adresse confirmée avec des données USPS incomplètes
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true,
}
Données USPS pour une adresse confirmée avec des données USPS incomplètes
{
"standardizedAddress": {
"firstAddressLine": "155 VIA CONDADO WAY",
"cityStateZipAddressLine": "PALM BEACH GARDENS",
"city": "PALM BEACH GARDENS",
"state": "FL",
"zipCode": "33418"
},
"carrierRoute": "H018",
"postOfficeCity": "PALM BEACH GARDENS",
"postOfficeState": "FL"
}