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)

假設沒有融化或壓實，預測一段時間內的降雪量。注意：這是實際降雪量，而非液態水當量。QPF 是定量降水預報 (Quantitative Precipitation Forecast) 的縮寫，詳情請參閱 QuantitativePrecipitationForecast 定義。
qpf

object (QuantitativePrecipitationForecast)

預測在一段時間內，所有降水 (雨、雪、冰等) 的總液態水當量。注意：QPF 是定量降水預報的縮寫 (詳情請參閱 QuantitativePrecipitationForecast 定義)。