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 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

Verificação de um endereço aceitável

O exemplo abaixo destaca os indicadores importantes.

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

Além disso, o verdict indica o seguinte:

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

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

Exemplos de casos extremos: aceitar

Os exemplos a seguir abordam situações em que o verdict indica problemas de qualidade de endereço que exigem mais investigação. Esses exemplos também ilustram como sua lógica pode ir do veredicto aos 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 de um país que não seja os 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 unidade 2, 66054 Vasto CH, Itália IT

Veredicto 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ível de confirmação do 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 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 da 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 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

Verificação de um endereço confirmado com dados incompletos do USPS

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

Dados dos Correios para um endereço confirmado com dados incompletos dos Correios

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