HG GeoIP

Obtenha a localização através do endereço de IP de seu usuário.
Veja como é fácil implementar, comece agora!

Sua aplicação fica muito mais completa com nossas APIs

A HG Brasil sempre prezou pela qualidade das APIs, neste ano de 2019, comemoramos 10 anos no ar!

Nossas APIs foram feitas de desenvolvedor para desenvolvedor, documentações completas e objetivas, sem enrolação.
Em poucos minutos e com uma única chave de acesso, você tem acesso à todos os nossos dados na sua aplicação.

Seja o dólar, uma ação, o bitcoin, um índice, como está o tempo, como vai estar o tempo, a geolocalização por IP e muito mais...
Comece agora! Os principais dados possuem acesso gratuito!

Documentação completa Bibliotecas Criar chave gratuita
Status
  • Operando normamente
    Aplicação API: OK
    Website: OK
    HG Console: OK
    Rotinas: OK
    Fontes de dados: OK
  • Latência: 31.32 ms
Planos e Preços Obter suporte

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.

Introdução

Obter a localição de seu usuário é muito importante para entender seu público.

O HG GeoIP é uma API que fornece dados dados de geolocalização através do endereço de IP de seu usuário.
API fácil de implementar, com respostas e parâmetros objetivos, com bibliotecas em PHP, Ruby e JavaScript. (em breve)

Mesmo que sua aplicação não seja com essas linguagens, abaixo você pode conferir como integrar a API.
Todos esses dados referentes ao IP são retornados na mesma requisição de uma só vez, sendo esses dados:

Em uma só requisição, você pode obter:
- cidade, estado e país;
- maiores informações sobre o país como imagens da bandeira, capital e DDI*;
- latitude e longitude da cidade encontrada;
- código WOEID para que seja simples uma consulta posterior de previsão do tempo usando o HG Weather.

Tudo isso em uma só requisição.

Essa API requer o uso de uma chave para funcionar, o limite de consultas é compartilhado com as requisições do HG Weather.
O modo de alta precisão traz dados mais apurados e requer a contratação de um plano da API, conheça nossos planos clicando aqui.

* Alguma dessas informações podem estar disponíveis apenas no modo de alta precisão.

Criar nova chave

Todas as requisições em como base o seguinte endpoint:

Estrutura de dados

Os dados referentes à consulta chegam no parâmetro results, você também pode conferir a autenticação de sua chave no parâmetro de retorno valid_key e verificar no by se a consulta foi feita pelo modo de address_precision (consulta de alta precisão) ou address_standard (consulta normal).

  • 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

Você pode personalizar o resultado da consulta omitindo alguns dados veja como.

Exemplo de resposta JSON
{"by":"address_standard","valid_key":true,"results":{"address":"66.249.83.93","type":"ipv4","city":"Pocomoke City","region":"Maryland","country_name":"United States","continent":"América do Norte","continent_code":"NA","region_code":"MD","country":{"name":"United States","code":"US","capital":null,"flag":{"svg":"https://assets.hgbrasil.com/geoip/flags/svg/us.svg","png_16":"https://assets.hgbrasil.com/geoip/flags/16/us.png"},"calling_code":null},"latitude":38.0714,"longitude":-75.555,"woeid":null},"execution_time":0.02,"from_cache":false}

 

Veja nossa documentação completa!

Nossa documentação é simples e intuitiva, veja como é simples integrar sua aplicação às APIs HG Brasil!
Clara, simples e objetiva, feita de desenvolvedor para desenvolvedor.

Ver documentação

Exoneração de responsabilidade

API para fins informativos. 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. Trabalhamos pela estabilidade e precisão dos dados, porém, os dados podem estar atrasados ou errados "no estado em que se encontram", confirme todos os dados antes de efetuar qualquer ação que possa ser afetada por estes valores, assim como demais endpoints da API.

Qualquer dúvida verifique nossos termos de uso ou entre em contato.