タイムゾーン検索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名を保存してください。多くの地域でオフセットは年に2回変わり、政府がルールを変更すると恒久的に変わることもあります。IANA名は有効なままで、ルールはIANAの各リリースから1日以内にこちらでも更新されます。

レスポンス

{
  "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`	`Europe/Berlin`のようなIANA名です。公海上では`Etc/GMT-3`のような海上タイムゾーンになります。
`abbreviation`	そのタイムスタンプ時点で有効な略称です：`CET`、`CEST`、`JST`。世界中で一意ではないため、表示専用です。
`utc_offset`, `utc_offset_seconds`	そのタイムスタンプ時点のオフセットを、テキストと数値で表したものです。
`dst`	そのタイムスタンプ時点で夏時間が適用されているかどうかです。
`timestamp`, `local_time`	回答が表す時点を、Unix秒と現地時刻のRFC 3339文字列で表したものです。
`country_code`	その地点が属する国（存在する場合）です。

利用シーン

複数拠点にまたがるスケジューリング

各店舗で現地時刻の午前9時にリマインダーを送ります。タイムゾーンは店舗ごとに1回だけ検索し、お使いの言語のtzライブラリで変換してください。

ログのタイムスタンプを修正する

オフセットなしで現地時刻を記録するデバイスは、そのタイムスタンプと場所におけるオフセットを検索することで、後から補正できます。

ユーザーに現地時刻を表示する

地図上の場所や連絡先カードの横に「現地は午前8:34時です」と表示します。

料金と制限

1回の呼び出しは1リクエストです。どのキーにも1日あたり2,500件の無料リクエストがあり、それを超えるとプリペイドクレジットから1件あたり€0.0001、Unlimitedキー（月額€50）なら追加料金はかかりません。料金。Google Time Zone APIとBing Time Zoneの形式は互換ホストとして利用できます。