指定された場所の過去 1 時間から始まる 1 時間ごとの過去の気象データを最大 24 時間分返します。
HTTP リクエスト
GET https://weather.googleapis.com/v1/history/hours:lookup
この URL は gRPC Transcoding 構文を使用します。
クエリ パラメータ
| パラメータ | |
|---|---|
location |
必須。時間別履歴データを取得する場所。 |
unitsSystem |
省略可。返される天気予報の単位系。指定しない場合、返される天気予報はメートル法になります(デフォルト = METRIC)。 |
pageSize |
省略可。ページごとに返される 1 時間ごとの履歴レコードの最大数 - 1 ~ 24(両端を含む)の値。デフォルトは最大許容値の 24 です。 |
pageToken |
省略可。前のリクエストから受け取ったページトークン。後続のページを取得するために使用されます。 |
hours |
省略可。取得する合計時間数を制限します。最後の時間から開始します。1 ~ 24(両端を含む)の範囲で指定します。デフォルトは最大許容値の 24 です。 |
languageCode |
省略可。クライアントがレスポンスの言語を選択できるようにします。その言語のデータを提供できない場合、API は最も近い一致を使用します。使用できる値は IETF BCP-47 標準に基づいています。デフォルト値は「en」です。 |
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
hours.lookup RPC のレスポンス。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
| JSON 表現 |
|---|
{ "historyHours": [ { object ( |
| フィールド | |
|---|---|
historyHours[] |
リクエストで指定された時間数とページサイズに応じた、1 時間ごとの履歴レコード。 |
timeZone |
リクエストされた場所のタイムゾーン。 |
nextPageToken |
次のページを取得するためのトークン。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/cloud-platform
HistoryHour
特定の場所の 1 時間ごとの履歴レコードを表します。
| JSON 表現 |
|---|
{ "interval": { object ( |
| フィールド | |
|---|---|
interval |
この過去データが有効な 1 時間の間隔(UTC 時間)(タイムスタンプは最も近い時間に切り捨てられます)。 |
displayDateTime |
この 1 時間ごとの記録が計算された場所のタイムゾーンの現地日時(民法上の時間)。このフィールドは、クライアントでの表示に使用されることがあります。注: この日付は、年、月、日、時間、UTC からのオフセットで構成されます。 |
weatherCondition |
過去の気象条件。 |
temperature |
過去の気温。 |
feelsLikeTemperature |
リクエストされた場所で体感した温度の測定値。 |
dewPoint |
過去の露点温度。 |
heatIndex |
過去の暑さ指数。 |
windChill |
過去の風冷え、皮膚にさらされた気温。 |
wetBulbTemperature |
過去の湿球温度。水を蒸発させることで達成できる最低温度。 |
precipitation |
過去 1 時間の降水確率と降水量の累積値。 |
airPressure |
過去の気圧条件。 |
wind |
過去の風況。 |
visibility |
過去の視認性。 |
iceThickness |
過去の氷の厚さ。 |
isDaytime |
この時間が現地の日出(含む)から日没(含まない)までの間にある場合は true。それ以外の場合は夜間(日没から次の日の出までの間)です。注: この時間は、間隔がそれぞれ現地の日の出と日没の時刻と交差する場合、昼間または夜間と見なされます(例: 間隔が午前 5 時から午前 6 時で、日の出が午前 5 時 59 分の場合、isDaytime は true になります)。 |
relativeHumidity |
過去の相対湿度の割合(0 ~ 100 の値)。 |
uvIndex |
過去の紫外線(UV)指数。 |
thunderstormProbability |
過去の雷雨の確率(値は 0 ~ 100)。 |
cloudCover |
過去の雲の割合(0 ~ 100 の値)。 |