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

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