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

次のステップ