Descripción general de la API de Air Quality
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La API de Air Quality te permite solicitar datos sobre la calidad del aire de una ubicación específica, incluidos más de 70 índices de calidad del aire (ICA), contaminantes y recomendaciones de salud. Abarca más de 100 países con una resolución de 500 x 500 metros.
Por qué usar la API de Air Quality
La API proporciona extremos que te permiten consultar lo siguiente:
- Condiciones actuales: Información sobre la calidad del aire por hora en tiempo real
- Historial por hora: Historial de la calidad del aire de una ubicación específica para un período determinado, con un máximo de 30 días.
- Mapas de calor: Son mosaicos codificados por color de varios índices y contaminantes.
- Pronóstico por hora: Condiciones futuras de la calidad del aire para una ubicación específica, con hasta 96 horas (4 días) de anticipación.
Funciones de la API de Air Quality
- Índices y categorías de calidad del aire en tiempo real: La API de Air Quality calcula continuamente el valor de varios índices de calidad del aire con una resolución de 500 m x 500 m.
- Recomendaciones de salud: Cientos de recomendaciones de salud respaldadas por investigaciones para el público en general y grupos sensibles, como niños, adultos mayores, mujeres embarazadas, atletas y personas con asma o afecciones cardíacas.
- Detalles de los contaminantes: Información detallada sobre diferentes contaminantes, en la que se destacan el contaminante dominante, las concentraciones, las fuentes y los efectos
- Historial por hora: Historial de la calidad del aire de una ubicación específica para un período determinado. Cada respuesta puede incluir índices de calidad del aire por hora, datos sobre contaminantes y recomendaciones de salud durante un máximo de 720 horas (30 días).
- Mapas de calor: Los mapas de calor son una colección de índices de CA y mosaicos de imágenes de contaminantes que se pueden mostrar sobre un mapa de Google Maps.
Si tu dirección de facturación se encuentra en el Espacio Económico Europeo (EEE), puedes mostrar mapas de calor sobre cualquier mapa.
Obtén más información.
- Pronóstico por hora: Condiciones futuras de la calidad del aire para una ubicación específica y para un período determinado o una hora en particular en el futuro, hasta 96 horas (4 días). Cada respuesta puede incluir índices de pronóstico de la calidad del aire por hora, datos sobre contaminantes y recomendaciones prácticas.
Cómo funciona la API de Air Quality
La API de Air Quality tiene los siguientes métodos:
currentConditions: El extremo currentConditions proporciona información actual por hora sobre la calidad del aire.
history: El extremo history proporciona información histórica por hora sobre la calidad del aire para una ubicación específica, durante un período determinado, hasta un máximo de 30 días.
heatmapTiles: El extremo heatmapTiles proporciona mapas de calor relacionados con la calidad del aire a través de una superposición de mosaicos.
forecast: El extremo forecast proporciona información futura por hora sobre la calidad del aire para una ubicación específica, durante un período determinado, hasta un máximo de 96 horas (4 días).
Cobertura de países y regiones de la API de Air Quality
Consulta Países admitidos por la API de Air Quality y los ICA disponibles para obtener los detalles de cobertura más recientes, país por país, para los que se encuentra disponible la información sobre la calidad del aire (ICA) y la información local sobre la calidad del aire (LAQI).
Cómo usar la API de Air Quality
| 1 |
Inicia la configuración |
Comienza con Configura tu
proyecto de Google Cloud
y completa las
instrucciones que se indican a continuación. |
| 2 |
Obtén información actual sobre la calidad del aire por hora |
Consulta las condiciones actuales. |
| 3 |
Obtener el historial de la calidad del aire por hora |
Consulta Historial. |
| 4 |
Obtén mapas de calor relacionados con la calidad del aire a través de una superposición de mosaicos |
Consulta Mapas de calor. |
| 5 |
Cómo obtener información sobre el pronóstico de la calidad del aire por hora |
Consulta Previsión. |
¿Qué sigue?
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-08-31 (UTC)
[null,null,["Última actualización: 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)"]]
