
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 ×tamp=1331161200 &key=YOUR_API_KEY
リソース
次の表は、Time Zone API で利用可能なリソースと、返されるデータをまとめたものです。
データリソース | 返されたデータ | 戻り値の形式 |
---|---|---|
タイムゾーン
リクエストと一緒にロケーションやタイムスタンプも入力します。必須パラメータをご覧ください。 |
|
|
Time Zone API の使い方
1 | セットアップする | Google Cloud プロジェクトの設定から始めて、次の設定手順を完了します。 |
2 | タイムゾーンのリクエストを試す | API キーを入手したら、ブラウザから直接 Time Zone API のテストを開始できます。詳しくは、タイムゾーンのリクエストとレスポンス ガイドのタイムゾーンの例をご覧ください。 |
3 | レスポンスの基本事項を理解する | アプリまたはウェブサイトでタイムゾーン データを使用する方法をご確認ください。詳しくは、タイムゾーン レスポンス をご覧ください。 |
5 | タイムゾーン データを独自のアプリに組み込む | タイムゾーン データを使用すると、さまざまな時間ベースのロケールをまたいで、ユーザーのアプリやウェブサイトの質を高めることができます。 |
利用可能なクライアント ライブラリ
次のいずれかのクライアント ライブラリを使用して、任意の言語でこの API を呼び出します。
- Google マップ サービス向け Java クライアント
- Google マップ サービス向け Python クライアント
- Google マップ サービス向け Go クライアント
- Google マップ サービス向け Node.js クライアント
Google マップ サービス向け Java クライアント、Python クライアント、Go クライアント、Node.js クライアントは、コミュニティがサポートするクライアント ライブラリであり、Apache 2.0 ライセンスの下でオープンソース化されています。GitHub からインストールしてください。GitHub にはインストール手順とサンプルコードも掲載されています。
次のステップ
- タイムゾーンのリクエスト方法を確認する: タイムゾーンのリクエストとレスポンスをご覧ください。
- ベスト プラクティスを実践する: ウェブサービスのベスト プラクティスをご覧ください。