Neste artigo
Aprenda a automatizar a busca de informações de endereço no Google Sheets utilizando um script que preenche automaticamente campos como logradouro, bairro, cidade e estado a partir de CEPs. Este tutorial inclui dicas para validação de CEP, formatação de células e integração com outras funções, permitindo gerenciar dados de endereço de forma prática e eficiente.
Se você já se perguntou como buscar CEPs no Google Sheets, você está no lugar certo! Neste artigo, vamos explorar um método simples e eficaz para realizar essa busca utilizando scripts. Imagine poder preencher automaticamente os endereços em suas planilhas, economizando tempo e evitando erros. Vamos lá!
Introdução ao Google Sheets e CEPs
O Google Sheets é uma ferramenta poderosa e versátil que permite a criação e edição de planilhas online, facilitando a colaboração em tempo real.
Uma das funcionalidades mais úteis do Google Sheets é a capacidade de integrar dados externos, como informações de endereços, utilizando CEPs (Códigos de Endereçamento Postal).
Os CEPs são essenciais para identificar localidades no Brasil e podem ser utilizados em diversas aplicações, desde o preenchimento automático de formulários até a análise de dados geográficos.
Ao buscar informações relacionadas a um CEP, como logradouro, bairro, cidade e estado, você pode otimizar suas planilhas e aumentar a eficiência do seu trabalho.
Neste tutorial, vamos ensinar como você pode utilizar um script no Google Sheets para realizar buscas por CEPs.
Com isso, você poderá automatizar o preenchimento de endereços em suas planilhas, economizando tempo e evitando erros manuais.
Vamos explorar o passo a passo para implementar essa solução de forma simples e eficaz!
Criando um Script para Busca de CEP
Para começar a criar um script para busca de CEP no Google Sheets, você precisará acessar a ferramenta de Apps Script, que permite adicionar funcionalidades personalizadas às suas planilhas. Siga os passos abaixo:
Acesse sua planilha: Abra o Google Sheets e selecione a planilha onde você deseja implementar a busca de CEP.
Abra o Apps Script: No menu superior, clique em Extensões e depois em Apps Script. Isso abrirá uma nova aba onde você pode escrever seu código.
Escreva o código: Apague qualquer código padrão que apareça na tela e cole o seguinte código:
function onEdit() {
var guiaAtiva = SpreadsheetApp.getActive().getSheetName();
if (guiaAtiva == "Página1") {
var guiaMenu = SpreadsheetApp.getActive().getSheetByName("Página1");
var linha = guiaMenu.getActiveCell().getRow();
var coluna = guiaMenu.getActiveCell().getColumn();
if (linha > 3 && coluna == 2) {
pesquisaCEP();
}
}
}
function pesquisaCEP() {
var planilha = SpreadsheetApp.getActiveSpreadsheet();
var guia = planilha.getSheetByName("Página1");
var linha = guia.getActiveCell().getRow();
var cep = guia.getRange(linha, 2).getValue();
if (cep == "") {
guia.getRange(linha, 3, 1, 5).clearContent();
return false;
}
cep = cep.replace(/D/g, "");
var validacep = /^[0-9]{8}$/;
if (cep != "") {
if (validacep.test(cep)) {
var url = "http://viacep.com.br/ws/" + cep + "/json/";
var retorno = UrlFetchApp.fetch(url);
var json = retorno.getContentText();
var dados = JSON.parse(json);
if (dados.logradouro != null) {
guia.getRange(linha, 3).setValue(dados.logradouro);
guia.getRange(linha, 4).setValue(dados.complemento);
guia.getRange(linha, 5).setValue(dados.bairro);
guia.getRange(linha, 6).setValue(dados.localidade);
guia.getRange(linha, 7).setValue(dados.uf);
} else {
Browser.msgBox("CEP não encontrado!");
}
} else {
Browser.msgBox("CEP inválido!");
}
}
}
Esse código funciona da seguinte maneira: sempre que você editar a coluna do CEP na Página1, o script automaticamente fará uma busca no ViaCEP e preencherá os campos correspondentes na mesma linha com os dados do endereço.
Importante: Certifique-se de que a coluna onde você irá digitar os CEPs seja a segunda coluna (coluna B) e que as colunas seguintes (C, D, E, F e G) estejam disponíveis para receber os dados do endereço.
Após colar o código, clique no ícone de disquete para salvar o script. Agora você está pronto para usar o script e buscar CEPs diretamente na sua planilha!
Passo a Passo: Como Implementar o Script
Agora que você já tem o script pronto, vamos ao passo a passo para implementar o script de busca de CEP no Google Sheets. Siga as instruções abaixo para garantir que tudo funcione corretamente:
- Salve o script: Após colar o código no Apps Script, clique no ícone de disquete ou vá em Arquivo e depois em Salvar. Dê um nome ao seu projeto, como “Busca de CEP”.
- Volte para a sua planilha: Após salvar o script, feche a aba do Apps Script e volte para a planilha onde você deseja utilizar a busca de CEP.
- Configure a planilha: Na Página1, crie as seguintes colunas:
- Coluna A: CEP
- Coluna B: Logradouro
- Coluna C: Complemento
- Coluna D: Bairro
- Coluna E: Cidade
- Coluna F: Estado
- Insira um CEP: Na coluna A, digite um CEP válido (ex: 01001-000). Certifique-se de que o CEP está no formato correto, incluindo o hífen, se necessário.
- Verifique a execução do script: Após digitar o CEP, pressione Enter. O script será acionado automaticamente e, se tudo estiver correto, as colunas B a F serão preenchidas com as informações correspondentes ao CEP que você inseriu.
- Testes adicionais: Experimente inserir diferentes CEPs para garantir que o script funcione com diversos endereços. Se algum CEP não for encontrado, uma mensagem de alerta aparecerá informando que o CEP não foi localizado.
Dicas:
- Certifique-se de que a conexão com a internet está ativa, pois o script faz uma chamada a um serviço externo para buscar as informações do CEP.
- Se você encontrar algum erro, volte ao Apps Script e verifique se o código está correto e se não há erros de sintaxe.
Com esses passos, você terá implementado com sucesso um script que busca CEPs automaticamente no Google Sheets, facilitando o gerenciamento de dados de endereço em suas planilhas!
Dicas Adicionais para Uso Eficiente
Para garantir que você aproveite ao máximo o seu script de busca de CEP no Google Sheets, aqui estão algumas dicas adicionais para uso eficiente:
Validação de CEP: Antes de executar a busca, considere adicionar uma validação de entrada para garantir que o CEP digitado esteja no formato correto. Isso pode evitar erros e melhorar a experiência do usuário.
Formatação de Células: Utilize formatação condicional nas células onde os dados do endereço são preenchidos. Por exemplo, você pode colorir as células que contêm um CEP inválido para facilitar a identificação de erros.
Atualização do Script: Fique atento a possíveis atualizações no serviço de busca de CEP que você está utilizando (como o ViaCEP). Se houver mudanças na API ou na forma como os dados são retornados, você pode precisar ajustar o seu script.
Uso de Funções Adicionais: Explore a possibilidade de integrar outras funções do Google Sheets, como PROCV ou FILTER, para complementar os dados obtidos e criar análises mais robustas.
Documentação do Código: Comente seu código no Apps Script para que você ou outras pessoas possam entender facilmente o que cada parte do script faz. Isso é especialmente útil se você planeja revisitar o projeto no futuro.
Backups Regulares: Sempre faça backups regulares de suas planilhas e scripts. Isso é importante para evitar perda de dados em caso de erros ou alterações indesejadas.
Teste com Vários CEPs: Teste o script com uma variedade de CEPs, incluindo CEPs válidos, inválidos e inexistentes, para garantir que o script funcione corretamente em diferentes situações.
Seguindo essas dicas, você poderá utilizar seu script de busca de CEP de maneira mais eficiente e produtiva, otimizando seu trabalho no Google Sheets!
Conclusão
Neste tutorial, você aprendeu como implementar um script para realizar buscas de CEP no Google Sheets, o que pode transformar a maneira como você gerencia dados de endereço.
Com as informações obtidas através do script, você pode automatizar o preenchimento de campos em suas planilhas, economizando tempo e reduzindo a possibilidade de erros.
Além disso, ao seguir as dicas adicionais para uso eficiente, você pode aprimorar ainda mais a funcionalidade do seu script, garantindo que ele atenda às suas necessidades de forma eficaz.
Não hesite em explorar novas possibilidades e adaptar o código para outras aplicações que possam beneficiar seu trabalho.
Agora é sua vez! Experimente o que aprendeu e comece a otimizar suas planilhas com a busca de CEP.
Se você tiver dúvidas ou sugestões, sinta-se à vontade para deixar um comentário. Boa sorte e até a próxima!
FAQ – Perguntas Frequentes sobre Busca de CEP no Google Sheets
O que é um script no Google Sheets?
Um script no Google Sheets é um código que permite automatizar tarefas e adicionar funcionalidades personalizadas às suas planilhas, utilizando a linguagem de programação Apps Script.
Como posso validar o CEP digitado antes de buscar?
Você pode adicionar uma função de validação no script que verifica se o CEP está no formato correto (8 dígitos) antes de realizar a busca.
O que fazer se o CEP não for encontrado?
Se o CEP não for encontrado, uma mensagem de alerta aparecerá informando que o CEP não foi localizado. Você pode personalizar essa mensagem no script.
Posso usar o script em outras planilhas?
Sim, você pode copiar o script e colá-lo em outras planilhas do Google Sheets. Certifique-se de ajustar as referências de coluna e nome da aba conforme necessário.
É possível integrar outras funcionalidades ao script?
Sim, você pode integrar outras funções do Google Sheets, como PROCV ou FILTER, para complementar os dados obtidos e criar análises mais complexas.
Como faço para fazer backup do meu script?
Para fazer backup do seu script, você pode copiar o código do Apps Script e colá-lo em um editor de texto ou em um documento separado, assim você terá uma cópia segura.
