Method: forecast.hours.lookup

傳回指定地點的每小時天氣預報，最多 240 小時，從目前小時開始。

HTTP 要求

GET https://weather.googleapis.com/v1/forecast/hours:lookup

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

查詢參數

參數
location

object (LatLng)

必要欄位。取得每小時天氣預報的位置。
unitsSystem

enum (UnitsSystem)

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

integer

選用設定。每頁傳回的每小時天氣預報記錄數量上限，值為 1 到 24 (含)。預設值為允許的最大值 24。
pageToken

string

選用設定。從先前要求收到的網頁權杖。用於擷取後續網頁。
hours

integer

選用設定。限制從目前小時開始擷取的總小時數量，值介於 1 到 240 (含) 之間。預設值為允許的最大值 240。
languageCode

string

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

要求主體

要求主體必須為空白。

回應主體

hours.lookup RPC 的回應。

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

JSON 表示法 
{
  "forecastHours": [
    {
      object (ForecastHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
欄位
forecastHours[]

object (ForecastHour)

根據要求中指定的小時數和頁面大小，提供每小時天氣預報記錄。
timeZone

object (TimeZone)

要求位置的時區。
nextPageToken

string

用來擷取下一頁的符記。

授權範圍

需要下列 OAuth 範圍：

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

ForecastHour

代表特定地點的每小時天氣預報記錄。

JSON 表示法 
{
  "interval": {
    object (Interval)
  },
  "displayDateTime": {
    object (DateTime)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "wetBulbTemperature": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
欄位
interval

object (Interval)

預測資料的有效時間間隔 (以世界標準時間計算)，時間戳記會四捨五入至最接近的小時。
displayDateTime

object (DateTime)

這個每小時天氣預報計算的地區所在時區 (公曆時間) 的當地日期和時間。此欄位可用於在用戶端上顯示。注意：這個日期會包含年、月、日、小時和世界標準時間的偏移量。
weatherCondition

object (WeatherCondition)

預測的天氣狀況。
temperature

object (Temperature)

預測溫度。
feelsLikeTemperature

object (Temperature)

在指定位置測量溫度感覺。
dewPoint

object (Temperature)

預測的露點溫度。
heatIndex

object (Temperature)

預測的酷熱指數溫度。
windChill

object (Temperature)

預測的體感溫度，即皮膚表面的空氣溫度。
wetBulbTemperature

object (Temperature)

預測的溼球溫度，也就是透過水蒸發可達到的最低溫度。
precipitation

object (Precipitation)

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

object (AirPressure)

預測的氣壓條件。
wind

object (Wind)

預測的風勢。
visibility

object (Visibility)

預測的可視度。
iceThickness

object (IceThickness)

預測的冰層厚度。
isDaytime

boolean

如果這個小時介於當地日出 (含) 和日落 (不含) 之間，則為 True。否則就是夜間 (日落到下次日出之間)。注意：如果間隔與當地日出和日落時間重疊，系統會將這個小時視為白天或夜晚 (例如：如果間隔為上午 5 點到 6 點，且日出時間為上午 5 點 59 分，則 isDaytime 會設為 true)。
relativeHumidity

integer

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

integer

紫外線 (UV) 指數預測值。
thunderstormProbability

integer

預測的雷暴機率 (值介於 0 到 100)。
cloudCover

integer

天空被雲遮蔽的預測百分比 (值介於 0 到 100)。