Use a API Address Validation para processar endereços com alto volume

Objetivo

Como desenvolvedor, você costuma trabalhar com conjuntos de dados que contêm endereços de clientes que podem não ser de boa qualidade. Você precisa garantir que os endereços estejam corretos para casos de uso que vão da verificação do ID do cliente à entrega e muito mais.

A Validação de endereço API é um produto Plataforma Google Maps que você pode usar para validar um endereço. No entanto, ela só processa um endereço de cada vez. Neste documento, veremos como usar a validação de endereço em alto volume em diferentes cenários, desde o teste de APIs para validação de endereço única e recorrente.

Casos de uso

Agora vamos entender os casos de uso em que a validação de endereço de alto volume é úteis.

Teste

Muitas vezes, você quer testar a API Address Validation executando milhares de endereços IP internos. Talvez você tenha os endereços em um arquivo com valores separados por vírgulas e queira para validar a qualidade dos endereços.

Validação única de endereços

Durante a integração à API Address Validation, você precisa validar do banco de dados de endereços atual no banco de dados do usuário.

Validação recorrente de endereços

Diversos cenários exigem a validação de endereços de forma recorrente:

• Talvez você tenha agendado tarefas para validar endereços com os detalhes capturados durante o dia, por exemplo, de inscrições de clientes, detalhes de pedidos, programações.
• Você pode receber despejos de dados com endereços de diferentes departamentos, por exemplo, de vendas a marketing. O novo departamento que recebe o endereços IP geralmente querem validá-los antes de usá-los.
• É possível que você colete endereços durante pesquisas ou em várias promoções e posteriormente na atualização do sistema on-line. Você quer confirmar se os endereços corretamente ao inseri-los no sistema.

Aprofundamento técnico

Para os fins deste documento, consideramos que:

• Você está chamando a API Address Validation com endereços de um cliente banco de dados (ou seja, um banco de dados com detalhes do cliente)
• Você pode armazenar sinalizações de validade em cache em endereços individuais em seu banco de dados.
• As flags de validade são recuperadas da API Address Validation quando um que cada cliente faça login.

.

Faça um teste:acesse o console do Google Cloud e ative a API Address Validation.

Cache para uso em produção

Observação: os elementos específicos de resposta descritos nas podem ser armazenadas por no máximo 30 dias consecutivos. Todas as esses elementos de resposta PRECISAM ser excluídos após esse período.

Ao usar a API Address Validation, você geralmente quer armazenar em cache parte do da chamada de API. Enquanto nossos Termos de Limite do serviço quais dados podem ser armazenados em cache e quaisquer dados que podem ser armazenados em cache com a API Address Validation precisam ser armazenados em cache na conta de um usuário. Isso significa que, no banco de dados, endereço de e-mail ou metadados de endereço precisam ser armazenados em cache no endereço de e-mail ou outro ID principal.

Para o caso de uso de validação de endereço de alto volume, o armazenamento em cache de dados precisa seguir as API Address Validation Específico de serviço Termos, descrito na Seção 11.3. Com base nessas informações, você poderá determinar se o endereço de um usuário pode ser inválido. Nesse caso, você vai solicitar o usuário para um endereço corrigido na próxima interação com seu para o aplicativo.

• Dados do AddressComponent objeto
  • confirmationLevel
  • inferred
  • spellCorrected
  • replaced
  • unexpected

Se você quiser armazenar em cache qualquer informação sobre o endereço real, esses dados só podem ser armazenados em cache com o consentimento do usuário. Isso garante que o usuário esteja bem por que um determinado serviço está armazenando seu endereço e está de acordo com os termos de compartilhar seus endereços.

Um exemplo de consentimento do usuário seria a interação direta com um endereço de e-commerce formulário em uma página de finalização da compra. Há um entendimento de que você armazenará em cache processar o endereço para fins de envio de pacotes.

Com o consentimento do usuário, você pode armazenar em cache formattedAddress e outros componentes importantes da resposta. No entanto, em um cenário headless, um usuário não pode fornecer consentimento, já que a validação do endereço está acontecendo no back-end. Portanto, é possível armazenar em cache informações muito limitadas nesse cenário sem comando.

Entender a resposta

Observação: também há um ótimo guia sobre como Criar uma validação lógica, que explica como interpretar a resposta.

Se a resposta da API Address Validation tiver os marcadores a seguir, pode ter certeza de que o endereço de entrada tem qualidade de entrega:

• O marcador addressComplete no Veredito é true,
• O validationGranularity no Veredito o objeto é PREMISE ou SUB_PREMISE
• Nenhum dos elementos AddressComponent são marcadas como:
  • Inferred(Observação: inferred=truepode acontecer quando addressComplete=true)
  • spellCorrected
  • replaced
  • unexpected e
