使ってみる

Time Zone API は、地表の場所の時間オフセット データを提供します。特定の緯度と経度のペアと日付のタイムゾーン情報をリクエストします。API は、そのタイムゾーンの名前、UTC からの時間オフセット、夏時間のオフセットを返します。

リクエストとレスポンスの例

Time Zone API には HTTPS インターフェースを介してアクセスします。リクエストは URL 文字列として作成し、緯度と経度の座標を使用して location を指定し、timestamp を使用して日付を指定します。また、API キーも指定します。

次のクエリは、米国ネバダ州のタイムゾーン リクエストを実行します。タイムスタンプは 2012 年 3 月 8 日に設定されています。

URL

https://maps.googleapis.com/maps/api/timezone/json
  ?location=39.6034810%2C-119.6822510
  &timestamp=1733428634
  &key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1733428634&key=YOUR_API_KEY'

このリクエストをテストするには、ウェブブラウザに URL を入力します。YOUR_API_KEY は、実際の API キーに置き換えてください。レスポンスには、指定された場所と日付（timestamp）のタイムゾーン データが含まれます。

リクエスト URL の作成と使用可能なパラメータ、レスポンスの理解の詳細については、デベロッパー ガイドをご覧ください。

次のサンプルは、JSON 形式のレスポンスを示しています。

JSON

{
  "dstOffset": 0,
  "rawOffset": -28800,
  "status": "OK",
  "timeZoneId": "America/Los_Angeles",
  "timeZoneName": "Pacific Standard Time",
}

XML

<TimeZoneResponse>
 <status>OK</status>
 <raw_offset>-28800.0000000</raw_offset>
 <dst_offset>0.0000000</dst_offset>
 <time_zone_id>America/Los_Angeles</time_zone_id>
 <time_zone_name>Pacific Standard Time</time_zone_name>
</TimeZoneResponse>

クライアント ライブラリを使用してコーディングを開始する

クライアント ライブラリは、認証、リクエスト スロットリング、自動再試行などの一般的なタスクの組み込み実装を直接提供することで、Google マップ ウェブサービス API を使用した開発を簡素化します。Time Zone API は、Google マップサービス向け Java クライアント、Python クライアント、Go クライアント、Node.js クライアントで利用できます。

認証、割り当て、料金、ポリシー

認証

Time Zone API を使用するには、まず API を有効にして、適切な認証情報を取得する必要があります。詳しくは、Google Maps Platform を使ってみるをご覧ください。

割り当てと料金

Time Zone API に設定されている割り当てと料金の詳細については、使用量と請求額をご覧ください。

ポリシー

Time Zone API を使用する際は、API ポリシーを遵守する必要があります。

詳細

Time Zone API では、言語パラメータを設定して、デフォルトの英語以外の言語で結果を返すこともできます。その他の例や詳細については、Time Zone API デベロッパー ガイドをご覧ください。

Time Zone API デベロッパー ガイドは、ウェブサイトやモバイルアプリのデベロッパーが、Google Maps Platform API の 1 つによって提供される地図に時間データを含める際に役立ちます。API の使用方法の概要と、使用可能なパラメータに関するリファレンス資料が記載されています。