Recurso - Geolocalização
Introdução
Geolocalização é a tecnologia que permite identificar a localização geográfica de um dispositivo. Ela pode ser baseada em diferentes métodos, como endereço IP, redes Wi-Fi, torres de celular e sensores GPS. Esse serviço é amplamente usado em aplicativos de mapas, transporte, segurança, publicidade direcionada e análise de dados. A precisão da geolocalização pode variar de uma estimativa aproximada a uma localização exata.
Também habilitamos a coleta de geolocalização por meio da API do Google (contratada com um provedor) para fornecer uma geolocalização mais precisa.
Coleção de geolocalização padrão (instalada com agentes)
A geolocalização instalada com os agentes é um serviço que fornece informações com base no endereço IP do usuário. Ele usa um banco de dados de endereços IP para estimar a localização do usuário, mas não oferece precisão exata, pois depende do provedor de serviços de Internet (ISP) e da infraestrutura de rede.
Como funciona:
A partir da versão 4.3.10 do Desktop Agent (somente Microsoft Windows), o processo de coleta de geolocalização foi alterado e agora é executado da seguinte forma:
- Tentativas de coletar a localização do Windows
Se conseguir recuperar a localização, ele faz uma chamada para ip-api apenas para coletar informações como cidade, região e país e, em seguida, encerra o processo. - Tentativas de coletar o local usando a API de geolocalização do Google:
se uma chave estiver registrada e a tentativa anterior não tiver retornado um resultado válido. Se não for possível coletar redes WiFi, ou se a localização do Windows estiver desativada, ou se houver muito poucas redes disponíveis, a API do Google retornará a localização com base no endereço IP. - Se nenhum token de geolocalização do Google estiver registrado no agent:
A localização é coletada usando ip-api.(https://ip-api.com/). Com base no endereço IP do usuário. Ele usa um banco de dados de endereços IP para estimar a localização do usuário, mas não fornece precisão exata, pois depende do provedor de serviços de Internet (ISP) e da infraestrutura de rede.
DICA
Para coletar a localização usando os serviços de localização do Windows, a configuração "Settings -> Privacy & security -> Location -> Location services" deve estar ativada. Caso contrário, não será possível recuperar essas informações.

OBSERVAÇÃO: Se as opções estiverem bloqueadas e não houver um token de geolocalização do Google, os dados de geolocalização e histórico no registro da máquina não estarão presentes.
As versões anteriores ao Desktop Agent 4.3.10 (Microsoft Windows) não incluem a etapa 1 (coleta de geolocalização do Microsoft Windows).
Coleta de geolocalização via API do Google
A API de geolocalização do Google usa GPS, redes Wi-Fi e torres de celular para obter uma localização muito mais precisa do que apenas a geolocalização baseada em IP. Ela pode ser usada para rastrear dispositivos móveis e fornecer informações em tempo real.
Esse método deve ser contratado separadamente (consulte a seção "Geolocalização".) e o token deve ser inserido nas configurações avançadas ao fazer o download do agent.
Como funciona?
- O usuário faz uma solicitação HTTP para a API de geolocalização do Google:
https://www.googleapis.com/geolocation/v1/geolocate?key=API_KEY
- A solicitação pode incluir redes Wi-Fi próximas, torres de celular e o IP do dispositivo.
- O Google retorna uma resposta com latitude, longitude e um raio de precisão (em metros).
Vantagens
- Maior precisão (pode chegar a alguns metros).
- Funciona com redes Wi-Fi, torres de celular e sensores de dispositivos.
Comparação resumida
Recurso | Geolocalização padrão | API de geolocalização do Google |
Banco de dados | com base nas informações do Microsoft WIndows | GPS, Wi-Fi, torres de celular |
Precisão | Média (com base no sistema operacional) | Alta (pode ser exata com GPS) |
Requer chave de API? | Não | Sim |
Custo | Gratuito (permitir no sistema operacional) | Pago após o limite gratuito |
Se você precisar de uma localização aproximada (cidade/estado), a IP-API é uma boa opção gratuita. No entanto, se você precisar de uma localização exata (metros de precisão), a API do Google é a melhor opção.