Visão geral da API Air Quality
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Com a API Air Quality, é possível solicitar dados de qualidade do ar para um local específico, incluindo mais de 70 índices de qualidade do ar (IQA), poluentes e recomendações de saúde. Ele abrange mais de 100 países com uma resolução de 500 x 500 metros.
Por que usar a API Air Quality
A API fornece endpoints que permitem consultar:
- Condições atuais:informações sobre a qualidade do ar em tempo real a cada hora.
- Histórico por hora:histórico da qualidade do ar de um local específico em um determinado período, até um máximo de 30 dias.
- Mapas de calor:blocos codificados por cores de vários índices e poluentes.
- Previsão por hora:condições futuras da qualidade do ar para um local específico, até 96 horas (4 dias).
Recursos da API Air Quality
- Índices e categorias de qualidade do ar em tempo real:a API Air Quality calcula continuamente o valor de vários índices de qualidade do ar com resolução de 500 x 500 metros.
- Recomendações de saúde: centenas de recomendações de saúde baseadas em pesquisas para o público em geral e grupos sensíveis, incluindo crianças, idosos, mulheres grávidas, atletas e pessoas com asma ou problemas cardíacos.
- Detalhes do poluente:informações detalhadas sobre diferentes poluentes, destacando o poluente dominante, concentrações, fontes e efeitos.
- Histórico horário:histórico da qualidade do ar de um local específico em um determinado período. Cada resposta pode incluir índices de qualidade do ar por hora, dados de poluentes e recomendações de saúde por um máximo de 720 horas (30 dias).
- Mapas de calor:são uma coleção de índices de qualidade do ar e blocos de imagens de poluentes que podem ser mostrados na parte de cima de um mapa do Google.
Se o seu endereço de faturamento estiver no Espaço Econômico Europeu (EEE), você poderá mostrar mapas de calor em qualquer mapa.
Saiba mais.
- Previsão por hora:condições futuras da qualidade do ar para um local específico e para um determinado período ou uma hora específica no futuro, até 96 horas (4 dias). Cada resposta pode incluir índices de previsão da qualidade do ar por hora, dados de poluentes e recomendações práticas.
Como a API Air Quality funciona
A API Air Quality tem os seguintes métodos:
currentConditions: o endpoint
currentConditions
fornece informações atuais sobre a qualidade do ar por hora.
history: o endpoint
history fornece
informações históricas por hora sobre a qualidade do ar em um local específico, em um
intervalo de tempo determinado, até um máximo de 30 dias.
heatmapTiles: o endpoint heatmapTiles
fornece mapas de calor relacionados à qualidade do ar usando uma sobreposição de blocos.
previsão: o endpoint forecast
fornece informações futuras sobre a qualidade do ar por hora para um local
específico, em um determinado período, até um máximo de 96 horas (4 dias).
Cobertura por país e região da API Air Quality
Consulte Países compatíveis com a API Air Quality e IQAs disponíveis para conferir os detalhes mais recentes da cobertura, país por país, em que as informações sobre a qualidade do ar (IQA) e as informações locais sobre a qualidade do ar (LAQI) estão disponíveis.
Como usar a API Air Quality
| 1 |
Começar a configurar |
Comece com Configurar seu projeto do Google Cloud e siga as instruções abaixo. |
| 2 |
Receber informações atuais sobre a qualidade do ar por hora |
Consulte Condições atuais. |
| 3 |
Receber o histórico horário da qualidade do ar |
Consulte Histórico. |
| 4 |
Receber mapas de calor relacionados à qualidade do ar por uma sobreposição de blocos |
Consulte Mapas de calor. |
| 5 |
Receber informações de previsão da qualidade do ar por hora |
Consulte Previsão. |
A seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-31 UTC.
[null,null,["Última atualização 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)"]]
