Time Zone API の概要

Time Zone API は、Google Cloud Storage の 緯度と経度の座標、選択した日時。時刻を返します。 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 リクエストを受け入れます。 必要な日時をタイムスタンプとして指定し、必要に応じて 指定します。リクエストで指定された形式でデータを返します。次の例は、HTTP リクエストに対する 米国ネバダ州でリクエストされた出力が 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 からのオフセット（秒単位）
  • DST のオフセット（秒）
  • 具体的なレスポンスの例については、タイムゾーンをご覧ください。
  • 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 には、インストール手順やサンプルコードも用意されています。

次のステップ