Method: history.hours.lookup

從最後一小時開始，傳回指定地點最多 24 小時的每小時歷史天氣資料。

HTTP 要求

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

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

查詢參數

參數
location

object (LatLng)

必要欄位。要取得每小時歷史資料的位置。
unitsSystem

enum (UnitsSystem)

(選用步驟) 用於傳回天氣狀況的單位系統。如未提供，傳回的天氣狀況將採用公制單位 (預設值 = METRIC)。
pageSize

integer

(選用步驟) 每頁傳回的小時記錄數上限，值介於 1 到 24 (含首尾)。預設值為允許上限 24。
pageToken

string

(選用步驟) 先前要求傳回的頁面符記。用於擷取後續網頁。
hours

integer

(選用步驟) 限制要從最後一小時開始擷取的總時數，範圍為 1 到 24 (含)。預設值為允許上限 24。
languageCode

string

(選用步驟) 允許用戶端選擇回覆的語言。如果無法提供該語言的資料，API 會使用最接近的語言。有效值須符合 IETF BCP-47 標準。預設值為「en」。

要求主體

要求主體必須為空白。

回應主體

hours.lookup RPC 的回應。

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

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

object (HistoryHour)

每小時的歷史記錄，視要求中指定的小時數和網頁大小而定。
timeZone

object (TimeZone)

要求位置的時區。
nextPageToken

string

用於擷取下一頁的權杖。

授權範圍

需要下列 OAuth 範圍：

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

HistoryHour

代表特定地點的每小時記錄。

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 之間)。