Escolher uma solução de validação de endereço

Diagrama de fluxo mostrando a visão geral das etapas de teste.

Objetivo

A validação de endereço oferece valor para vários casos de uso, e há considerações importantes além da qualidade bruta dos resultados dos testes que sugerimos que você analise. Por exemplo, uma visão geral dos produtos compatíveis em um fluxo de usuários, como Place Autocomplete e Maps, disponibilidade regional e confiança e confiabilidade empresarial.

Quando você chegar ao ponto de avaliar a API Address Validation, confira algumas diretrizes que recomendamos usar como parte dos seus testes.

Os objetivos deste teste são:

  1. Confirme se a API Address Validation é adequada para seu caso de uso.
  2. Verifique como a API Address Validation atende aos requisitos das suas soluções, como:
    • Identificar endereços de boa qualidade.
    • Alertas para resolver entradas de baixa qualidade.
    • Fazer correções nos dados de endereço, incluindo inferências, substituições e correções ortográficas.
    • Fornecer um endereço formatado para entrega.
    • Alertas sobre dados de subunidade ausentes ou incorretos (somente nos EUA).
  3. Verifique se você vai receber um benefício mensurável ao implementar a API.

Depois de realizar o teste, você poderá responder às perguntas acima e determinar se a API é adequada para sua empresa.

Preparar os dados

O teste precisa ser realizado em uma amostra dos seus dados de endereço atuais. Não escolha dados manualmente para o teste, mas selecione amostras aleatórias que sejam representativas das regiões geográficas em que você opera. Isso significa que, se você operar nos Estados Unidos e no Reino Unido, mas 70% dos seus negócios forem realizados no Reino Unido e 30% nos EUA, a amostra deverá refletir essa divisão.

Use endereços do ponto de captura. Por exemplo, se você planeja implementar a validação de endereço no checkout do e-commerce, use os endereços inseridos pelos clientes no formulário, antes de qualquer processamento que possa ser substituído pela implementação da API Address Validation.

Prepare uma amostra de aproximadamente 5.000 a 10.000 registros para o teste.

Chamar a API

Pré-requisito da seção: entenda como enviar uma solicitação de validação de endereço.

Depois de preparar os dados, será necessário executar cada registro de endereço na API.

Consulte a documentação da API Address Validation para saber como chamar a API. Também temos um artigo que descreve as práticas recomendadas para usar a API Address Validation para processar endereços em grande volume.

O resultado dessa etapa deve ser a saída de dados da API para cada registro de endereço. Em seguida, você poderá analisar os resultados para determinar a adequação da API ao seu caso de uso. Você pode usar uma planilha, um banco de dados ou outra ferramenta.

Analisar os resultados

Pré-requisito da seção: entenda como processar a resposta de validação, principalmente o conceito de corrigir, confirmar e aceitar.

Nesta seção, vamos discutir cenários de saída que você pode analisar para avaliar a adequação da solução.

Visão geral dos principais campos da API abordados neste documento

Dados de resposta

O que é?

Como avaliar

Como isso ajuda?

verdict.inputGranularity

Descreve a granularidade de entrada do endereço.

SUB_PREMISE

PREMISSA

PREMISE_PROXIMITY

BLOQUEAR

ROTA

OUTRO

Permite determinar se o endereço de entrada tem dados suficientes para ser válido.

verdict.validationGranularity

Descreve a validação geral da saída do endereço.

SUB_PREMISE

PREMISSA

PREMISE_PROXIMITY

BLOQUEAR

ROTA

OUTRO

Permite determinar a qualidade geral do endereço na saída da API.

verdict.hasInferredComponents

Indica se a API inferiu um componente.

Verdadeiro/Falso

A API pode adicionar componentes ausentes quando consegue inferir os dados. Por exemplo, um código de estado ausente.

verdict.hasReplacedComponents

Indica se a API substituiu um componente.

Verdadeiro/Falso

Em alguns casos, a API consegue substituir componentes incorretos pelos dados certos.

verdict.addressComplete

Indica se o endereço está completo.

Verdadeiro/Falso

Será verdadeiro se a API determinar que o endereço de saída tem todos os componentes necessários.

address.missingComponentTypes

Sinal para avisar se o endereço não tiver componentes.

Consulte a tabela 2 para conferir os valores.

Destacar componentes ausentes de um endereço incompleto.

Revisar endereços válidos

Ordene os dados retornados da API para determinar o conjunto de endereços que seu sistema aceitaria como válidos. Os principais indicadores da API são:

  • verdict.validationGranularity contém PREMISE ou melhor.
  • verdict.addressComplete é true.
  • Nenhum componente inferido ou substituído.

Consulte aceitar um endereço para mais informações.

O resultado deste exercício deve ser um subconjunto dos dados de endereço que seriam aceitos como válidos pelo seu sistema. Nesse ponto, você pode determinar:

  • A taxa de porcentagem de aceitação é aceitável?
  • Se você usa um fluxo de trabalho de validação de endereço, a taxa de aceitação é equivalente ou melhor?

Exemplo: endereço válido

Endereço inserido

Região

76 Buckingham Palace Road, Londres SW1W 9TQ

Reino Unido

Veredito

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

Revisar endereços inválidos

Esta etapa é uma oportunidade de revisar manualmente alguns dos dados de endereço marcados como inválidos e verificar se, sem usar a API Address Validation, esse endereço inválido pode causar problemas downstream.

