API Address Validation no Planilhas Google

Objetivo

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

Se você não é desenvolvedor e tem disposição para trabalhar com dados da Plataforma Google Maps, como a API Address Validation, pode ser útil começar a usar o serviço sem precisar da ajuda das equipes técnicas.

Casos de uso

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

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

Modelo do Planilhas Google

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

Dica: este exemplo é apenas para orientação de integração. É preciso garantir a qualidade antes de usá-los com seus aplicativos. Há suporte disponível para os produtos, como a API Address Validation usada neste exemplo.

Você pode executar endereços pela API seguindo as etapas abaixo (requer uma Conta do Google e uma chave de API):

1. Navegue até a planilha de amostra e, no menu, selecione: Arquivo > Fazer uma cópia
   . É necessário 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 do Planilhas “Chave de API + painel”, substitua a célula B2 pela sua chave de API.
   
4. Copie/cole endereços no modelo (em uma página separada para formatar os dados: concatene o número da rua, nome, cidade, CEP)
   
5. Selecione as células das planilhas e, em seguida, selecione "Menu "Validação de endereço" > "Seleção da API Address Validation"
   
6. Na primeira execução, a mensagem "Autorização necessária" será exibida para fornecer acesso ao Apps Script.
   

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

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

Termos do Google Maps Platform

A Solução é fornecida para fins de teste com um conjunto limitado de endereços: Período de armazenamento em cache permitido: 30 dias corridos consecutivos, após os quais o Cliente precisará (1) excluir o Conteúdo do Google Maps armazenado em cache ou (2) substituir pelos dados do Usuário Final fornecidos por meio de confirmação ou correção. 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
  
• Dados padronizados do USPS
  

considerações

• Desempenho: continue em blocos de 1.000 linhas, no máximo, de uma só vez. O script pode ser interrompido, por exemplo, ao exceder a cota da API por segundo, e prosseguir da linha em que ele parou.
• Você pode acessar o código em Menu > Extensões > Apps Script e criar sua própria versão do script adaptada às suas necessidades
• Preços para a API Address Validation.

Conclusão

Com a API Address Validation no Planilhas Google, quem não é desenvolvedor pode começar a consultar a API Address Validation e entender como ela pode ser estratégica para os negócios. Neste documento, mostramos como qualquer pessoa pode começar a consultar a API criando uma chave de API e usando o modelo do Planilhas Google.

Próximas ações

Leitura adicional sugerida:

• Validação de endereço para finalização de compra de e-commerce
• Biblioteca de validação de endereços de alto volume

Colaboradores

O Google mantém este artigo. Ela foi escrita pelos colaboradores a seguir.
Autor principal:

Thomas Anglaret | Engenheiro de soluções\