Geolocalização de IP

País, região, cidade, fuso horário e coordenadas aproximadas de um endereço IP.

Adicione a localização da rede a uma requisição.

Use location.country_code como sugestão de país e location.timezone para exibição. Permita que os visitantes corrijam a sugestão e mantenha os campos de localização vazios como desconhecidos, sem inventar uma cidade ou coordenadas.

1.1.1.1Relatório completo do IP

Brisbane, Australia

-27.475°, 153.010°

Localização aproximada da rede; não é a posição de um dispositivoDados cartográficos do Natural Earth

Cidade: Brisbane
Região: Queensland
País: Australia
Fuso horário: Australia/Brisbane

A localização de um IP é uma estimativa no nível da rede. Não é uma leitura de GPS, um endereço residencial nem uma prova da localização física de um visitante.

Campos da API

Definição do campoExemplo de 1.1.1.1

location.countryTipo: string: Nome do país associado à localização estimada da rede.; Valor de exemplo"Australia"
location.country_codeTipo: string: Código de país de duas letras no registro de localização.; Valor de exemplo"AU"
location.cityTipo: string: Cidade associada à localização estimada da rede. Pode estar vazia.; Valor de exemplo"Brisbane"
location.stateTipo: string: Região ou estado associado à estimativa. Pode estar vazio.; Valor de exemplo"Queensland"
location.zipcodeTipo: string: Código postal quando fornecido pela fonte. Pode estar vazio.; Valor de exemplo""
location.latitudeTipo: number: Latitude aproximada da localização da rede.; Valor de exemplo-27.474848400186662
location.longitudeTipo: number: Longitude aproximada da localização da rede.; Valor de exemplo153.00996200912815
location.timezoneTipo: string: Identificador de fuso horário associado à localização.; Valor de exemplo"Australia/Brisbane"

Consulte um endereço

Requisição

curl --fail --silent --show-error --max-time 5 \
  "https://api.ipquery.io/1.1.1.1?format=json"

Campos reais da resposta

JSON

{
  "ip": "1.1.1.1",
  "location": {
    "country": "Australia",
    "country_code": "AU",
    "city": "Brisbane",
    "state": "Queensland",
    "zipcode": "",
    "latitude": -27.474848400186662,
    "longitude": 153.00996200912815,
    "timezone": "Australia/Brisbane",
    "localtime": "2026-11-03T14:32:36"
  }
}

O trecho mostra os campos relevantes desta resposta a uma consulta de um único IP. Examinar o relatório completo do IP

Para consultar o endereço do próprio cliente que estabelece a conexão, use https://api.ipquery.io/?format=json. As consultas em lote estão desativadas.

Referência da API

Correspondência e procedência

O MMDB Enterprise correspondente alimenta as consultas da API; o CSV alimenta os dados agregados de países e cidades.

Explorar países Metodologia completa