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

目前的紫外線指數。
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)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
欄位
temperatureChange

object (Temperature)

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

object (Temperature)

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

object (Temperature)

過去 24 小時的最低溫。
snowQpf

object (QuantitativePrecipitationForecast)

過去 24 小時內累積的雪量，以等量的液態水測量。注意：QPF 是定量降水預報的縮寫 (詳情請參閱「定量降水預報」定義)。
qpf

object (QuantitativePrecipitationForecast)

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