Aceitar endereço: exemplos

Este documento descreve vários cenários reais em que a API Address Validation fornece sinais de resposta que justificam um comportamento de aceitação do seu sistema. Consulte Visão geral do fluxo de trabalho em Usar a resposta de validação para contexto.

Exemplo comum: aceitar

Este cenário ilustra um endereço no qual seu sistema aceita um endereço inserido por um cliente.

Endereço inserido Região
76 Buckingham Palace Road, Londres SW1W 9TQ Reino Unido

Veredito de um endereço aceitável

O exemplo abaixo destaca os indicadores importantes.

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

Além disso, a resposta indica o seguinte:

  • hasUnconfirmedComponents continua sendo false
  • hasInferredComponents continua sendo false
  • hasReplacedComponents continua sendo false

Quando combinados, esses sinais indicam um endereço de alta qualidade.

Exemplos de casos extremos: aceitar

Os exemplos a seguir abrangem situações em que verdict indica problemas de qualidade que precisam ser investigados mais a fundo. Esses exemplos também ilustrarão como a lógica pode passar do veredito até os componentes do endereço para ter uma visão mais completa e aprimorar a lógica do sistema.

Número não confirmado do endereço fora dos EUA

Este exemplo ilustra a entrada de um endereço italiano com todos os componentes de endereço presentes, além de nenhum componente inferido ou substituído. No entanto, o validationGranularity é ROUTE.

Endereço inserido Região
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Itália IT

Veredito de um número de rua não confirmado

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "ROUTE",
  "geocodeGranularity": "ROUTE",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
}

Uma investigação mais aprofundada dos componentes do 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 não confirmado nos EUA

Neste exemplo, ilustramos a entrada de um endereço nos 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 – EUA EUA

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 do USPS incompletos para um endereço confirmado

Este exemplo ilustra a entrada de um endereço nos 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
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 EUA

Veredito de um endereço confirmado com dados da USPS incompletos

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

Dados do USPS para um endereço confirmado com dados do USPS incompletos

{
  "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"
}