Method: history.hours.lookup

返回给定地点（从过去一小时开始）最多 24 小时的每小时历史天气数据。

HTTP 请求

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

网址采用 gRPC 转码语法。

查询参数

参数
location

object (LatLng)

必需。要获取每小时历史数据的位置。
unitsSystem

enum (UnitsSystem)

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

integer

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

按小时统计的历史记录，具体取决于请求中指定的时长和页面大小。
timeZone

object (TimeZone)

请求地点的时区。
nextPageToken

string

用于检索下一页的令牌。

授权范围

需要以下 OAuth 范围：

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

HistoryHour

表示给定位置的每小时历史记录。

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 之间）。