Présentation de l'API Air Quality
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
L'API Air Quality vous permet de demander des données sur la qualité de l'air pour un lieu spécifique, y compris plus de 70 indices de la qualité de l'air (IQA), des polluants et des recommandations de santé. Elle couvre plus de 100 pays avec une résolution de 500 x 500 mètres.
Pourquoi utiliser l'API Air Quality ?
L'API fournit des points de terminaison qui vous permettent d'interroger les éléments suivants :
- Conditions actuelles : informations sur la qualité de l'air en temps réel, heure par heure.
- Historique horaire : historique de la qualité de l'air pour un lieu spécifique, pour une période donnée (30 jours maximum).
- Cartes thermiques : tuiles de différentes couleurs représentant divers indices et polluants.
- Prévisions horaires : conditions de qualité de l'air futures pour un lieu spécifique, jusqu'à 96 heures (4 jours).
Fonctionnalités de l'API Air Quality
- Indices et catégories de qualité de l'air en temps réel : l'API Air Quality calcule en continu la valeur de différents indices de qualité de l'air avec une résolution de 500 x 500 mètres.
- Recommandations de santé : des centaines de recommandations de santé basées sur des recherches pour le grand public et les groupes sensibles, y compris les enfants, les personnes âgées, les femmes enceintes, les sportifs et les personnes souffrant d'asthme ou de problèmes cardiaques.
- Informations sur les polluants : informations détaillées sur les différents polluants, avec le polluant dominant, les concentrations, les sources et les effets mis en évidence.
- Historique horaire : historique de la qualité de l'air pour un lieu spécifique et une période donnée. Chaque réponse peut inclure des indices de qualité de l'air horaires, des données sur les polluants et des recommandations de santé pour un maximum de 720 heures (30 jours).
- Cartes thermiques : il s'agit d'un ensemble de tuiles d'images d'indices de qualité de l'air et de polluants qui peuvent être affichées au-dessus d'une carte Google.
Si votre adresse de facturation se trouve dans l'Espace économique européen (EEE), vous pouvez afficher des cartes thermiques sur n'importe quelle carte.
En savoir plus
- Prévisions horaires : conditions de qualité de l'air futures pour un lieu spécifique, et pour une plage horaire donnée ou pour une heure précise dans le futur, jusqu'à 96 heures (4 jours). Chaque réponse peut inclure des indices de prévision de la qualité de l'air heure par heure, des données sur les polluants et des recommandations pratiques.
Fonctionnement de l'API Air Quality
L'API Air Quality comporte les méthodes suivantes :
currentConditions : le point de terminaison currentConditions fournit des informations horaires actuelles sur la qualité de l'air.
history : le point de terminaison history fournit des informations historiques sur la qualité de l'air heure par heure pour un lieu spécifique, pour une plage de temps donnée, jusqu'à un maximum de 30 jours.
heatmapTiles : le point de terminaison heatmapTiles fournit des cartes de densité liées à la qualité de l'air via une superposition de tuiles.
forecast : le point de terminaison forecast fournit des informations horaires sur la qualité de l'air pour un lieu spécifique, pour une période donnée, jusqu'à un maximum de 96 heures (4 jours).
Couverture par pays et par région de l'API Air Quality
Consultez la page Pays couverts par l'API Air Quality et indices de qualité de l'air disponibles pour obtenir les dernières informations sur la couverture, pays par pays, pour lesquelles des informations sur la qualité de l'air (IQA) et des informations locales sur la qualité de l'air (ILQA) sont disponibles.
Utiliser l'API Air Quality
| 1 |
Configurer |
Commencez par Configurer votre projet Google Cloud, puis suivez les instructions. |
| 2 |
Obtenir des informations horaires sur la qualité de l'air |
Consultez Conditions actuelles. |
| 3 |
Obtenir l'historique horaire de la qualité de l'air |
Consultez Historique. |
| 4 |
Obtenir des cartes de densité liées à la qualité de l'air via une superposition de tuiles |
Consultez Cartes de densité. |
| 5 |
Obtenir des informations sur les prévisions de la qualité de l'air heure par heure |
Consultez Prévisions. |
Étape suivante
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[null,null,["Dernière mise à jour le 2025/08/31 (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)"]]
