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'