Method: history.hours.lookup

指定された場所の過去 1 時間から始まる 1 時間ごとの過去の気象データを最大 24 時間分返します。

HTTP リクエスト

GET https://weather.googleapis.com/v1/history/hours:lookup

この URL は gRPC Transcoding 構文を使用します。

クエリ パラメータ

パラメータ
location

object (LatLng)

必須。時間別履歴データを取得する場所。

unitsSystem

enum (UnitsSystem)

省略可。返される天気予報の単位系。指定しない場合、返される天気予報はメートル法になります(デフォルト = METRIC)。

pageSize

integer

省略可。ページごとに返される 1 時間ごとの履歴レコードの最大数 - 1 ~ 24(両端を含む)の値。デフォルトは最大許容値の 24 です。

pageToken

string

省略可。前のリクエストから受け取ったページトークン。後続のページを取得するために使用されます。

hours

integer

省略可。取得する合計時間数を制限します。最後の時間から開始します。1 ~ 24(両端を含む)の範囲で指定します。デフォルトは最大許容値の 24 です。

languageCode

string

省略可。クライアントがレスポンスの言語を選択できるようにします。その言語のデータを提供できない場合、API は最も近い一致を使用します。使用できる値は IETF BCP-47 標準に基づいています。デフォルト値は「en」です。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

hours.lookup RPC のレスポンス。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現
{
  "historyHours": [
    {
      object (HistoryHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
フィールド
historyHours[]

object (HistoryHour)

リクエストで指定された時間数とページサイズに応じた、1 時間ごとの履歴レコード。

timeZone

object (TimeZone)

リクエストされた場所のタイムゾーン。

nextPageToken

string

次のページを取得するためのトークン。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform

HistoryHour

特定の場所の 1 時間ごとの履歴レコードを表します。

JSON 表現
{
  "interval": {
    object (Interval)
  },
  "displayDateTime": {
    object (DateTime)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "wetBulbTemperature": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
フィールド
interval

object (Interval)

この過去データが有効な 1 時間の間隔(UTC 時間)(タイムスタンプは最も近い時間に切り捨てられます)。

displayDateTime

object (DateTime)

この 1 時間ごとの記録が計算された場所のタイムゾーンの現地日時(民法上の時間)。このフィールドは、クライアントでの表示に使用されることがあります。注: この日付は、年、月、日、時間、UTC からのオフセットで構成されます。

weatherCondition

object (WeatherCondition)

過去の気象条件。

temperature

object (Temperature)

過去の気温。

feelsLikeTemperature

object (Temperature)

リクエストされた場所で体感した温度の測定値。

dewPoint

object (Temperature)

過去の露点温度。

heatIndex

object (Temperature)

過去の暑さ指数。

windChill

object (Temperature)

過去の風冷え、皮膚にさらされた気温。

wetBulbTemperature

object (Temperature)

過去の湿球温度。水を蒸発させることで達成できる最低温度。

precipitation

object (Precipitation)

過去 1 時間の降水確率と降水量の累積値。

airPressure

object (AirPressure)

過去の気圧条件。

wind

object (Wind)

過去の風況。

visibility

object (Visibility)

過去の視認性。

iceThickness

object (IceThickness)

過去の氷の厚さ。

isDaytime

boolean

この時間が現地の日出(含む)から日没(含まない)までの間にある場合は true。それ以外の場合は夜間(日没から次の日の出までの間)です。注: この時間は、間隔がそれぞれ現地の日の出と日没の時刻と交差する場合、昼間または夜間と見なされます(例: 間隔が午前 5 時から午前 6 時で、日の出が午前 5 時 59 分の場合、isDaytime は true になります)。

relativeHumidity

integer

過去の相対湿度の割合(0 ~ 100 の値)。

uvIndex

integer

過去の紫外線(UV)指数。

thunderstormProbability

integer

過去の雷雨の確率(値は 0 ~ 100)。

cloudCover

integer

過去の雲の割合(0 ~ 100 の値)。