Confirmar endereço - exemplos

Neste documento, descrevemos vários cenários reais em que a API Address Validation fornece sinais de resposta para endereços que precisam de uma confirmação do comportamento do sistema. Consulte Visão geral do fluxo de trabalho em Criar sua lógica de validação para ter mais contexto.

Observação: os exemplos são ilustrativos, mas não exaustivos.

Exemplos comuns: confirmar

O exemplo a seguir ilustra o caso de áreas metropolitanas com nomes de rua semelhantes. Suponha que um usuário pretenda inserir o endereço do Edifício D do Google em Kirkland, WA, Estados Unidos. No entanto, em vez de Kirkland como a cidade, eles entram acidentalmente em Seattle.

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

Veredito para dados substituídos

O exemplo abaixo enfatiza os sinais importantes da resposta.

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

O PREMISE_PROXIMITY indica a proximação de um endereço no nível do edifício, mas não é tão detalhado quanto SUB_PREMISE, que é a granularidade fornecida na entrada. A resposta também contém componentes não confirmados e substituídos, de modo que a combinação leva isso para a categoria confirm.

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 informado em Seattle e substituiu o CEP, um componente de nível superior, para resolver para um endereço de Seattle. Essa poderia ser uma substituição válida, mas, além do fato de que os componentes não foram confirmados, faz sentido garantir que o usuário pretenda inserir um endereço em Seattle e não algo mais, como Kirkland.

Dica :verifique 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 inserção do endereço com o cliente.

Exemplos de casos extremos: confirmar

Nos exemplos a seguir, mostramos os seguintes tipos de casos extremos:

• Inferências secundárias que ARE confirmadas. A API Address Validation infere o país, código postal ou estado, mas todo o restante é fornecido e confirmado. A combinação do nível de granularidade e confirmação faz uma pequena inferência que não precisa necessariamente de uma ação de confirmação.
• Componente de endereço inesperado NÃO confirmado. Componentes de endereço não confirmados são adicionados ao nível de risco dele. 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 precisam de uma confirmação.

Inferências secundárias que ARE confirmadas

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

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

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

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

Veredito da 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 de entrega, você pode ter um nível maior de confiança de que os dados do sistema estão corretos. Isso ocorre porque os componentes inferidos que representam uma ampla região geográfica têm correspondência mais fácil com componentes de endereço confirmados que são mais granulares. Mesmo em países onde os nomes das cidades são repetidos, como Springfield nos Estados Unidos, os outros componentes combinados com ela podem fornecer um endereço exclusivo.

Usando o exemplo acima, uma verificação de todos os componentes de endereço mostra que todos os componentes estão confirmados, o que significa que correspondem 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

Este cenário ilustra a importância de verificar quando os componentes não estão confirmados. Se um componente de endereço for inesperado, a API Address Validation vai removê-lo da saída. Nesses casos, você pode aceitar o endereço ou confirmá-lo novamente com o cliente, dependendo do seu nível de risco e confiança.

Por exemplo, um endereço pode ser de uma região onde os clientes geralmente inserem 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

Veredito do componente inesperado do endereço não confirmado

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

Além de um veredito 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 habitacional ou uma vizinhança, pode estar correta, mas ainda ser ignorada pelo correio. No entanto, como essas informações **não** são confirmadas pela API Address Validation, faz sentido confirmar com o cliente. Nesse momento, você pode ignorar a remoção ou confirmá-la.

Componente de endereço inesperado que É confirmado

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

Como resultado, quando um cliente informa um condado em um endereço no 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

Veredito para componente de endereço inesperado confirmado

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

Aqui, address_complete é avaliado como falso, e uma análise do componente de endereço revela uma sinalização inesperada.

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

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

• Confirmados como dados corretos. Isso indica que o componente é o condado correto que contém o endereço.
• Entrada inesperada. Indica um componente que não é necessário para a formatação correta do endereço.

Embora Gloucestershire seja o condado correto do endereço inserido, o endereço não está formatado corretamente. Lembre-se de que a API Address Validation também avalia informações sobre formatação adequada.

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