Omówienie interfejsu Air Quality API
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Interfejs Air Quality API umożliwia wysyłanie zapytań o dane dotyczące jakości powietrza w określonej lokalizacji, w tym o ponad 70 indeksów jakości powietrza (AQI), zanieczyszczenia i zalecenia dotyczące zdrowia. Obejmuje ponad 100 krajów i ma rozdzielczość 500 x 500 metrów.
Dlaczego warto korzystać z interfejsu Air Quality API
Interfejs API udostępnia punkty końcowe, które umożliwiają wysyłanie zapytań o:
- Aktualne warunki: informacje o jakości powietrza aktualizowane co godzinę w czasie rzeczywistym.
- Historia godzinowa: historia jakości powietrza w określonej lokalizacji w danym zakresie czasu (maksymalnie 30 dni).
- Mapy cieplne: kolorowe kafelki z różnymi indeksami i zanieczyszczeniami.
- Prognoza godzinowa: przyszłe warunki jakości powietrza w określonej lokalizacji, do 96 godzin (4 dni).
Funkcje interfejsu Air Quality API
- Indeksy i kategorie jakości powietrza w czasie rzeczywistym: interfejs Air Quality API stale oblicza wartość różnych indeksów jakości powietrza w rozdzielczości 500 x 500 m.
- Rekomendacje dotyczące zdrowia: setki opartych na badaniach rekomendacji dotyczących zdrowia dla ogółu społeczeństwa i grup wrażliwych, w tym: dzieci, osób starszych, kobiet w ciąży, sportowców oraz osób z astmą lub chorobami serca.
- Szczegóły dotyczące zanieczyszczeń: szczegółowe informacje o różnych zanieczyszczeniach, z wyróżnieniem dominującego zanieczyszczenia, stężeń, źródeł i skutków.
- Historia godzinowa: historia jakości powietrza w określonej lokalizacji w danym przedziale czasu. Każda odpowiedź może zawierać godzinowe indeksy jakości powietrza, dane o zanieczyszczeniach i zalecenia dotyczące zdrowia na maksymalnie 720 godzin (30 dni).
- Mapy cieplne: mapy cieplne to zbiór indeksów jakości powietrza i obrazów zanieczyszczeń, które można wyświetlać na mapie Google.
Jeśli Twój adres rozliczeniowy znajduje się w Europejskim Obszarze Gospodarczym, możesz wyświetlać mapy cieplne na dowolnej mapie.
Więcej informacji
- Prognoza godzinowa: przyszłe warunki jakości powietrza w określonej lokalizacji w danym przedziale czasu lub w konkretnej godzinie w przyszłości (do 96 godzin, czyli 4 dni). Każda odpowiedź może zawierać godzinowe indeksy prognozy jakości powietrza, dane o zanieczyszczeniach i praktyczne zalecenia.
Jak działa interfejs Air Quality API
Interfejs Air Quality API ma te metody:
currentConditions: punkt końcowy
currentConditions udostępnia aktualne godzinowe informacje o jakości powietrza.
history: punkt końcowy
history udostępnia historyczne godzinowe informacje o jakości powietrza w określonej lokalizacji w danym przedziale czasu (maksymalnie 30 dni).
heatmapTiles: punkt końcowy heatmapTiles udostępnia mapy cieplne związane z jakością powietrza w postaci nakładki kafelkowej.
forecast: punkt końcowy forecast
udostępnia godzinowe informacje o jakości powietrza w przyszłości w określonej lokalizacji w danym przedziale czasu (maksymalnie 96 godzin, czyli 4 dni).
Zasięg interfejsu Air Quality API w poszczególnych krajach i regionach
Najnowsze informacje o zasięgu, w tym o tym, w których krajach dostępne są informacje o jakości powietrza (AQI) i lokalne informacje o jakości powietrza (LAQI), znajdziesz w artykule Kraje obsługiwane przez interfejs Air Quality API i dostępne indeksy AQI.
Jak korzystać z interfejsu Air Quality API
| 1 |
Konfiguracja |
Zacznij od sekcji Konfigurowanie projektu Google Cloud i wykonaj podane tam instrukcje. |
| 2 |
Sprawdzanie aktualnych godzinowych informacji o jakości powietrza |
Zobacz bieżące warunki. |
| 3 |
Sprawdzanie godzinowej historii jakości powietrza |
Zobacz Historię. |
| 4 |
Uzyskiwanie map cieplnych związanych z jakością powietrza za pomocą nakładki na kafelki |
Zobacz mapy termiczne. |
| 5 |
Otrzymywanie godzinowych prognoz jakości powietrza |
Zobacz Prognoza. |
Co dalej?
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-31 UTC.
[null,null,["Ostatnia aktualizacja: 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)"]]
