Method: currentConditions.lookup

傳回指定位置目前的天氣狀況。

HTTP 要求

GET https://weather.googleapis.com/v1/currentConditions:lookup

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
location

object (LatLng)

必要欄位。要取得目前天氣狀況的位置。
unitsSystem

enum (UnitsSystem)

選用設定。用於傳回天氣狀況的單位系統。如果未提供，系統會以公制單位傳回天氣狀況 (預設值 = METRIC)。
languageCode

string

選用設定。允許用戶端選擇回應的語言。如果無法提供該語言的資料，API 會使用最接近的值。有效值取決於 IETF BCP-47 標準。預設值為「en」。

要求主體

要求主體必須為空白。

回應主體

回應 (適用於 currentConditions.lookup RPC)：代表要求位置目前的天氣狀況。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "currentTime": string,
  "timeZone": {
    object (TimeZone)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "currentConditionsHistory": {
    object (CurrentConditionsHistory)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
欄位
currentTime

string (Timestamp format)

與傳回資料相關聯的目前時間 (世界標準時間)。

使用 RFC 3339，產生的輸出內容一律會經過 Z 規格化，並使用 0、3、6 或 9 小數位數。系統也接受「Z」以外的偏移值。例如："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
timeZone

object (TimeZone)

要求位置的時區。
weatherCondition

object (WeatherCondition)

目前的天氣狀況。
temperature

object (Temperature)

目前溫度。
feelsLikeTemperature

object (Temperature)

在要求位置，目前溫度的感覺溫度。
dewPoint

object (Temperature)

目前的露點溫度。
heatIndex

object (Temperature)

目前的酷熱指數溫度。
windChill

object (Temperature)

目前的體感溫度，即皮膚接觸到的空氣溫度。
precipitation

object (Precipitation)

目前的降雨機率和過去一小時累積的降雨量。
airPressure

object (AirPressure)

目前的氣壓狀況。
wind

object (Wind)

目前的風速狀況。
visibility

object (Visibility)

目前的能見度。
currentConditionsHistory

object (CurrentConditionsHistory)

過去 24 小時內目前天氣狀況的變化。
isDaytime

boolean

如果目前時間介於當地日出 (含) 和日落 (不含) 之間，則為 true。否則就是夜間 (日落到下次日出之間)。
relativeHumidity

integer

目前的相對濕度百分比 (值介於 0 到 100)。
uvIndex

integer

目前的紫外線 (UV) 指數。
thunderstormProbability

integer

目前的雷暴機率 (值介於 0 到 100)。
cloudCover

integer

目前天空被雲層遮蔽的百分比 (值介於 0 到 100)。

授權範圍

需要下列 OAuth 範圍：

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

CurrentConditionsHistory

代表過去 24 小時內目前天氣條件的一組變化。

JSON 表示法 
{
  "temperatureChange": {
    object (Temperature)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
欄位
temperatureChange

object (Temperature)

目前溫度減去 24 小時前的溫度。
maxTemperature

object (Temperature)

過去 24 小時內的最高 (最高) 溫度。
minTemperature

object (Temperature)

過去 24 小時內的最低溫度。
qpf

object (QuantitativePrecipitationForecast)

過去 24 小時內累積的降水量 (雨或雪)，以等同於液態水的量來衡量。注意：QPF 是定量降水預報的縮寫 (詳情請參閱定量降水預報定義)。