Aceitar endereço: exemplos

Este documento descreve 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 a Visão geral do fluxo de trabalho em Usar a resposta de validação para mais contexto.

Exemplo comum: aceitar

Este cenário ilustra um endereço que seu sistema aceitaria se fosse inserido por um cliente.

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

Veredicto para 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 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 de endereço que justificam uma investigação mais aprofundada. Esses exemplos também ilustram como sua lógica pode passar do veredicto para os componentes de endereço para obter uma imagem 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, a validationGranularity é ROUTE.

Endereço inserido Região
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia 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 aprofundada dos componentes de 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 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, a 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 confirmados, sem componentes inferidos ou substituídos e uma 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

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