スタートガイド

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=1331161200
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&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 Maps ウェブサービス 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 の使用方法の概要と、使用可能なパラメータに関する参考資料について説明します。