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

Este documento descreve vários cenários do mundo real 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 subunidades

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

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 imagem mais completa e melhorar 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 CEP incorreto.

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

Verificação para uma subpremise 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
}