GeoSpy é a mais recente revolução no mundo da análise de imagens por IA — uma ferramenta em Python que utiliza a poderosa API Gemini da Google para revelar com precisão surpreendente o local onde uma fotografia foi tirada. Seja uma imagem antiga esquecida num disco rígido ou uma foto misteriosa encontrada online, esta tecnologia pode desvendar-lhe o mundo inteiro com um simples comando.
Instalação Instantânea com um Comando:
pip install geospyerComo Usar o GeoSpy e Surpreender-se com os Resultados
Basta um único comando para iniciar a magia:
geospyer --image caminho/para/a/sua/imagem.jpgMas há muito mais:
- –image – Caminho obrigatório da imagem ou URL
- –context – Informações adicionais para afinar a análise
- –guess – A sua suposição do local da foto
- –output – Caminho para guardar os resultados em JSON
- –api-key – Chave API personalizada para maior controlo
Exemplos Que Vai Querer Testar Hoje Mesmo
- Uso Básico:
geospyer --image ferias_2023.jpg- Com Contexto Extra:
geospyer --image ferias_2023.jpg --context "Viagem de verão no sul da Europa"- Apostar na Localização:
geospyer --image ferias_2023.jpg --guess "costa do Mediterrâneo"- Guardar os Resultados:
geospyer --image ferias_2023.jpg --output resultado.json- API Key Personalizada:
geospyer --image ferias_2023.jpg --api-key "a-sua-chave-aqui"Configurar a Chave API Nunca Foi Tão Fácil
GeoSpy trabalha com a API Gemini da Google. Pode configurar de três formas:
- Variável de ambiente:
GEMINI_API_KEY=a-sua-chave - Diretamente no código:
GeoSpy(api_key="a-sua-chave") - Através da linha de comandos:
--api-key
Exemplo Real em Python:
from geospyer import GeoSpy
geospy = GeoSpy()
resultado = geospy.locate(image_path="foto.jpg")
if "error" in resultado:
print(f"Erro: {resultado['error']}")
else:
if "locations" in resultado and resultado["locations"]:
local = resultado["locations"][0]
print(f"Localização: {local['city']}, {local['country']}")
if "coordinates" in local:
lat = local["coordinates"]["latitude"]
lng = local["coordinates"]["longitude"]
url = f"https://www.google.com/maps?q={lat},{lng}"
print(f"Ver no Google Maps: {url}")Funcionalidades Que Fazem a Diferença
- Localização de imagens com tecnologia IA baseada na API Gemini da Google
- Ligações diretas ao Google Maps com coordenadas exatas
- Níveis de confiança nas previsões (Alto, Médio, Baixo)
- Suporte para contexto adicional e palpites de localização
- Exportação de resultados em JSON
- Suporte para imagens locais e URLs
Formato de Resposta em JSON para Máxima Clareza
- interpretation: análise detalhada da imagem
- locations: lista de localizações possíveis com:
- País, cidade, estado
- Grau de confiança
- Coordenadas geográficas
- Justificação detalhada
Aviso Legal: Use com Responsabilidade!
GeoSpy é uma ferramenta concebida exclusivamente para fins educativos e de investigação. Apesar do seu poder, os resultados não são garantidamente precisos. É absolutamente proibido utilizar esta tecnologia para fins ilegais, vigilância, perseguição, ou qualquer prática que viole a privacidade.
Os criadores não se responsabilizam por consequências legais ou danos resultantes do uso indevido deste software. O utilizador assume total responsabilidade. Respeite sempre as leis em vigor.
Quer Contribuir para o Futuro da Geolocalização por IA?
- Faça fork do repositório
- Crie uma nova branch
git checkout -b feature/nova-funcionalidade - Submeta as suas alterações
git commit -am 'Adicionar nova funcionalidade' - Envie para o GitHub
git push origin feature/nova-funcionalidade - Abra um pull request e entre na comunidade
Licença Open Source – MIT License
Veja o ficheiro LICENSE para detalhes completos.
Hashtags:
#GeoSpy #InteligênciaArtificial #Python #Geolocalização #GeminiAPI #LocalizaçãoPorImagem #IAemAcção #GoogleMaps #OpenSource #FotoDetective
