Aceitar endereço: exemplos

Este documento descreve vários cenários reais em que a API Address Validation fornece sinais de resposta que garantem um comportamento de aceitação do sistema. Consulte a 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 em que seu sistema aceitaria um endereço inserido por um cliente.

Endereço inserido Região
76 Buckingham Palace Road, London 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

Quando combinados, esses indicadores indicam 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 que exigem mais investigação. Esses exemplos também ilustram como a lógica pode passar do veredito para os componentes de endereço para ter uma imagem mais completa e melhorar a lógica do sistema.

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

Este exemplo ilustra a entrada de um endereço italiano 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, 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 da rua não confirmado nos EUA

Este exemplo ilustra 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 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 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 dos Correios

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

Dados dos Correios para um endereço confirmado com dados dos Correios 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"
}