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"
}

返回内容

字段含义
timezoneIANA 名称，例如 Europe/Berlin。在国际水域，则为航海时区，例如 Etc/GMT-3。
abbreviation该时间戳下生效的时区缩写：CET、CEST、JST。在全球范围内并不唯一；仅用于显示。
utc_offset, utc_offset_seconds该时间戳下的偏移，分别以文本和数字表示。
dst该时间戳下是否处于夏令时。
timestamp, local_time结果所描述的时刻，以 Unix 秒数和当地时间的 RFC 3339 字符串表示。
country_code该坐标点所在的国家（如有）。

使用场景

跨地点排程

在每家门店的当地时间上午 9 点发送提醒。每家门店只需查询一次时区，然后用您所用语言的 tz 库进行转换。

修正日志中的时间戳

对于记录当地时间但不带偏移的设备，可以事后根据该时间戳和位置查询当时的偏移来修正。

向用户显示当地时间

在地图上的位置或联系人卡片旁显示“那里现在是上午 8:34 点”。

价格和限制

一次调用计为一个请求。每个密钥每天有 2,500 次免费请求；超出后，每次请求从预付额度中扣除 €0.0001，使用 Unlimited 密钥（每月 €50）则不收费。价格。Google Time Zone API 和 Bing Time Zone 格式都有对应的兼容替换主机。