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 具有以下方法：
currentConditions：currentConditions 端点提供当前每小时的空气质量信息。
历史记录：history 端点可提供特定位置在给定时间范围内的历史每小时空气质量信息，最长可提供 30 天的数据。
heatmapTiles：heatmapTiles 端点通过图块叠加层提供与空气质量相关的热图。
预报：forecast 端点可提供特定位置在给定时间范围内的未来空气质量信息，最长可提供 96 小时（4 天）的信息。
Air Quality API 在不同国家/地区的覆盖情况
如需了解最新的覆盖范围详细信息（按国家/地区），请参阅支持 Air Quality API 的国家/地区和可用的 AQI，其中列出了哪些国家/地区提供空气质量信息 (AQI) 和本地空气质量信息 (LAQI)。
如何使用 Air Quality API
后续步骤
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-08-31。
[null,null,["最后更新时间 (UTC)：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)"]]
