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=1331161200
    &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 には、インストール手順とサンプルコードも掲載されています。

次のステップ