• confirmationLevel: O nível de confirmação na AddressComponent está definido comoCONFIRMEDouUNCONFIRMED_BUT_PLAUSIBLE

Se a resposta da API não contiver os marcadores acima, o endereço de entrada provavelmente era de má qualidade, e você pode armazenar em cache flags no banco de dados para refletir isso. As sinalizações em cache indicam que o endereço como um todo tem baixa qualidade, enquanto sinalizações mais detalhadas, como Correção ortográfica, indicam o tipo específico de resolver um problema de qualidade. Na próxima interação com um cliente com um endereço sinalizado baixa qualidade, é possível chamar a API Address Validation com a endereço IP. A API Address Validation retornará o endereço corrigido que você podem ser exibidas usando um prompt da interface. Depois que o cliente aceitar o endereço formatado é possível armazenar em cache os seguintes itens da resposta:

• formattedAddress
• postalAddress
• addressComponent componentNamesou
• UspsData standardizedAddress

Implementar uma validação de endereço sem comando

Observação: o que é headless? Um software capaz de funcionar em um dispositivo sem uma interface gráfica do usuário, como um script executado no lado do servidor ou na linha de comando. Vamos usar esse termo para descrever quando o software for usado sem uma GUI.

Com base na discussão acima:

• Muitas vezes, é necessário armazenar em cache parte da resposta do endereço Validation em lote por motivos comerciais.
• No entanto, os Termos de Serviço em A Plataforma Google Maps restringe quais dados podem ser armazenados em cache.

Na seção a seguir, vamos discutir um processo de duas etapas para conformidade os Termos de Serviço e implementar a validação de endereços de alto volume.

Etapa 1:

Na primeira etapa, vamos aprender a implementar um endereço de alto volume script de validação de um pipeline de dados atual. Esse processo permitirá que você armazenar campos específicos da resposta da API Address Validation em termos de Maneira em conformidade com o serviço.

Diagrama A:o diagrama a seguir mostra como um pipeline de dados pode ser aprimorado. usando uma lógica de validação de endereço de alto volume.

De acordo com os Termos de Serviço, você pode armazenar em cache os seguintes dados da addressComponent:

• confirmationLevel
• inferred
• spellCorrected
• replaced
• unexpected

Portanto, durante esta etapa da implementação, armazenaremos em cache o que foi mencionado em relação ao UserID.

Para mais informações, confira detalhes sobre os dados reais do Terraform.

Etapa 2:

Na etapa 1, coletamos feedback de que alguns endereços no conjunto de dados de entrada podem não devem ser de alta qualidade. Na próxima etapa, vamos usar esses endereços sinalizados apresentá-los ao usuário e obter o consentimento dele para corrigir o endereço IP.

Diagrama B: este diagrama mostra como uma integração completa do usuário o fluxo de consentimento teria esta aparência:

1. Quando o usuário fizer login, verifique se você armazenou as flags de validação em cache no sistema.
2. Se houver flags, você deverá apresentar ao usuário uma interface para corrigir e atualizar o endereço.
3. É possível chamar a API Address Validation novamente com a versão atualizada ou em cache endereço correto e apresente-o ao usuário para confirmação.
4. Se o endereço for de boa qualidade, a API Address Validation retornará uma formattedAddress:
5. Você pode apresentar esse endereço ao usuário se correções foram feitas feitas ou aceitar silenciosamente se não houver correções.
6. Depois que o usuário aceitar, armazene o formattedAddress em cache no banco de dados.

.

Observação :depois que esse fluxo de trabalho for concluído, o validationFlags armazenado em cache deverá ser excluída.

Conclusão

A Validação de endereço em alto volume é um caso de uso comum que você provavelmente encontrará em muitos aplicativos. Este documento tenta demonstrar alguns cenários e padrão de design sobre como implementar essa solução em conformidade com o Termos de Serviço da Plataforma.

Também escrevemos uma implementação de referência de endereços de alto volume Validação como uma biblioteca de código aberto no GitHub. Confira para começar usando a Validação de Endereço de Alto Volume. Acesse também o artigo sobre padrões de design sobre como usar a biblioteca em diferentes cenários.

Próximas etapas

Faça o download de Melhore a finalização da compra, o envio e as operações com endereços confiáveis Artigo e consulte Como melhorar a finalização da compra, a entrega e as operações com o Address Validação Webinar.

Leitura adicional sugerida:

• Aplicativos de validação de endereço de alto volume
• Biblioteca Python no GitHub
• Confira a demo do Address Validação

Colaboradores

O Google mantém este artigo. Os colaboradores a seguir o escreveram originalmente.
Autores principais:

Válvula Henrik | Engenheiro de soluções
Thomas Anglaret | Soluções Engenheiro
Sarthak Ganguly | Soluções Engenheiro