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

次のステップ