Adicionar dependências ao endereço: exemplos (somente nos EUA)

Este documento descreve vários cenários reais em que a API Address Validation fornece sinais de resposta que justificam um comportamento de adicionar subunidades do seu sistema. Esses indicadores estão disponíveis apenas para endereços nos EUA. Consulte Exemplos de fluxos de trabalho em Criar sua lógica de validação para contexto.

Exemplo comum: adicionar subendereços

Este cenário ilustra um endereço em que seu sistema pode pedir a um cliente para adicionar um número de unidade.

Endereço inserido Região
1450 Brickell Avenue, Miami, FL 33131-4065 EUA

Verificação de um endereço sem subunidade

O exemplo abaixo destaca o indicador importante.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

Exemplo de caso extremo: adicionar subunidades

O exemplo a seguir aborda uma situação 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 veredito aos componentes de endereço para obter uma visão mais completa e aprimorar a lógica do sistema.

Subpremissas ausentes e componentes inferidos e substituídos

Este exemplo ilustra a entrada de um endereço dos EUA com uma localidade ausente e um código postal incorreto.

Endereço inserido Região
1450 Brickell Avenue, FL 33132-4065 EUA

Veredicto para uma subpremisa ausente e componentes inferidos e substituídos

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true,
  "hasReplacedComponents": true,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

Uma investigação mais detalhada dos componentes do endereço revela que a localidade foi inferida e o CEP foi substituído.

{
   "componentName": {
     "text": "33131",
   }
   "componentType": "postal_code",
   "confirmationLevel": "CONFIRMED",
   "replaced": true
},
{
   "componentName": {
     "text": "Miami",
     "languageCode": "en"
   }
   "componentType": "locality",
   "confirmationLevel": "CONFIRMED",
   "inferred": true
}