Method: forecast.hours.lookup

返回指定地点（从当前小时开始）最多 240 小时的每小时预报。

HTTP 请求

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

网址采用 gRPC 转码语法。

查询参数

参数
location

object (LatLng)

必需。要获取其每小时天气预报的位置。
unitsSystem

enum (UnitsSystem)

可选。用于返回的天气状况的单位制。如果未提供，则返回的天气状况将采用公制单位（默认值 = METRIC）。
pageSize

integer

可选。每页返回的小时预报记录数上限 - 值介于 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)

每小时天气预报记录，具体取决于请求中指定的时长和页面大小。
timeZone

object (TimeZone)

请求地点的时区。
nextPageToken

string

用于检索下一页的令牌。

授权范围

需要以下 OAuth 范围：

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

ForecastHour

表示给定地点的每小时天气预报记录。

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)

此预测数据有效的一小时间隔（世界协调时间 [UTC] 时间）。时间戳会向下舍入到最接近的小时。
displayDateTime

object (DateTime)

此小时预报所针对的地点所在时区（民用时间）的当地日期和时间。此字段可用于在客户端上显示。注意：此日期将包含年、月、日、小时和相对于世界协调时间 (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)

预测的降水概率和过去一小时累计降水量。
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 之间）。