My Geocode

API определения часового пояса

Отправьте координату и получите название часового пояса IANA, текущее смещение от UTC, признак действия летнего времени и местное время. Отправьте также метку времени и получите смещение, которое действовало или будет действовать в этот момент: именно это нужно для планирования и для исторических записей.

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

Попробовать в демо Полный справочник

Пример

Запрос
$ 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"

Сохраняйте название timezone, а не смещение. Во многих местах смещение меняется дважды в год, а иногда и навсегда, когда правительство меняет правила. Название IANA остаётся действительным, а правила обновляются у нас в течение суток после каждого выпуска IANA.

Ответ
{
  "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"
}

Что вы получаете

ПолеЗначение
timezoneНазвание IANA, например Europe/Berlin. В международных водах морской пояс, например Etc/GMT-3.
abbreviationАббревиатура, действующая на момент метки времени: CET, CEST, JST. Не уникальна в мире; только для отображения.
utc_offset, utc_offset_secondsСмещение на момент метки времени, в виде текста и числа.
dstДействует ли летнее время на момент метки времени.
timestamp, local_timeМомент, который описывает ответ, в секундах Unix и в виде строки RFC 3339 в местном времени.
country_codeСтрана, в которой находится точка, если есть.

Где это используется

Планирование для нескольких площадок

Отправляйте напоминание в 9:00 утра по местному времени в каждом магазине. Определите часовой пояс один раз для каждого магазина и выполняйте преобразование с помощью библиотеки tz вашего языка.

Исправление меток времени в журналах

Данные устройств, которые записывают местное время без смещения, можно исправить задним числом, определив смещение для этой метки времени и места.

Показ местного времени пользователям

Показывайте «там сейчас 8:34:00 утра» рядом с местом на карте или в карточке контакта.

Цена и лимиты

Один вызов, один запрос. У каждого ключа есть 2 500 бесплатных запросов в день; сверх этого 0,0001 € за запрос с предоплаченного баланса или бесплатно на ключе Unlimited (50 € в месяц). Цены. Форматы Google Time Zone API и Bing Time Zone доступны как совместимые хосты.