Em um artigo anterior, vimos como geocodificar endereços completos com o plugin MMQGIS. Hoje, vamos mais além com dois casos de uso muito práticos, sempre sem codificar:
- geocodificar nomes de locais (municípios, países, locais),
- efetuar uma geocodificação reversa: encontrar um endereço aproximado a partir de coordenadas GPS.
1. Geocodificar locais a partir de seus nomes
Caso de uso
Você tem uma lista de municípios, países ou locais conhecidos, mas sem endereços precisos. Você deseja localizar essas entidades em um mapa.
Exemplo de CSV:
id,lieu
1,Port Mathurin, Rodrigues, Maurice
2,Quatre Bornes, Maurice
3,Paris, France
4,Antananarivo, Madagascar
Etapas:
- Menu QGIS: MMQGIS → Geocode → Geocode CSV with Web Service.
- Na caixa de diálogo:
- Arquivo CSV: sua tabela com os nomes dos locais.
- Coluna de endereços: selecione a coluna que contém os locais.
- Serviço web: OpenStreetMap / Nominatim.
- Escolha um arquivo de saída.
Inicie a geocodificação. Cada local será convertido em coordenadas geográficas.
Dica: Qualidade da geocodificação
O Nominatim tenta interpretar o texto fornecido. Quanto mais explícita for a sua sequência, melhor será o resultado.
Exemplos:
| Ruim | Melhor |
|---|---|
| Rodrigues | Port Mathurin, Rodrigues, Maurice |
| Quatre Bornes | Quatre Bornes, Plaines Wilhems, Maurice |
| Reunion | Saint-Denis, La Réunion, France |
2.Geocodificação reversa (endereço a partir de coordenadas)
Caso de uso
Você tem coordenadas GPS (por exemplo: levantamentos de terreno, fotos geolocalizadas) e deseja saber o endereço correspondente.
Exemplo de CSV:
id,latitude,longitude
1,-19.7061,63.4209
2,-20.2473,57.4906
3,-21.1151,55.5325
Etapas:
1- Carregue o arquivo csv como camada com Camada->Adicionar camada->Adicionar camada de texto delimitado…
2- Menu QGIS: MMQGIS → Geocodificar → Geocodificar CSV com serviço web.
Na caixa de diálogo:
- Indique o arquivo CSV.
- Escolha Nominatim como serviço.
- Escolha um arquivo de saída.
O plugin retorna uma descrição do endereço para cada ponto.

Boas práticas
- Para obter melhores resultados, verifique se as coordenadas estão em EPSG:4326 (latitude/longitude em graus).
- A geocodificação reversa fornece um endereço aproximado: rua, localidade ou nome do local, de acordo com os dados disponíveis.
- Evite processamentos em massa com o Nominatim (respeite os limites de uso público).
O que fazer a seguir?
Os dados obtidos podem então ser:
- anexados a camadas vetoriais,
- usados para filtrar, agrupar ou mapear seus dados de campo,
- integrados em um atlas QGIS ou relatório.
Problemas frequentes com o MMQGIS Geocode
Erro 429 – Too Many Requests
O servidor de geocodificação recusa temporariamente as requisições (veja a explicação acima).
Nenhum endereço encontrado
Isso pode estar relacionado ao formato do endereço ou à falta de precisão.
Endereços mal posicionados no mapa
O geocodificador às vezes retorna o centro de uma rua ou de um município.
⚠️ Erro 429: “Too many requests”
Ao utilizar as ferramentas Geocode ou Reverse Geocode do MMQGIS, pode aparecer a seguinte mensagem:
“Failure connecting to API : HTTP Error 429: too many requests”
Esse erro significa que o serviço de geocodificação recusa temporariamente as requisições porque está recebendo muitas em um curto período de tempo.
O MMQGIS utiliza o serviço Nominatim do OpenStreetMap, que é um serviço público. Para proteger os servidores, esse serviço impõe limites rigorosos de utilização.
O erro pode aparecer se:
- você geocodificar um grande número de endereços ou pontos;
- as requisições forem enviadas muito rapidamente;
- vários usuários utilizarem o serviço a partir do mesmo endereço IP.
Como evitar esse problema?
Algumas soluções possíveis:
- processar os dados em pequenos lotes (por exemplo, 100 a 200 endereços);
- aguardar alguns minutos antes de executar novamente o processo;
- utilizar outro serviço de geocodificação;
- para grandes volumes de dados, instalar um servidor Nominatim local ou utilizar um serviço profissional.
Os servidores públicos do Nominatim destinam-se a consultas ocasionais ou testes, e não à geocodificação em grande escala.
Continua…
No próximo artigo veremos como utilizar o MMQGIS para realizar junções espaciais simples, como associar automaticamente pontos ao município ou à zona administrativa onde se encontram.
Se você utiliza frequentemente o geocodificação no QGIS, provavelmente encontrará o erro HTTP 429 (Too Many Requests). Explicamos acima por que ele ocorre e como evitá-lo.






