Air Quality API 總覽
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
Air Quality API 可讓您要求特定地點的空氣品質資料，包括超過 70 種空氣品質指數 (AQI)、汙染物和健康建議。涵蓋超過 100 個國家/地區，解析度為 500 x 500 公尺。
使用 Air Quality API 的好處
這個 API 提供可查詢下列項目的端點：
- 目前狀況：每小時的即時空氣品質資訊。
- 每小時記錄：特定地點的空氣品質記錄，時間範圍最多 30 天。
- 熱視圖：以不同顏色標示各種指數和污染物。
- 每小時預報：特定地點未來 96 小時 (4 天) 的空氣品質狀況。
Air Quality API 的功能
- 即時空氣品質指數和類別：空氣品質 API 會以 500 x 500 公尺的解析度，持續計算各種空氣品質指數的值。
- 健康建議：提供數百項有研究根據的健康建議，適用於一般大眾和敏感族群，包括：兒童、年長者、孕婦、運動員，以及氣喘或心臟病患者。
- 汙染物詳細資料：提供不同汙染物的深入資訊，包括主要汙染物、濃度、來源和影響。
- 每小時記錄：特定地點在指定時間範圍內的空氣品質記錄。每則回應最多可包含 720 小時 (30 天) 的每小時空氣品質指數、污染物資料和健康建議。
- 熱感應地圖：熱感應地圖是空氣品質指數和污染物圖像圖塊的集合，可顯示在 Google 地圖上。如果您的帳單地址位於歐洲經濟區 (EEA)，您可以在任何地圖上顯示熱感應地圖。瞭解詳情。
- 每小時預報：特定地點未來 96 小時 (4 天) 的空氣品質狀況，以及指定時間範圍或特定時間的空氣品質狀況。每則回應都可能包含每小時的空氣品質預報指數、污染物資料和實用建議。
Air Quality API 的運作方式
空氣品質 API 包含下列方法：
Air Quality API 支援的國家/地區和區域
如需各國家/地區的最新涵蓋範圍詳細資料，以及可用的空氣品質指標 (AQI) 和當地空氣品質指標 (LAQI)，請參閱「Air Quality API 支援的國家/地區和可用的空氣品質指標」。
如何使用 Air Quality API
| 1 |
做好準備 |
請先設定 Google Cloud 專案，然後按照後續操作說明完成設定。 |
| 2 |
取得目前每小時的空氣品質資訊 |
請參閱現況。 |
| 3 |
取得每小時的空氣品質記錄 |
請參閱「記錄」。 |
| 4 |
透過圖塊疊加層取得空氣品質相關熱力圖 |
請參閱「熱視圖」。 |
| 5 |
取得每小時空氣品質預報資訊 |
請參閱「預測」。 |
後續步驟
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-08-31 (世界標準時間)。
[null,null,["上次更新時間：2025-08-31 (世界標準時間)。"],[[["\u003cp\u003eThe Air Quality API provides access to real-time, historical, and forecasted air quality data for over 100 countries with a resolution of 500 x 500 meters.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve current conditions, hourly history (up to 30 days), heatmaps, and hourly forecasts (up to 96 hours) using the API.\u003c/p\u003e\n"],["\u003cp\u003eThe API includes various air quality indexes, health recommendations, pollutant details, and heatmap tile overlays.\u003c/p\u003e\n"],["\u003cp\u003eCoverage details and available air quality indexes vary by country and region, so refer to the provided resources for specific information.\u003c/p\u003e\n"],["\u003cp\u003eTo use the Air Quality API, you need to set up a Google Cloud project and then utilize the provided endpoints and documentation to retrieve air quality data.\u003c/p\u003e\n"]]],["The Air Quality API provides real-time and historical air quality data, forecasts, and heatmaps for over 100 countries with 500x500 meter resolution. Key actions include querying current conditions, accessing up to 30 days of hourly history, viewing color-coded heatmap tiles, and obtaining up to 96-hour hourly forecasts. The API delivers information on 70+ AQIs, pollutants, and health recommendations for various groups, leveraging methods such as `currentConditions`, `history`, `heatmapTiles`, and `forecast`.\n"],null,["The Air Quality API lets you request air quality data for a specific location,\nincluding over 70 air quality indexes (AQIs), pollutants, and health\nrecommendations. It covers over 100 countries with a resolution of 500 x 500\nmeters.\n\nWhy use the Air Quality API\n\nThe API provides endpoints that let you query:\n\n- **Current Conditions:** Real-time hourly air quality information.\n- **Hourly History:** Air quality history for a specific location, for a given time range, up to a maximum of 30 days.\n- **Heatmaps:** Color coded tiles of various indexes and pollutants.\n- **Hourly Forecast:** Future air quality conditions for a specific location, up to 96 hours (4 days).\n\nFeatures of the Air Quality API\n\n- **Real-time air quality indexes and categories:** The Air Quality API continuously calculates the value of various air quality indexes with 500 x 500 meters resolution.\n- **Health recommendations:** Hundreds of research-backed health recommendations for the general public and sensitivity groups including: children, elderly, pregnant women, athletes and those with asthma or heart conditions.\n- **Pollutant details:** In-depth information about different pollutants, highlighting the dominant pollutant, concentrations, sources and effects.\n- **Hourly history:** Air quality history for a specific location for a given time range. Each response potentially includes hourly air quality indexes, pollutant data, and health recommendations for a maximum of 720 hours (30 days).\n- **Heatmaps:** Heatmaps are a collection of AQ indexes and pollutants image tiles that can be displayed on top of a Google Map. If your billing address is in the European Economic Area (EEA), you may display heatmaps on top of any map. [Learn more](/maps/comms/eea/faq#tos-updates).\n- **Hourly forecast:** Future air quality conditions for a specific location, and for a given time range or for a particular hour in the future, up to 96 hours (4 days). Each response potentially includes hourly air quality forecast indexes, pollutant data and actionable recommendations.\n\nHow the Air Quality API works\n\nThe Air Quality API has the following methods:\n\n- **currentConditions** : The\n [`currentConditions`](/maps/documentation/air-quality/reference/rest/v1/currentConditions/lookup) endpoint\n provides current hourly air quality information.\n\n- **history** : The\n [`history`](/maps/documentation/air-quality/reference/rest/v1/history/lookup) endpoint provides\n historical hourly air quality information for a specific location, for a\n given time range, up to a maximum of 30 days.\n\n- **heatmapTiles** : The [`heatmapTiles`](/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile)\n endpoint provides air quality related heatmaps through a tile overlay.\n\n- **forecast** : The [`forecast`](/maps/documentation/air-quality/reference/rest/v1/forecast/lookup)\n endpoint provides hourly future air quality information for a specific\n location, for a given time range, up to a maximum of 96 hours (4 days).\n\nAir Quality API country and region coverage\n\nSee [Air Quality API supported countries and available AQIs](/maps/documentation/air-quality/coverage) for the\nlatest coverage details, on a country-by-country basis, for which air quality\ninformation (AQI) and local air quality information (LAQI) is available.\n\nHow to use the Air Quality API\n\n|---|-------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/air-quality/cloud-setup) and complete the instructions that follow. |\n| 2 | **Get current hourly air quality information** | See [Current conditions](/maps/documentation/air-quality/current-conditions). |\n| 3 | **Get hourly air-quality history** | See [History](/maps/documentation/air-quality/history). |\n| 4 | **Get air quality related heatmaps through a tile overlay** | See [Heatmaps](/maps/documentation/air-quality/heatmaps). |\n| 5 | **Get hourly air quality forecast information** | See [Forecast](/maps/documentation/air-quality/forecast). |\n\nWhat's next\n\n- [Set up your Google Cloud project](/maps/documentation/air-quality/cloud-setup)\n- [Get current conditions](/maps/documentation/air-quality/current-conditions)\n- [Get hourly history](/maps/documentation/air-quality/history)\n- [Get heatmaps](/maps/documentation/air-quality/heatmaps)\n- [Get hourly forecast](/maps/documentation/air-quality/forecast)"]]
