指定した場所の 1 時間ごとの予測を、現在の時間から最大 240 時間分返します。
HTTP リクエスト
GET https://weather.googleapis.com/v1/forecast/hours:lookup
この URL は gRPC Transcoding 構文を使用します。
クエリ パラメータ
パラメータ | |
---|---|
location |
必須。1 時間ごとの天気予報を取得する場所。 |
units |
省略可。返される天候の状態に使用する単位システム。指定しない場合、返される天候はメートル法で表示されます(デフォルト = METRIC)。 |
page |
省略可。ページごとに返される 1 時間ごとの予報レコードの最大数。1 ~ 24(両端を含む)の値です。デフォルトは最大許容値の 24 です。 |
page |
省略可。前回のリクエストから受け取ったページトークン。後続のページの取得に使用されます。 |
hours |
省略可。現在の時刻から取得する合計時間を制限します。値は 1 ~ 240 です。デフォルトは許容最大値の 240 です。 |
language |
省略可。クライアントがレスポンスの言語を選択できるようにします。その言語のデータを提供できない場合は、最も近い一致が使用されます。使用できる値は IETF BCP-47 標準に準拠しています。デフォルト値は「en」です。 |
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
hours.lookup RPC のレスポンス。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{ "forecastHours": [ { object ( |
フィールド | |
---|---|
forecast |
リクエストで指定された時間数とページサイズに応じた、1 時間ごとの予報レコード。 |
time |
リクエストされた場所のタイムゾーン。 |
next |
次のページを取得するためのトークン。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/cloud-platform
ForecastHour
特定の場所の 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 の値)。 |