Method: lookupWeather

搜索某个地点的天气状况。

HTTP 请求

POST https://mapstools.googleapis.com/v1:lookupWeather

网址采用 gRPC 转码语法。

请求正文

请求正文中包含结构如下的数据：

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，则会被忽略。

响应正文

如果成功，则响应正文包含一个 LookupWeatherResponse 实例。

授权范围

需要以下 OAuth 作用域：

  • https://www.googleapis.com/auth/maps-platform.mapstools