API Address Validation no Planilhas Google

Objetivo

Neste documento, veremos como usar a API Address Validation no Planilhas Google para testar o serviço de maneira rápida e leve.

Como não desenvolvedor, embora esteja disposto a trabalhar com dados provenientes da Plataforma Google Maps, como a API Address Validation, talvez queira encontrar uma maneira de começar a usar o serviço sem muita ajuda das equipes técnicas.

Casos de uso

Agora vamos entender os casos de uso em que a API Address Validation no Planilhas Google é útil:

• Teste: como empresa, você pode testar rapidamente os recursos da API Address Validation usando seus próprios endereços.
• Comparar: compare os resultados da API Address Validation com os resultados de outros endpoints, como a API Geocoding ou a API Places.
• Teste A/B: variações do Teste A/B do mesmo conjunto de dados para entender o que pode fornecer resultados mais adequados.
  

Modelo do Planilhas Google

A solução é um Google Sheets que vem com funções personalizadas do Apps Script que vão realizar solicitações em sequência para a API Address Validation.

Dica: este exemplo serve apenas como orientação para integração. É necessário garantir a qualidade antes de usar com seus aplicativos. O suporte está disponível nos produtos, como a API Address Validation usada neste exemplo.

É possível executar endereços pela API seguindo as etapas abaixo (requer uma conta do Google e uma chave de API):

1. Acesse a planilha de amostra e, no menu, selecione Arquivo > Fazer uma cópia
   . Você precisa fazer login na sua conta do Google ou criar uma.
   
2. Ative a API Address Validation e gere uma chave de API no Console do Cloud.
   
3. Na guia "Chave de API + painel", substitua a célula B2 pela sua chave de API.
   
4. Copiar/colar endereços no modelo (em uma planilha separada para formatar os dados: concatenar número da rua, nome, cidade, CEP)
   
5. Selecione as células da planilha e, em seguida, selecione "Validação de endereço" > "Seleção da API Address Validation" no menu
   
6. Na primeira execução, uma mensagem "Autorização necessária" vai aparecer para conceder acesso ao Apps Script.
   

Atenção: proteja sua chave de API restringindo o uso dela apenas à API Address Validation. Para evitar o uso inesperado, compartilhe a planilha apenas com partes confiáveis e exclua a chave no console depois de concluir a análise.

Dica :para obedecer aos Termos da Plataforma Google Maps, exclua a planilha após 30 dias, porque ela tem histórico integrado.

Termos do Google Maps Platform

A solução é fornecida para fins de teste em um conjunto limitado de endereços: Período de armazenamento em cache permitido: 30 dias corridos consecutivos, após os quais o cliente precisa (1) excluir o conteúdo do Google Maps em cache ou (2) substituir por dados do usuário final fornecidos por confirmação ou correção do usuário final. Consulte a tabela 11.3.1 dos Termos de Serviço da Plataforma Google Maps (permissões de armazenamento em cache):

• placeId
  
• Local: valores de latitude, valores de longitude
  
• veredito
  
• formattedAddress
  
• postalAddress
  
• addressComponent: componentName
  
• USPS Data standardizedAddress
  

Considerações

• Desempenho: prossiga em blocos de 1.000 linhas, não mais do que isso de uma vez. O script pode ser interrompido, por exemplo, quando exceder a cota da API por segundo, prossiga a partir da linha em que o script foi interrompido.
• Você pode acessar o código em Menu > Extensões > Apps Script e criar sua própria versão do script de acordo com sua necessidade.
• Preços da API Address Validation.

Conclusão

A API Address Validation no Planilhas Google permite que pessoas que não são desenvolvedoras comecem a consultar a API Address Validation e entendam como ela pode ser estratégica para a empresa. Este documento tenta demonstrar como qualquer pessoa pode começar a consultar a API criando uma chave de API e usando o modelo fornecido do Google Sheets.

Próximas ações

Leitura adicional sugerida:

• Validação de endereço para finalização de compra de e-commerce
• Biblioteca High Volume Address Validation

Colaboradores

Este artigo é mantido pelo Google. Os colaboradores a seguir o escreveram originalmente.
Autor principal:

Thomas Anglaret | Engenheiro de soluções\