Обзор API качества воздуха
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
API качества воздуха позволяет запрашивать данные о качестве воздуха в определённом месте, включая более 70 индексов качества воздуха (AQI), данные о загрязняющих веществах и рекомендации по охране здоровья. Он охватывает более 100 стран с разрешением 500 x 500 метров.
Зачем использовать API качества воздуха
API предоставляет конечные точки, которые позволяют вам запрашивать:
- Текущие условия: почасовая информация о качестве воздуха в режиме реального времени.
- Почасовая история: история качества воздуха в определенном месте за заданный период времени, максимум до 30 дней.
- Тепловые карты: цветные плитки различных индексов и загрязняющих веществ.
- Почасовой прогноз: будущие условия качества воздуха для определенного места на срок до 96 часов (4 дня).
Возможности API качества воздуха
- Индексы и категории качества воздуха в режиме реального времени: API качества воздуха непрерывно рассчитывает значения различных индексов качества воздуха с разрешением 500 x 500 метров.
- Рекомендации по охране здоровья: сотни рекомендаций по охране здоровья, основанных на исследованиях, для широкой общественности и групп с повышенной чувствительностью, включая детей, пожилых людей, беременных женщин, спортсменов, а также людей с астмой или сердечными заболеваниями.
- Подробная информация о загрязняющих веществах: подробная информация о различных загрязняющих веществах с указанием доминирующего загрязняющего вещества, концентрации, источников и воздействия.
- Почасовая история: история качества воздуха в определённом месте за заданный период времени. Каждый ответ может включать почасовые индексы качества воздуха, данные о загрязняющих веществах и рекомендации по охране здоровья максимум за 720 часов (30 дней).
- Тепловые карты: Тепловые карты представляют собой набор изображений индексов качества воздуха и загрязняющих веществ, которые можно отображать поверх Google Maps. Если ваш платёжный адрес находится в Европейской экономической зоне (ЕЭЗ), вы можете отображать тепловые карты поверх любой карты. Подробнее .
- Почасовой прогноз: прогнозируемое качество воздуха в конкретном месте на заданный период времени или на конкретный час в будущем, до 96 часов (4 дня). Каждый ответ может включать почасовой прогноз качества воздуха, данные о загрязняющих веществах и практические рекомендации.
Как работает API качества воздуха
API качества воздуха имеет следующие методы:
currentConditions : Конечная точка currentConditions предоставляет текущую почасовую информацию о качестве воздуха.
история : Конечная точка history предоставляет историческую почасовую информацию о качестве воздуха для определенного местоположения за заданный период времени, максимум до 30 дней.
heatmapTiles : Конечная точка heatmapTiles предоставляет тепловые карты, связанные с качеством воздуха, посредством наложения плиток.
прогноз : конечная точка forecast предоставляет почасовую информацию о будущем качестве воздуха для определенного местоположения в течение заданного временного диапазона, максимум до 96 часов (4 дня).
Охват стран и регионов API качества воздуха
Актуальную информацию о покрытии по каждой стране, для которой доступна информация о качестве воздуха (AQI) и информация о местном качестве воздуха (LAQI), см. в списке стран, поддерживаемых API качества воздуха, и доступных показателях качества воздуха (AQI).
Как использовать API качества воздуха
| 1 | Настройте | Начните с настройки проекта Google Cloud и следуйте приведенным ниже инструкциям. |
| 2 | Получайте актуальную почасовую информацию о качестве воздуха | См. Текущие условия . |
| 3 | Получайте почасовую историю качества воздуха | См. Историю . |
| 4 | Получайте тепловые карты, связанные с качеством воздуха, с помощью наложения плиток | См. Тепловые карты . |
| 5 | Получайте почасовую информацию о прогнозе качества воздуха | См. Прогноз . |
Что дальше?
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[[["\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)"]]
