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

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

Objetivo

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

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

Os objetivos deste teste são:

  1. Confirmar se a API Address Validation é adequada para seu caso de uso.
  2. Verificar como a API Address Validation atende aos requisitos da sua solução, como:
    • Identificar endereços de boa qualidade.
    • Alertar sobre entradas de endereço 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 envio.
    • Alertar sobre dados de subinstalação ausentes ou incorretos (somente nos EUA).
  3. Garantir que você receba 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 selecione os dados para o teste, mas escolha amostras aleatórias que sejam representativas das regiões geográficas em que você opera. Isso significa que, se você opera nos Estados Unidos e no Reino Unido, mas 70% dos seus negócios são realizados no Reino Unido e 30% nos EUA, a amostra precisa refletir essa divisão.

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

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

Chamar a API

Pré-requisito da seção: entender 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 orientações sobre como chamar a API. Também temos um artigo que descreve as práticas recomendadas para usar a Address Validation API para processar endereços em grande volume.

O resultado dessa etapa precisa 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. Seja usando uma planilha, um banco de dados ou outra ferramenta, a escolha é sua.

Analisar os resultados

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

Nesta seção, vamos discutir os 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 discutidos neste documento

Dados de resposta

O que é?

Como avaliar

Qual a utilidade desse recurso?

verdict.inputGranularity

Descreve a granularidade de entrada do endereço.

SUB_PREMISE

PREMISE

PREMISE_PROXIMITY

BLOCK

ROUTE

OTHER

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

PREMISE

PREMISE_PROXIMITY

BLOCK

ROUTE

OTHER

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

A API pode substituir componentes incorretos pelos dados corretos em alguns cenários.

verdict.addressComplete

Indica se o endereço está completo.

Verdadeiro/Falso

Se a API determinar que o endereço de saída tem todos os componentes necessários, esse valor será verdadeiro.

address.missingComponentTypes

Indica se o endereço está faltando componentes.

Consulte a tabela dois para valores.

Destaca os componentes ausentes de um endereço incompleto.

Analisar endereços válidos

Classifique os dados retornados da API para determinar o conjunto de endereços que seu sistema aceitaria como válidos. Os principais indicadores a serem procurados na 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.

A saída desse exercício precisa ser um subconjunto dos dados de endereço que seriam aceitos como válidos pelo seu sistema. Nesse momento, você pode determinar:

  • A porcentagem de aceitação é aceitável?
  • Se você usa um fluxo de trabalho de validação de endereço atual, 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
}

Analisar endereços inválidos

Esta etapa é uma oportunidade de analisar manualmente alguns dos dados de endereço que foram 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 a serem procurados na 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.

A saída desse exercício precisa ser um subconjunto dos dados de endereço que seriam marcados como inválidos pelo seu sistema. Nesse momento, você pode determinar se a 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 mal na API. A API está informando que há algo errado com o endereço, o que pode trazer eficiência ao seu fluxo de trabalho, detectando 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

Nessa fase, os componentes ausentes ou não confirmados também podem ser analisados. Isso faz parte do objeto de endereço no retorno. Os dois campos são missingComponentTypes e unconfirmedComponentTypes.

Use esses campos para ajudar a detectar o motivo pelo qual um endereço é marcado como inválido pela API e colete as informações corretas para o endereço que permitiria que ele fosse válido, enviando 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

Fake St, New York, NY 10011

EUA

Veredito

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

Componentes ausentes e não confirmados

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

Analisar endereços com correções

A API Address Validation pode fazer correções nos dados de entrada, recebendo uma entrada de endereço potencialmente inválida e gerando dados de endereço válidos. Essa é uma maneira de a API agregar valor, e é importante capturá-la como parte do teste.

Os principais indicadores a serem procurados são:

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

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

A saída desse exercício precisa ser um subconjunto dos dados de endereço que tiveram uma correção aplicada pela API.

Uma parte desses dados pode ser analisada manualmente para determinar se a API está fazendo correções nos seus dados que reduziriam 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

Route addressComponent

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

[Somente nos EUA] Analisar o endereço com dados de subinstalação 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 a serem procurados são:

  • No objeto Endereço:
    • unconfirmedComponentTypes contém subpremise
    • missingComponentTypes contém subpremise
  • No objeto UspsData:
    • dpvConfirmation é D (subinstalação ausente)
    • dpvConfirmation é S (subinstalação 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 subinstalações ausentes ou incorretas, 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, identificando isso mais cedo, permitindo que você implemente etapas para coletar dados corrigidos.

Exemplo: subinstalação 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 o USPS standardizedAddress

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 do USPS sejam impressos nas etiquetas de envio.

O UspsAddress pode ser analisado para visualizar esses dados e determinar se ele agrega valor ao seu fluxo de trabalho.

Exemplo: endereço padronizado do USPS

"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: inicie os testes da API Address Validation hoje mesmo para garantir dados de endereço precisos, melhorar a experiência do cliente e otimizar as operações comerciais. 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.

Leituras sugeridas:

Colaboradores

Henrik Valve | Engenheiro de DevX