Classifique os dados retornados da API para determinar o conjunto de endereços que seu sistema marcaria como inválidos. Os principais indicadores da API são:

  • verdict.validationGranularity definido como OTHER ou ROUTE, dependendo do seu nível de risco.
  • verdict.addressComplete é false.

Consulte corrigir um endereço para mais informações.

O resultado deste exercício deve ser um subconjunto dos dados de endereço que seriam marcados como inválidos pelo seu sistema. Nesse momento, você pode determinar se a taxa de porcentagem inválida é aceitável.

É importante observar que marcar endereços como inválidos é uma parte essencial da funcionalidade da API Address Validation, e uma alta taxa de endereços marcados como inválidos não reflete necessariamente um problema na API. A API informa que há algo errado com o endereço, o que pode trazer eficiência ao seu fluxo de trabalho ao detectar erros mais cedo, antes de causar problemas downstream.

Exemplo: endereço inválido

Endereço inserido

Região

21 45 40th street

EUA

Veredito

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

Analisar componentes ausentes ou não confirmados

Nesta etapa, também é possível revisar componentes ausentes ou não confirmados. Isso faz parte do objeto Address no retorno. Os dois campos são missingComponentTypes e unconfirmedComponentTypes.

Use esses campos para detectar o motivo de um endereço ser marcado como inválido pela API e colete as informações corretas para que ele seja válido. Para isso, envie de volta ao ponto de coleta de dados os campos específicos que estão incorretos. Essa é uma maneira de a API agregar valor, fornecendo informações específicas sobre a qualidade dos seus dados.

Exemplo: componente ausente e não confirmado

Endereço inserido

Região

Rua Falsa, Nova York, NY 10011

EUA

Veredito

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

Componentes ausentes e não confirmados

"missingComponentTypes": [
    "street_number"
],
"unconfirmedComponentTypes": [
    "route"
]

Revisar endereços com correções

A API Address Validation pode corrigir dados de entrada, transformando um endereço potencialmente inválido em dados válidos. Essa é uma maneira de a API agregar valor, e é importante capturar isso como parte do teste.

Os principais indicadores são:

  • inferred, replaced ou spellCorrected definido como true em qualquer um dos addressComponents.
  • verdict.hasInferredComponents ou verdict.hasReplacedComponents definido como true.

Consulte confirmar um endereço para mais informações.

A saída deste exercício deve ser um subconjunto dos dados de endereço que receberam uma correção aplicada pela API.

Uma parte desses dados pode ser revisada manualmente para determinar se a API está fazendo correções que reduzem o atrito no fluxo de trabalho downstream.

Exemplo: endereço com uma correção

Endereço inserido

Região

76 Bruckingm Palace Road, Londres SW1W 9TQ

Reino Unido

Rota addressComponent

{
    "componentName": {
        "text": "Buckingham Palace Road",
        "languageCode": "en"
    },
    "componentType": "route",
    "confirmationLevel": "CONFIRMED",
    "spellCorrected": true
}

[Somente nos EUA] Analisar endereços com dados de subpremissa ausentes ou incorretos

A API Address Validation pode determinar se uma subinstalação está ausente ou incorreta para endereços dos EUA.

Os principais indicadores são:

  • No objeto Address:
    • unconfirmedComponentTypes contém subpremise
    • missingComponentTypes contém subpremise
  • No objeto UspsData:
    • dpvConfirmation é D (subpremissa ausente)
    • dpvConfirmation é S (subpremissa não confirmada)

Consulte processar endereços dos Estados Unidos para mais informações.

Esse teste vai mostrar se há um problema nos seus dados com subendereços ausentes ou incorretos, como números de apartamentos. Isso pode causar problemas downstream, especialmente para casos de uso de entrega. A API Address Validation pode agregar valor ao seu fluxo de trabalho ao identificar isso mais cedo, permitindo que você implemente etapas para coletar dados corrigidos.

Exemplo: subpremise ausente

Endereço inserido

Região

111 8th Avenue, Manhattan, NY 10011

EUA

Componente ausente

"missingComponentTypes": [
    "subpremise"
]

Confirmação de DPV de dados do USPS

"dpvConfirmation": "D"

[Somente nos EUA] Analisar "standardizedAddress" do USPS

A API Address Validation também retorna o endereço padronizado do USPS para endereços dos Estados Unidos. Isso é especialmente importante se você precisar que os endereços formatados pelo USPS sejam impressos nos rótulos de envio.

UspsAddress pode ser revisado para conferir esses dados e determinar se eles agregam valor ao seu fluxo de trabalho.

Exemplo: endereço padronizado dos correios dos EUA

"standardizedAddress": {
    "firstAddressLine": "111 8TH AVE FL 11",
    "cityStateZipAddressLine": "NEW YORK NY 10011-5201",
    "city": "NEW YORK",
    "state": "NY",
    "zipCode": "10011",
    "zipCodeExtension": "5201"
}

Conclusão

Comece a testar hoje mesmo a API Address Validation para garantir dados de endereço precisos, melhorar a experiência do cliente e simplificar as operações da sua empresa. Depois de seguir os cenários de teste descritos acima, você terá as informações necessárias para determinar se a API Address Validation vai agregar valor ao seu fluxo de trabalho.

Leitura adicional sugerida:

Colaboradores

Henrik Valve | Engenheiro de DevX