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

預測紫外線指數。
thunderstormProbability

integer

預測雷雨機率 (值介於 0 到 100 之間)。
cloudCover

integer

預測雲量百分比 (值介於 0 到 100 之間)。