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

Neste documento, descrevemos vários cenários reais em que a API Address Validation fornece sinais de resposta que justificam um comportamento de adição de subinstalações 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 mais contexto.

Exemplo comum: adicionar subinstalações

Este cenário ilustra um endereço em que seu sistema pode solicitar que um cliente adicione um número de unidade ao endereço.

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

Veredito para um endereço sem subinstalações

O exemplo abaixo destaca o indicador importante.

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

Exemplo de caso extremo: adicionar subinstalações

O exemplo a seguir aborda uma situação em que o verdict indica problemas de qualidade de endereço que justificam uma investigação mais detalhada. Esse exemplo também ilustra como sua lógica pode ir do veredito aos componentes de endereço para ter uma visão mais completa e melhorar a lógica do sistema.

Subinstalações 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

Veredito para subinstalações ausentes 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 código postal foi substituído.

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