このページは Cloud Translation API によって翻訳されました。

開始する

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

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

HTTPS インターフェースを介して Time Zone API にアクセスします。リクエストは 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 のいずれかによって提供される地図に時間データを含めるウェブサイトデベロッパーとモバイルデベロッパーを対象としています。API の使用方法の概要と、使用可能なパラメータに関するリファレンスマテリアルが記載されています。