:

Obter a localição de seu usuário é muito importante para entender seu público, esses dados podem ser utilizados para campanhas de marketing ou para sistemas antifraude. São muitas as possibilidades.

O HG GeoIP é uma API que fornece dados dados de geolocalização através do endereço de IP de seu usuário.

Clique aqui e saiba mais sobre o HG GeoIP.

Conheça a nova documentação do HG GeoIP


Obter todos os dados

Com este método, os dados são retornados em uma única requisição.

Dados retornados:

address - endereço de IP consultado
type - ipv4 ou ipv6
city - cidade
region - região/estado
country_name - nome do país
continent - continente do IP no idioma selecionado
continent_code - código do continente
region_code - código da região/estado
country - objeto com os dados do país
  name - nome do país
  code - código do país
  capital - capital do país
  flag - objeto com a bandeira do país
    name - nome da moeda
    buy - valor para compra
  calling_code - DDI do país
latitude - latitude da cidade
longitude - longitude da cidade
woeid - código da cidade para consulta no HG Weather

GET https://api.hgbrasil.com/geoip?format=json&key=SUA-CHAVE
visualizar resposta

Parâmetros:

address: (endereço de IP, padrão remote)
- 000.000.000.000 (endereço de IPv4 ou IPv6 para consulta)
- remote (obtem o IP pelo cliente)

precision: (modo de alta precisão, padrão false)
- true (retorna a localização com alta precisão, precisa ser assinante da API para utilizar)
- false

format: (formato de resposta)
- json
- json-cors (liberado para AJAX, requer chave com domínio correto)
- php-serialize
- debug (resposta em JSON indentado, recomenda-se apenas para leitura)

key: (sua chave de API, obrigatório)
- informe sua chave de API HG Brasil, obtenha uma aqui.
Criar nova chave gratuita

Atenção!

Não garantimos a precisão dos dados fornecidos pela API ou contidos nesta página, uma vez que devem ser utilizados apenas para efeitos informativos. Recomendamos que confirme todos os dados antes de efetuar qualquer ação que possa ser afetada por estes valores. Os dados são obtidos de fontes públicas da internet e podem sofrer alterações sem aviso prévio. O IP de origem, assim como a chave de API, são armazenados pelo sistema a fim de monitoramento do consumo de dados. Existem alguns limites no número de consultas, você pode verificar aqui, seu acesso pode ser restringido caso o limite seja atingido, ou se houver riscos à integridade do sistema no caso de sobrecargas oriundas de suas consultas. Entre em contato para consultas em larga escala ou para obter atualizações dos dados mais frequentes. Limites podem ser alterados ou impostos sem aviso prévio.

Confira os termos de uso do sistema para mais informações.