Method: forecast.hours.lookup

指定した場所の 1 時間ごとの予測を、現在の時間から最大 240 時間分返します。

HTTP リクエスト

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

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

クエリ パラメータ

パラメータ
location

object (LatLng)

必須。1 時間ごとの天気予報を取得する場所。

unitsSystem

enum (UnitsSystem)

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

pageSize

integer

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

pageToken

string

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

hours

integer

省略可。現在の時刻から取得する合計時間を制限します。値は 1 ~ 240 です。デフォルトは許容最大値の 240 です。

languageCode

string

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

リクエストの本文

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

レスポンスの本文

hours.lookup RPC のレスポンス。

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

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

object (ForecastHour)

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

timeZone

object (TimeZone)

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

nextPageToken

string

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

認可スコープ

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

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

ForecastHour

特定の場所の 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 の値)。