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 ×tamp=1733428634 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=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 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 のいずれかで提供される地図に時間データを含めたいウェブサイトやモバイルアプリのデベロッパーを対象としています。API の使用方法の概要と、使用可能なパラメータに関するリファレンス資料を提供します。