Confirmar endereço - exemplos

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

**Dica**: abra a demonstração da Address Validation e valide os endereços de exemplo.

Exemplos comuns: confirmar

O exemplo a seguir ilustra o caso de áreas metropolitanas com nomes de ruas semelhantes. Suponha que um usuário queira inserir o endereço do Google Building D em Kirkland, WA, Estados Unidos. No entanto, em vez de Kirkland como cidade, ele insere Seattle sem querer.

Endereço inserido	Região
Building D, 451 7th Avenue South, Seattle, WA 98033	EUA

Veredicto para dados substituídos

O exemplo abaixo enfatiza os indicadores importantes do veredicto.

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

O nível de granularidade indica a proximidade de um endereço de edifício, mas não é tão detalhado quanto SUB_PREMISE, que é a granularidade fornecida na entrada.PREMISE_PROXIMITY A resposta também contém componentes não confirmados e substituídos. Portanto, a combinação os coloca na categoria confirmar.

Uma consulta dos componentes de endereço revela as seguintes áreas de preocupação:

{
  "componentName": {
    "text": "451",
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
...
{
  "componentName": {
    "text": "98104",
  },
  "componentType": "postal_code",
  "confirmationLevel": "CONFIRMED",
  "replaced": true
}
...
{
  "componentName": {
    "text": "Building D",
    "language_code": "en"
  },
  "componentType": "subpremise",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
.......

    "unconfirmedComponentTypes": [
      "street_number",
      "subpremise"
    ]

Nesse caso, a API Address Validation encontrou uma aproximação do endereço fornecido em Seattle e substituiu o CEP, um componente de nível superior, para resolver um endereço de Seattle. Essa pode ser uma substituição válida, mas, junto com o fato de que os componentes não foram confirmados, faz sentido garantir que o usuário queira inserir um endereço de Seattle e não outro, como Kirkland.

Dica: confira o endereço correto na demonstração, usando 451 7th Avenue South, Kirkland, WA 98033 para ver a resposta do endereço originalmente pretendido.

Ação:confirme a entrada de endereço com o cliente.

Exemplos de casos extremos: confirmar

Os exemplos a seguir ilustram os seguintes tipos de casos extremos:

• Inferências menores que SÃO confirmadas. A API Address Validation infere o país, o CEP ou o estado, mas todo o resto é fornecido e confirmado. A combinação da granularidade e do nível de confirmação resulta em uma inferência menor que não precisa necessariamente de uma ação de confirmação.
• Componente de endereço inesperado NÃO confirmado. Os componentes de endereço não confirmados aumentam o nível de risco do endereço. Isso pode justificar uma confirmação.
• Componente de endereço inesperado que É confirmado. O componente não é estritamente necessário para um endereço adequado, e a API Address Validation o remove da saída. Problemas de formatação geralmente não justificam uma confirmação.

Inferências menores que SÃO confirmadas

Quando combinada com dados confirmados de um nível mais granular, a API ainda pode fazer uma inferência correta se a entrada estiver faltando apenas um componente dos seguintes tipos:

• Cidade
• Estado
• Código postal
• País

Por exemplo, um cliente fornece um endereço de rua válido para um restaurante McDonald's em Springfield, Massachusetts, mas esquece de inserir a cidade e fornece um CEP sem a extensão de 4 dígitos.

Endereço inserido	Região
1402 Allen St, MA 01118	EUA

Veredicto para cidade ausente

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

Em situações em que a API Address Validation infere componentes de nível superior para produzir um endereço entregável, você pode ter um nível de confiança maior de que os dados do sistema estão corretos. Isso ocorre porque os componentes inferidos que representam uma região geográfica ampla são mais facilmente correspondidos a componentes de endereço confirmados que são mais granulares. Mesmo em países em que os nomes de cidades são repetidos, como Springfield nos Estados Unidos, os outros componentes combinados a ele podem fornecer um endereço exclusivo.

Usando o exemplo acima, uma verificação em todos os componentes de endereço mostra que cada componente é confirmado, o que significa que ele corresponde aos dados armazenados pela API Address Validation e que o serviço também infere dois componentes de nível superior.

{
  "componentName": {
    "text": "Springfield",
    "languageCode": "en"
  },
  "componentType": "locality",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
},
{
  "componentName": {
    "text": "1806"
  },
  "componentType": "postal_code_suffix",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
}

Ação:aceitar. Endereços como esses fornecem granularidade confirmada suficiente, além da confirmação de componentes inferidos, para que sua lógica possa aceitá-los como válidos sem a necessidade de solicitar ao cliente.

Componente de endereço inesperado NÃO confirmado

Esse cenário ilustra a importância de verificar quando os componentes não são confirmados. Se um componente de endereço for inesperado, a API Address Validation o removerá da saída. Nesses casos, é possível aceitar o endereço ou confirmá-lo novamente com o cliente, dependendo do nível de risco e de confiança.

Por exemplo, um endereço pode ser de uma região em que os clientes costumam inserir informações inofensivas ignoradas pela autoridade postal. Nesse caso, você aceitaria o endereço. No entanto, em alguns casos, um componente não confirmado pode não ser o que o cliente quer.

Endereço inserido	Região
1 Rue Grenache, la caritat 2, 34630 Saint-Thibéry	França

Veredicto para componente de endereço inesperado não confirmado

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "unconfirmedComponents": true
}

Além de um veredicto com componentes não confirmados, a API Address Validation retorna o seguinte endereço formatado:

"formattedAddress": "1 Rue Grenache, 34630 Saint-Thibéry, France",

Uma verificação de componentes não confirmados mostra que a API removeu la caritat 2 do endereço retornado:

{
  "componentName": {
    "text": "la caritat 2",
    "languageCode": "fr"
  },
  "componentType": "sublocality_level_1",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
  "unexpected": true
}

Ação:confirmar. Nesse caso, a sublocalidade, que pode indicar um distrito residencial ou um bairro, pode estar correta, mas ainda ser ignorada pela autoridade postal. No entanto, como essa informação **não** é confirmada por pela API Address Validation, faz sentido confirmá-la com o cliente. Nesse momento, você ignora a remoção ou a confirma.

Componente de endereço inesperado que É confirmado

Este exemplo ilustra a inclusão de um condado do Reino Unido no endereço fornecido, que é uma prática comum. No entanto, isso não é um requisito da autoridade postal do Reino Unido e é essencialmente ignorado. Consulte postoffice.co.uk e Como endereçar correspondências internacionais e do Reino Unido.

Como resultado, quando um cliente fornece um condado em um endereço do Reino Unido, o serviço avalia isso como uma entrada inesperada.

Endereço inserido	Região
33 Dunalley St, Cheltenham, Gloucestershire, GL50 4AP	Reino Unido

Veredicto para componente de endereço inesperado que É confirmado

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

Aqui, address_complete é avaliado como falso, e uma análise do componente de endereço revela um indicador inesperado.

{
  "componentName": {
    "text": "Gloucestershire",
    "languageCode": "en"
  },
  "componentType": "administrative_area_level_2",
  "confirmationLevel": "CONFIRMED",
  "unexpected": true
}

Esse componente é inesperado e confirmado, o que significa o seguinte:

• Confirmado como dados corretos. Isso indica que o componente é o condado correto que contém o endereço.
• Inesperado como entrada. Indica um componente não necessário para a formatação adequada do endereço.

Embora Gloucestershire seja o condado correto para o endereço inserido, o endereço em si está formatado incorretamente. Lembre-se de que a API Address Validation também avalia as informações para formatação adequada.

Ação: para esse cenário, a ação recomendada é ignorar esse indicador e aceitar o endereço.