指定した場所の過去 1 時間から 24 時間までの 1 時間ごとの過去の気象データを返します。
HTTP リクエスト
GET https://weather.googleapis.com/v1/history/hours:lookup
この URL は gRPC Transcoding 構文を使用します。
クエリ パラメータ
パラメータ | |
---|---|
location |
必須。1 時間ごとの過去のデータを取得する場所。 |
units |
省略可。返される天候の状態に使用する単位システム。指定しない場合、返される天候はメートル法で表示されます(デフォルト = METRIC)。 |
page |
省略可。ページごとに返される 1 時間ごとの過去のレコードの最大数。値は 1 ~ 24 です。デフォルトは最大許容値の 24 です。 |
page |
省略可。前回のリクエストから受け取ったページトークン。後続のページの取得に使用されます。 |
hours |
省略可。前回取得した時間から取得する合計時間を制限します。1 ~ 24 時間(含む)です。デフォルトは最大許容値の 24 です。 |
language |
省略可。クライアントがレスポンスの言語を選択できるようにします。その言語のデータを提供できない場合は、最も近い一致が使用されます。使用できる値は IETF BCP-47 標準に準拠しています。デフォルト値は「en」です。 |
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
hours.lookup RPC のレスポンス。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{ "historyHours": [ { object ( |
フィールド | |
---|---|
history |
リクエストで指定された時間数とページサイズに応じた、1 時間ごとの過去の記録。 |
time |
リクエストされた場所のタイムゾーン。 |
next |
次のページを取得するためのトークン。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/cloud-platform
HistoryHour
特定の場所の 1 時間ごとの履歴レコードを表します。
JSON 表現 |
---|
{ "interval": { object ( |
フィールド | |
---|---|
interval |
この過去データが有効な 1 時間の間隔(UTC 時間)。タイムスタンプは 1 時間単位で切り捨てられます。 |
display |
この 1 時間ごとの記録が計算された場所のタイムゾーン(民間時)のローカルの日時。このフィールドは、クライアントでの表示目的で使用される場合があります。注: この日付は、年、月、日、時刻、UTC からのオフセットで構成されます。 |
weather |
過去の気象条件。 |
temperature |
過去の気温。 |
feels |
リクエストされた場所の気温の体感温度。 |
dew |
過去の露点温度。 |
heat |
過去の暑さ指数。 |
wind |
過去の風速と気温から算出された、皮膚に当たる体感温度。 |
wet |
過去の湿球温度。水を蒸発させることで達成できる最低温度です。 |
precipitation |
過去の降水確率と過去 1 時間の降水量の合計。 |
air |
過去の気圧の状態。 |
wind |
過去の風況。 |
visibility |
視認性の履歴。 |
ice |
過去の氷の厚み。 |
is |
この時間が現地の日の出(含む)から日没(含まない)までの間にある場合、true。それ以外の場合は、夜間(日没から次の日の日の出まで)です。注: この時間帯は、その時間帯が現地の日の出時刻または日没時刻と重なっている場合は、それぞれ昼間または夜間と見なされます(例: 時間帯が午前 5 時から午前 6 時で、日の出が午前 5 時 59 分の場合、isDaytime は true になります)。 |
relative |
過去の相対湿度の割合(0 ~ 100 の値)。 |
uv |
過去の紫外線(UV)指数。 |
thunderstorm |
過去の雷雨の確率(0 ~ 100 の値)。 |
cloud |
雲に覆われた空の割合(0 ~ 100 の値)。 |