Aceitar endereço: exemplos

Neste documento, descrevemos vários cenários reais em que a API Address Validation fornece indicadores de resposta que justificam um comportamento de aceitação do seu sistema. Consulte Exemplos de fluxos de trabalho em Criar sua lógica de validação para mais contexto.

Exemplo comum: aceitar

Este cenário ilustra um endereço em que seu 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 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
  • hasSpellCorrectedComponents continua sendo false

Quando combinados, esses indicadores mostram um endereço de alta qualidade.

Exemplos de casos extremos: aceitar

Os exemplos a seguir abrangem situações em que o verdict indica problemas de qualidade de endereço que justificam uma investigação mais detalhada. Esses exemplos também ilustram como sua lógica pode passar do veredito para os componentes de endereço para ter uma visão mais completa e melhorar a lógica do sistema.

Número de rua não confirmado fora dos EUA

Este exemplo ilustra a entrada de um endereço italiano com todos os componentes presentes, sem componentes inferidos ou substituídos. No entanto, o validationGranularity é ROUTE.

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

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

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

Uma investigação mais detalhada 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 de rua não confirmado nos EUA

Este exemplo ilustra a entrada de um endereço dos EUA com todos os componentes 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

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

Este exemplo ilustra 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
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 EUA

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

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