Method: history.hours.lookup

指定した場所の過去 1 時間から 24 時間までの 1 時間ごとの過去の気象データを返します。

HTTP リクエスト

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

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

クエリ パラメータ

パラメータ
location

object (LatLng)

必須。1 時間ごとの過去のデータを取得する場所。

unitsSystem

enum (UnitsSystem)

省略可。返される天候の状態に使用する単位システム。指定しない場合、返される天候はメートル法で表示されます(デフォルト = METRIC)。

pageSize

integer

省略可。ページごとに返される 1 時間ごとの過去のレコードの最大数。値は 1 ~ 24 です。デフォルトは最大許容値の 24 です。

pageToken

string

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

hours

integer

省略可。前回取得した時間から取得する合計時間を制限します。1 ~ 24 時間(含む)です。デフォルトは最大許容値の 24 です。

languageCode

string

省略可。クライアントがレスポンスの言語を選択できるようにします。その言語のデータを提供できない場合は、最も近い一致が使用されます。使用できる値は 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 時間)。タイムスタンプは 1 時間単位で切り捨てられます。

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 の値)。