Method: history.lookup

傳回特定時間範圍內的空氣品質記錄。

HTTP 要求

POST https://airquality.googleapis.com/v1/history:lookup

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

要求主體

要求主體的資料會採用以下結構:

JSON 表示法
{
  "pageSize": integer,
  "pageToken": string,
  "location": {
    object (LatLng)
  },
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "uaqiColorPalette": enum (ColorPalette),
  "customLocalAqis": [
    {
      object (CustomLocalAqi)
    }
  ],
  "dateTime": string,
  "hours": integer,
  "period": {
    object (Interval)
  }
  // End of list of possible types for union field time_range.
  "universalAqi": boolean,
  "languageCode": string
}
欄位
pageSize

integer

選用設定。每頁傳回的每小時資訊記錄數量上限。預設值為 72,最大值為 168 (7 天的資料)。

pageToken

string

選用設定。接收自舊記錄呼叫的網頁權杖。系統會使用它來擷取後續網頁。

請注意,提供此參數的值時,您提供的其他所有參數都必須與提供網頁權杖 (先前的呼叫) 的呼叫相符。

location

object (LatLng)

必要欄位。API 尋找空氣品質記錄資料的經緯度。

extraComputations[]

enum (ExtraComputation)

選用設定。可視需要啟用的其他功能。指定額外的運算作業會在回應中傳回相關元素和欄位。

uaqiColorPalette

enum (ColorPalette)

選用設定。決定「全球空氣品質指數」所提供資料的調色盤。(UAQI)。這個調色盤只適用於 UAQI,其他 AQI 則有無法控制的預設調色盤。

customLocalAqis[]

object (CustomLocalAqi)

選用設定。將「國家/地區」表示至 AQI關係將國家/地區與所需的 AQI 配對,讓系統根據所選 AQI 顯示該國家/地區所需的空氣品質資料。這個參數可用於為特定國家/地區指定非預設的 AQI,例如取得加拿大的美國環境保護局索引,而非加拿大的預設索引。

dateTime

string (Timestamp format)

要傳回歷來資料的時間戳記。時間戳記會四捨五入為先前的確切小時。

注意:系統只會傳回所要求時間戳記的每小時資料 (即單一每小時資訊元素)。舉例來說,如果傳送的要求在 dateTime 參數設為 2023-01-03T11:05:49Z,將會無條件捨去為 2023-01-03T11:00:00Z。

RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。例如:「2014-10-02T15:01:23Z」以及「2014-10-02T15:01:23.045123456Z」

注意:您可以在要求中使用 dateTimestartTimeendTime

hours

integer

介於 1 到 720 的數字,表示要求的時數範圍。例如:如果值為 48,則會產生過去 48 小時的資料。

period

object (Interval)

指出要取得歷來資料的 startTimeendTime 期間。時間戳記會四捨五入為先前的確切小時。

注意:您可以在要求中使用 dateTimestartTimeendTime

universalAqi

boolean

選用設定。如果設為 True,系統會將通用 AQI 納入「索引」來自回應的 欄位。預設值為 true。

languageCode

string

選用設定。允許用戶端選擇回應語言。如果該語言無法提供資料,API 就會使用最接近的項目。允許的值必須採用 IETF 標準。預設值為 en (英文)。

回應主體

如果成功,回應主體即會包含具有以下結構的資料:

JSON 表示法
{
  "hoursInfo": [
    {
      object (HourInfo)
    }
  ],
  "regionCode": string,
  "nextPageToken": string
}
欄位
hoursInfo[]

object (HourInfo)

選用設定。包含要求範圍內每小時的空氣品質資訊。例如,如果索取的時間是 48 小時,那麼每小時資訊就會有 48 個元素。

regionCode

string

選用設定。與要求中提供的地點對應的國家/地區 ISO_3166-1 alpha-2 代碼。如果要求中提供的地點位於有爭議的地區,回應中可能會省略這個欄位。

nextPageToken

string

選用設定。用於擷取下一頁的憑證。

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱 OAuth 2.0 總覽

HourInfo

包含要求範圍內每小時的空氣品質資訊。例如,如果索取的時間是 48 小時,那麼每小時資訊就會有 48 個元素。

JSON 表示法
{
  "dateTime": string,
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  }
}
欄位
dateTime

string (Timestamp format)

遞減的時間戳記,指出資料參照的時間 (採用 RFC3339 UTC「Zulu」) 的時間格式,解析度為奈秒,且最多 9 個小數位數。例如:「2014-10-02T15:00:00Z」。

indexes[]

object (AirQualityIndex)

根據要求參數,這份清單最多會包含兩個空氣品質指數:

  • 通用 AQI如果 universalAqi 布林值設為 true,就會傳回 。
  • 當地 AQI.如果指定 LOCAL_AQI 額外運算,就會傳回 。
pollutants[]

object (Pollutant)

影響要求中指定位置的汙染物清單。注意:系統只會針對指定了下列一或多個額外運算的要求,傳回這個欄位:POLLUTANT_ADDITIONAL_INFO、DOMINANT_POLLUTANT_CONCENTRATION、POLLUTANT_CONCENTRATION。

healthRecommendations

object (HealthRecommendations)

與系統回報的空氣品質情況相關的健康建議和應變措施建議。推薦系統也會針對有風險的族群、對汙染物較為敏感的族群,以及一般大眾提供不同的建議。