Corrigir endereço: exemplos

Neste documento, descrevemos vários cenários reais em que a API Address Validation fornece indicadores de resposta que justificam um comportamento de correção do seu sistema. Os exemplos aqui são ilustrativos, mas não exaustivos. Consulte Visão geral do fluxo de trabalho em Criar sua lógica de validação para ver o contexto.

Dica :abra a demonstração da Address Validation e tente validar os endereços de exemplo por conta própria.

Exemplos comuns: correção

Nesta seção, descrevemos exemplos comuns em que a API Address Validation fornece indicadores de resposta que mostram informações de endereço de qualidade inferior.

Cidade e código postal ausentes

Este exemplo ilustra uma entrada que tem apenas o endereço, sem cidade ou código postal.

Endereço inserido	Região
21 45 40th street	EUA

Veredito para cidade e código postal ausentes

O exemplo abaixo enfatiza os indicadores importantes da resposta.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

Esses indicadores mostram que o endereço não pode ser entregue. Portanto, consulte o addressComponents para saber mais:

{
  "componentName": {
    "text": "21",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "45 40th street",
    "languageCode": "en"
  },
  "componentType": "route",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "United States",
    "languageCode": "en"
  },
  "componentType": "country",
  "confirmationLevel": "CONFIRMED"
}

A API Address Validation retorna apenas o país (Estados Unidos) como CONFIRMED. Ela retorna todos os outros componentes de endereço como UNCONFIRMED_BUT_PLAUSIBLE, com algumas omissões importantes nos dados, como localidade e código postal.

Ação:para esse endereço, a ação recomendada é solicitar ao usuário as informações que faltam.

Número do endereço ausente

Este exemplo mostra um número de rua ausente.

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

Veredito para número do endereço ausente

{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

O validationGranularity é ROUTE, o que indica uma correspondência com a rua, mas não há informações suficientes para chegar ao local. Além disso, a propriedade addressComplete está ausente do veredito e, portanto, é false. Uma consulta adicional do objeto address revela um tipo de componente ausente:

"missingComponentTypes": [
        "street_number"
      ]

Ação:nesse caso, a ação recomendada é solicitar ao usuário as informações que faltam.

Exemplos de casos extremos: correção

Em algumas situações, a correção, confirmação ou aceitação de um endereço depende do seu cenário de negócios específico. Os exemplos abaixo ilustram cenários que podem não se enquadrar estritamente em uma categoria de correção.

Número da rua não confirmado

Nesse cenário, a API Address Validation não pode confirmar o número da rua fornecido, mas indica que o endereço está completo.

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

Veredito para número de rua não confirmado

O exemplo abaixo enfatiza os indicadores importantes.

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

Vale a pena investigar a combinação de uma granularidade de validação apenas para aproximação no nível da premissa com componentes não confirmados. Uma consulta da propriedade addressComponents mostra o seguinte componentType não confirmado:

{
  "componentName": {
    "text": "84",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

Aqui, o confirmation_level do street_number está definido como UNCONFIRMED_BUT_PLAUSIBLE. Não confirmado significa que o serviço não consegue encontrar o número 84 no conjunto de dados, e plausível significa que os dados do componente ainda podem ser válidos.

Ação:aceite a entrada como foi inserida ou confirme com o cliente se o número da rua inserido está correto ou se é um erro. Sua resposta depende do nível de risco associado à entrega. Consulte as orientações para implementação em Criar sua lógica de validação.

Subpremise ausente

Esse cenário descreve um endereço que não tem apenas um sublocal, como um número de apartamento ou departamento. Caso contrário, a API Address Validation poderá validar totalmente o endereço. Como acontece quando qualquer componente de endereço está ausente, o addressComplete é false e, portanto, não está presente na inspeção manual do veredito.

Observação: em alguns países, a API Address Validation não consegue detectar uma subinstalação ausente. Nos EUA, uma SUB_PREMISE ausente indica um endereço não entregável.

Por exemplo, suponha que um cliente insira um endereço válido para o escritório do assessor da cidade de São Francisco, mas não inclua o número da sala.

Endereço inserido	Região
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102	EUA

Veredito para subpremissa ausente

Neste exemplo, o veredito não exibe a propriedade addressComplete, portanto, ela é false. Por isso, você sabe que pelo menos um elemento de endereço é inesperado, não resolvido ou está ausente.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true

}

Uma consulta address revela o seguinte:

"missingComponentTypes": [
        "subpremise"
      ]

Após uma consulta mais detalhada, os dados do USPS fornecem um código dpvConfirmation de D, que também indica uma subinstalação ausente.

Ação:para esse endereço, a ação recomendada é solicitar ao usuário as informações que faltam.