LookupWeatherRequest

LookupWeather 方法的请求 - 表示所请求位置的天气状况。

JSON 表示法
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],
  "date": {
    object (Date)
  },
  "hour": integer,
  "languageCode": string,
  "weatherOptions": {
    object (WeatherOptions)
  },
  "airQualityOptions": {
    object (AirQualityOptions)
  }
}
字段
unitsSystem

enum (UnitsSystem)

可选。返回的天气状况所使用的单位制。如果未提供,返回的天气状况将采用公制(默认 = METRIC)。

location

object (Location)

必需。要获取天气状况的位置。

capabilities[]

enum (Capability)

可选。要包含在响应中的环境功能。

date

object (Date)

可选。指定所请求的环境信息的日期,该日期相对于 location 字段中指定位置的本地时区。支持的日期范围取决于请求的功能:- WEATHER:过去最多 24 小时(同时设置 hour 时)和未来最多 10 天(240 小时)(今天到 +9 天,用于每日预测)。- AIR_QUALITY:过去最多 30 天(720 小时),未来最多 4 天(96 小时)。POLLEN:今天到 +4 天(最多 5 天,包括今天;不支持历史日期)。

hour

integer

可选。指定所请求环境信息的小时,采用 24 小时制格式 (0-23),相对于 location 字段中指定位置的本地时区。需要指定 date。支持的小时范围取决于请求的功能:- WEATHER:过去最多 24 小时,未来最多 240 小时(10 天)。- AIR_QUALITY:过去最多 30 天(720 小时),未来最多 4 天(96 小时)。POLLEN:仅返回每日预测;对于花粉,hour 会被忽略。

languageCode

string

可选。响应中本地化文本的 BCP-47 语言代码(例如“en”“ja”“fr-CA”)。如果未指定,则默认为“en”。

weatherOptions

object (WeatherOptions)

可选。天气请求特有的选项。weatherOptions.units_system 与顶级 unitsSystem(标记 4)一起受支持,以保持与现有调用方的向后兼容性;如果两者指定了冲突的单位系统,则返回 INVALID_ARGUMENT。如果未在 capabilities 中请求 WEATHER,则会被忽略。

airQualityOptions

object (AirQualityOptions)

可选。空气质量请求特有的选项。如果未在 capabilities 中请求 AIR_QUALITY,则会被忽略。

WeatherOptions

特定于天气请求的选项。

JSON 表示法
{
  "unitsSystem": enum (UnitsSystem)
}
字段
unitsSystem

enum (UnitsSystem)

可选。返回的天气状况所使用的单位制。如果未提供,返回的天气状况将采用公制(默认 = METRIC)。