API Address Validation no Planilhas Google

Objetivo

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

Como não desenvolvedor, mesmo que você queira trabalhar com dados da Google Maps Platform, como a Address Validation API, talvez você queira encontrar uma maneira de começar a usar o serviço sem muita ajuda de equipes técnicas.

Casos de uso

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

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

Modelo do Google Planilhas

A solução é um Google Planilhas que vem com funções personalizadas do Apps Script que farão solicitações em sequência à API Address Validation.

**Dica**: este exemplo é apenas para orientação de integração. Garanta a qualidade antes de usar com seus aplicativos. O suporte está disponível nos 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. Acesse a planilha de exemplo 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 "Chave de API + painel", substitua a célula B2 pela sua chave de API.
   
4. Copie/cole endereços no modelo (em uma planilha separada para formatar os dados: concatene o número da rua, o nome, a cidade e o CEP)
   
5. Selecione as células das planilhas e, no menu, selecione "Address Validation" > "Seleção da API Address Validation"
   
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 sua 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, já que o Google Planilhas tem um histórico integrado.

Termos da Plataforma Google Maps

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, após os quais o cliente precisa (1) excluir o conteúdo armazenado em cache do Google Maps ou (2) substituir pelos dados do usuário final fornecidos pela 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
  
• Localização: valores de latitude, valores de longitude
  
• verdict
  
• formattedAddress
  
• postalAddress
  
• addressComponent: componentName
  
• Dados do USPS standardizedAddress
  

Considerações

• Performance: processe em blocos de 1.000 linhas de cada vez. O script pode parar, por exemplo, ao exceder a cota de API por segundo. Continue da linha em que o script 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 da API Address Validation.

Conclusão

A API Address Validation no Google Planilhas permite que não desenvolvedores comecem a consultar a API Address Validation e entendam como ela pode ser estratégica para os negócios. Este documento demonstra como qualquer pessoa pode começar a consultar a API criando uma chave de API e usando o modelo do Google Planilhas fornecido.

Próximas ações

Leituras sugeridas:

• Address Validation para finalização de compra de e-commerce
• Biblioteca de Address Validation de alto volume

Colaboradores

O Google mantém este artigo. Os seguintes colaboradores escreveram o artigo originalmente.
Autor principal:

Thomas Anglaret | Engenheiro de soluções