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