Neste documento, descrevemos várias situações reais em que a API Address Validation fornece sinais de resposta que garantem um comportamento de aceitação do sistema. Consulte Visão geral do fluxo de trabalho em Usar a resposta de validação para mais contexto.
Exemplo comum: aceite
Neste cenário, ilustramos um endereço em que o sistema aceitaria um endereço inserido por um cliente.
Endereço inserido | Região |
---|---|
76 Buckingham Palace Road, Londres SW1W 9TQ | Reino Unido |
Veredito para um endereço aceitável
O exemplo abaixo destaca os sinais importantes.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
Além disso, a resposta indica o seguinte:
hasUnconfirmedComponents
continua sendofalse
hasInferredComponents
continua sendofalse
hasReplacedComponents
continua sendofalse
Quando combinados, esses sinais indicam um endereço de alta qualidade.
Exemplos de caso extremo: aceite
Os exemplos a seguir abrangem situações em que verdict
indica problemas de qualidade que precisam ser investigados mais profundamente. Esses exemplos também
ilustram como a lógica pode ir do veredito até os componentes de endereço
para ter uma visão mais completa e melhorar a lógica do sistema.
Número da rua não confirmado nos EUA
Este exemplo ilustra a entrada de um endereço na Itália com todos os componentes de endereço presentes, sem componentes inferidos ou substituídos. No entanto, o
validationGranularity
é ROUTE
.
Endereço inserido | Região |
---|---|
Via Fonte Grugnale, 14 unidade 2, 66054 Vasto CH, Italia | IT |
Veredito para um número não confirmado
{
"inputGranularity": "SUB_PREMISE",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE",
"addressComplete": true,
"hasUnconfirmedComponents": true
}
Uma investigação mais detalhada dos componentes de endereço revela que o número da rua é UNCONFIRMED_BUT_PLAUSIBLE
.
{
"text": "14",
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
Número da rua dos EUA não confirmado
Neste exemplo, ilustramos a entrada de um endereço dos EUA com todos os componentes de endereço presentes, sem componentes inferidos ou substituídos. No entanto, o
validationGranularity
é PREMISE_PROXIMITY
.
Endereço inserido | Região |
---|---|
975 Carson Dr, Sunnyvale, CA 94086 | Estados Unidos |
Dados do USPS para um número de rua não confirmado
{
"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",
}
Dados incompletos do USPS para um endereço confirmado
Neste exemplo, ilustramos a entrada de um endereço dos EUA com todos os componentes de endereço confirmados, sem componentes inferidos ou substituídos, e um validationGranularity
de PREMISE
. No entanto, o uspsData
não está totalmente preenchido e não contém um valor dpvConfirmation
.
Endereço inserido | Região |
---|---|
Via Condado, 155, Jardins de Palm Beach, FL 33418-1703 | Estados Unidos |
Veredito para um endereço confirmado com dados do USPS incompletos
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true,
}
Dados do USPS para um endereço confirmado com dados incompletos do USPS
{
"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"
}