Google Geocoding no QGIS: Passo a Passo para Configurar sua API Key e Automatizar Processos

O QGIS é uma das ferramentas mais poderosas e acessíveis para geoprocessamento, permitindo que usuários e desenvolvedores integrem diversos serviços online para ampliar suas funcionalidades. Entre esses serviços, o Google Geocoding API se destaca por possibilitar a conversão de endereços em coordenadas geográficas de forma rápida e precisa.

Neste artigo, você aprenderá como obter sua API Key do Google, ativá-la para uso no QGIS e realizar geocodificação tanto através de plugins quanto via Python. Seja você um usuário que deseja agilizar a localização de endereços ou um desenvolvedor interessado em automatizar processos, este guia fornecerá todas as informações necessárias para integrar o Google Geocoding ao seu fluxo de trabalho no QGIS.

Criar um Projeto no Google Cloud

Para obter uma chave de API do Google e usá-la no QGIS para acessar o Geocoding e outros serviços como o Street View, etc, siga os passos abaixo:

1. Acesse o Google Cloud Console. 
2. Clique em “Comece a usar gratuitamente”.
3. Faça login com sua conta do Google, depois clique em “Concordar e continuar”.
4. Para continuar é necessário cadastrar um cartão de crédito ou deixar um PIX para o Google como garantia. No cartão será descontado um valor de aproximadamente R$ 3,00 para validação, mas depois será estornado.
5. Após o cadastro do cartão, será solicitado o código da compra que aparecerá no extrato do cartão de crédito em até 5 minutos.
6. Finalmente, após a confirmação, clique em “Comece gratuitamente”.
7. Preencha o seguinte formulário sobre o interesse no Google Cloud e depois clique em  “Concluído”.
8. Agora no menu superior, clique em My First Project.
9. Em seguida, vá em pesquisar e procure por Geocoding API.
10. Clique em “ATIVAR” e em seguida a sua chave API será criada! Obs.: Essa chave poderá ser usada nos demais serviços, como o Maps Street View Static API.
11. Importante: Será solicitado para proteger sua chave API (opcional), onde você pode restringir o uso para alguns endereços de IP, por exemplo.

Como Usar a API Key do Google no QGIS

1. Instale o plugin Google Maps Geocoder.  
2. Ao instalar o plugin será solicitado para inserir a chave API, então clique em “Enter API Key”.
3. Agora preencha a chave API e defina a região preferencial para as suas pesquisas Google.
4. Agora o plugin está pronto para uso! Teste usando a planilha de endereços disponibilizado no curso QGIS: Teoria e Prática.
5. E confira os resultados dos endereços geocodificados (texto para pontos no mapa).

⚠️ Atenção: O processamento de um grande volume de endereços ou o uso que exceda a cota gratuita do Google Geocoding pode gerar custos significativos. Para evitar cobranças inesperadas, recomenda-se dividir os dados em blocos menores e monitorar constantemente o consumo da API. Dessa forma, você mantém o controle dos gastos e otimiza o uso do serviço.

Como realizar Geocodificação do Google com Python

Você pode usar a API do Google para converter endereços em coordenadas no terminal Python do QGIS ou em qualquer outro software:

1. No QGIS, abra o Python Console no QGIS (Ctrl + Alt + P).
2. Execute o seguinte código substituindo “SUA_CHAVE_AQUI” pela sua API Key:

import requests

def geocode(address):
    api_key = "SUA_CHAVE_AQUI"
    url = f"https://maps.googleapis.com/maps/api/geocode/json?address={address}&key={api_key}"
    response = requests.get(url)
    data = response.json()
    if data['status'] == 'OK':
        location = data['results'][0]['geometry']['location']
        return location['lat'], location['lng']
    else:
        return None

endereco = "Av. Paulista, São Paulo, Brasil"
coordenadas = geocode(endereco)
print(coordenadas)

Isso retornará a latitude e longitude do endereço pesquisado.

Python para o QGIS

Deseja dominar o Python para Geoprocessamento e Topografia? Inscreva-se no curso mais completo de Python no Brasil:

CURSO COMPLETO DE PYQGIS

E torne-se desenvolvedor de plugins para o QGIS!