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 からのオフセット(秒)
  • 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 にはインストール手順とサンプルコードも掲載されています。

次のステップ