Time Zone API の概要

Time Zone API は、緯度 / 経度座標と指定した日時の HTTP リクエストを受け付けるサービスです。UTC と夏時間のオフセットを含む、その場所のタイムゾーン データが返されます。

Time Zone API を使用する理由

Time Zone API を使用すると、地図上の特定の場所の日付と時刻のタイムゾーン ID と名前を提供するアプリケーションを開発できます。たとえば、次のタイムゾーン データを表示できます。

  • Google Maps Platform から取得した地図上の場所のローカライズされたタイムゾーン名。
  • UTC と夏時間のタイムゾーン オフセット。

タイムゾーン データは、ウェブサイトまたはアプリで、アプリケーションを使用しているユーザーに関連する時間ベースのデータを表示する場合に特に役立ちます。

Time Zone API でできること

Time Zone API を使用すると、地球上の場所のタイムゾーンをリクエストできます。UTC からの時間オフセットと、各場所の夏時間も取得できます。

Time Zone API の仕組み

Time Zone API は、緯度と経度の座標、選択した日時（タイムスタンプ）、言語コード（省略可）を含む HTTPS リクエストを受け付けます。リクエストで指定された形式でデータを返します。次の例は、米国ネバダ州のリクエストで、JSON 形式の出力をリクエストしています。

https://maps.googleapis.com/maps/api/timezone/json
  ?location=39.6034810%2C-119.6822510
  &timestamp=1733428634
  &key=YOUR_API_KEY

リソース

次の表に、Time Zone API で利用可能なリソースと、それらが返すデータの概要を示します。

データリソース 返されたデータ 返品の形式
タイムゾーン

リクエストを位置情報とタイムスタンプとともに提供します。必須パラメータをご覧ください。
  • タイムゾーン ID。
  • タイムゾーン名（ローカライズ可能）。
  • UTC との時差（秒単位）。
  • 夏時間のオフセット（秒単位）。
  • 具体的なレスポンスの例については、タイムゾーンをご覧ください。
  • JSON
  • XML

Time Zone API の使用方法

1 セットアップする Google Cloud プロジェクトを設定するから始めて、以降の設定手順を完了します。
2 タイムゾーン リクエストを試す API キーを取得したら、ブラウザから直接 Time Zone API のテストを開始できます。詳しくは、タイムゾーンのリクエストとレスポンスのガイドのタイムゾーンの例をご覧ください。
3 レスポンスの基本を理解する アプリやウェブサイトでタイムゾーン データを使用する方法について説明します。詳しくは、タイムゾーン の回答をご覧ください。
5 タイムゾーン データを独自のアプリに組み込む タイムゾーン データを使用すると、時間ベースの異なる地域でアプリやウェブサイトを強化できます。

利用可能なクライアント ライブラリ

次のいずれかのクライアント ライブラリを使用して、任意の言語でこの API を呼び出します。

Google マップ サービス向けの Java クライアント、Python クライアント、Go クライアント、Node.js クライアントは、コミュニティがサポートするクライアント ライブラリであり、Apache 2.0 ライセンスの下でオープンソース化されています。これらのライブラリは GitHub からダウンロードできます。インストール手順とサンプルコードも GitHub で確認可能です。

次のステップ