My Geocode

API de consulta de fuso horário

Envie uma coordenada e receba o nome IANA do fuso horário, o deslocamento UTC atual, se o horário de verão está em vigor e a hora local. Envie também um timestamp e receba o deslocamento que valia, ou que valerá, naquele momento, que é o que você precisa para agendamentos e registros históricos.

GEThttps://api.mygeocode.com/v1/timezone?lat=...&lon=...

Experimente na demonstração Referência completa

Exemplo

Requisição
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/timezone?lat=35.6762&lon=139.6503"

# At a specific moment (Unix seconds)
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/timezone?lat=40.7128&lon=-74.0060&timestamp=1773817200"

Guarde o nome do timezone, não o deslocamento. Os deslocamentos mudam duas vezes por ano em muitos lugares e, às vezes, de forma permanente quando um governo muda as regras. O nome IANA continua válido, e as regras são atualizadas aqui em até um dia após cada versão da IANA.

Resposta
{
  "status": "ok",
  "lat": 35.6762,
  "lon": 139.6503,
  "timezone": "Asia/Tokyo",
  "abbreviation": "JST",
  "utc_offset": "+09:00",
  "utc_offset_seconds": 32400,
  "dst": false,
  "timestamp": 1756335245,
  "local_time": "2026-08-28T08:34:05+09:00",
  "country_code": "JP"
}

O que você recebe

CampoSignificado
timezoneNome IANA como Europe/Berlin. Em águas internacionais, uma zona náutica como Etc/GMT-3.
abbreviationA abreviação em vigor no timestamp: CET, CEST, JST. Não é única no mundo; use apenas para exibição.
utc_offset, utc_offset_secondsO deslocamento no timestamp, como texto e como número.
dstSe o horário de verão está em vigor no timestamp.
timestamp, local_timeO momento que a resposta descreve, em segundos Unix e como string RFC 3339 na hora local.
country_codeO país em que o ponto está, se houver.

Onde é usada

Agendamento entre unidades

Envie um lembrete às 9 da manhã, no horário local de cada loja. Consulte o fuso horário uma vez por loja e converta com a biblioteca de fusos horários da sua linguagem.

Corrigir timestamps em logs

Dispositivos que registram a hora local sem deslocamento podem ser corrigidos depois, consultando o deslocamento naquele timestamp e local.

Mostrar a hora local aos usuários

Exiba "lá são 8:34 da manhã" ao lado de um local em um mapa ou de um cartão de contato.

Preço e limites

Uma chamada, uma requisição. Toda chave tem 2.500 requisições gratuitas por dia; acima disso, € 0,0001 cada uma a partir do crédito pré-pago, ou nada em uma chave Unlimited (€ 50 por mês). Preços. Os formatos da Google Time Zone API e do Bing Time Zone estão disponíveis como hosts compatíveis (drop-in).