記錄

history 端點 針對特定地點的每小時空氣品質資訊 時間範圍,最多 30 天。您可以控制哪些 AQI 和 並傳回相關的相關資訊 (例如汙染物濃度等級 健康建議)。

你可以使用 history敬上 方法是傳送 HTTP POST 要求至:

https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY

將要求選項納入 JSON 要求主體。要求主體 包含您要取得 每小時的空氣品質記錄可能也提供多種控制選項 應加入回應中的空氣品質資訊

API 多層檢視可讓您發出即時要求,以便更瞭解 API 和 API 選項:

試試看!

一小時要求示例

單一小時要求主體

下列程式碼顯示如何建構一小時的要求主體 透過查詢使用記錄 history 方法,增加圍繞地圖邊緣的邊框間距。 在本例中,您設定了位置和過去的時間戳記。

curl -X POST -d '{
  "dateTime": "2023-06-26T15:01:23Z",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'

一小時內回應

上述呼叫會產生下列內容: JSON 回應。 如要進一步瞭解回應資料,請參閱「回應資料」。

{
    "hoursInfo": [
        {
            "dateTime": "2023-06-26T15:00:00Z",
            "indexes": [
                {
                    "code": "uaqi",
                    "displayName": "Universal AQI",
                    "aqi": 73,
                    "aqiDisplay": "73",
                    "color": {
                        "red": 118,
                        "green": 202,
                        "blue": 51,
                        "alpha": 255
                    },
                    "category": "Good air quality",
                    "dominantPollutant": "pm10"
                }
            ]
        }
    ],
    "regionCode": "us"
}

時間範圍要求範例

時間範圍要求

下列程式碼顯示如何為 history,可傳回多個 每小時空氣品質記錄。

您可以指定時間範圍 (例如開頭) 來要求多筆記錄 和結束時間戳記,或指定從目前時間往回追溯的天數 讓應用程式從可以最快做出回應的位置 回應使用者要求

在以下範例中,由於您將頁面大小設為 2,因此您對 4 小時的空氣品質記錄分別傳回兩個頁面 內含 2 小時的資料

curl -X POST -d '{
  "hours": 4,
  "pageSize": 2,
  "pageToken":"",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'

您可以傳遞開始和結束的時間戳記,提出類似的要求:

curl -X POST -d '{
  "period": {
      "startTime":"2023-06-15T08:00:00Z",
      "endTime":"2023-06-15T12:00:00Z"
  },
  "pageSize": 2,
  "pageToken":"",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'

時間範圍回應

上述呼叫會產生 形式的 JSON 回應 。如要進一步瞭解回應資料,請參閱 回應資料

以上兩通呼叫都會要求 4 小時的空氣品質資料。但由於您設定了 在要求中將 pageSize 屬性設為 2,回應只包含 最近兩小時的搜尋結果

{
    "hoursInfo": [
        {
            "dateTime": "2023-06-15T11:00:00Z",
            "indexes": [
                {
                    "code": "uaqi",
                    "displayName": "Universal AQI",
                    "aqi": 83,
                    "aqiDisplay": "83",
                    "color": {
                        "red": 74,
                        "green": 185,
                        "blue": 54,
                        "alpha": 255
                    },
                    "category": "Excellent air quality",
                    "dominantPollutant": "o3"
                }
            ]
        },
        {
            "dateTime": "2023-06-15T10:00:00Z",
            "indexes": [
                {
                    "code": "uaqi",
                    "displayName": "Universal AQI",
                    "aqi": 89,
                    "aqiDisplay": "89",
                    "color": {
                        "red": 48,
                        "green": 175,
                        "blue": 55,
                        "alpha": 255
                    },
                    "category": "Excellent air quality",
                    "dominantPollutant": "o3"
                }
            ]
        }
    ],
    "regionCode": "us",
    "nextPageToken": "ChYaEgl3gv3XubVCQBEsNMY9TTdUMTE6MDA6MDA"
}

請注意,回應也會包含 nextPageToken 屬性。使用這個屬性可存取下一頁的結果,其中包含接下來兩小時的資料。

如要存取下一頁的結果,請向 history 端點發出第二次要求,但這次請將 pageToken 屬性設為第一個回應中的 nextPageToken 值。

curl -X POST -d '{
  "hours": 4,
  "pageSize": 2,
  "pageToken":"ChYaEgl3gv3XubVCQBEsNMY9TTdUMTE6MDA6MDA",
  "location": {
    "latitude": 37.419734,
    "longitude": -122.0827784
  }
}' \
-H 'Content-Type: application/json' \
'https://airquality.googleapis.com/v1/history:lookup?key=YOUR_API_KEY'