Air Quality API – Übersicht
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Mit der Air Quality API können Sie Daten zur Luftqualität für einen bestimmten Ort anfordern, darunter über 70 Luftqualitätsindizes (LQIs), Schadstoffe und Gesundheitsempfehlungen. Sie deckt über 100 Länder mit einer Auflösung von 500 × 500 Metern ab.
Gründe für die Verwendung der Air Quality API
Die API bietet Endpunkte, mit denen Sie Folgendes abfragen können:
- Aktuelle Bedingungen:Stündliche Echtzeitinformationen zur Luftqualität.
- Stündlicher Verlauf:Verlauf der Luftqualität für einen bestimmten Standort für einen bestimmten Zeitraum von maximal 30 Tagen.
- Heatmaps:Farbcodierte Kacheln mit verschiedenen Indexwerten und Schadstoffen.
- Stündliche Vorhersage:Die zukünftige Luftqualität für einen bestimmten Ort für bis zu 96 Stunden (4 Tage).
Funktionen der Air Quality API
- Luftqualitätsindexe und ‑kategorien in Echtzeit:Die Air Quality API berechnet kontinuierlich den Wert verschiedener Luftqualitätsindexe mit einer Auflösung von 500 × 500 Metern.
- Gesundheitsempfehlungen: Hunderte von wissenschaftlich fundierten Gesundheitsempfehlungen für die breite Öffentlichkeit und vulnerable Gruppen, darunter Kinder, ältere Menschen, Schwangere, Sportler und Menschen mit Asthma oder Herzerkrankungen.
- Details zu Schadstoffen:Detaillierte Informationen zu verschiedenen Schadstoffen, einschließlich des vorherrschenden Schadstoffs, der Konzentrationen, Quellen und Auswirkungen.
- Stündlicher Verlauf:Verlauf der Luftqualität für einen bestimmten Ort in einem bestimmten Zeitraum. Jede Antwort kann stündliche Luftqualitätsindexe, Schadstoffdaten und Gesundheitsempfehlungen für maximal 720 Stunden (30 Tage) enthalten.
- Heatmaps:Heatmaps sind eine Sammlung von Bildkacheln mit Luftqualitätsindexen und Schadstoffen, die über einer Google-Karte angezeigt werden können.
Wenn sich Ihre Rechnungsadresse im Europäischen Wirtschaftsraum (EWR) befindet, können Sie Heatmaps auf jeder Karte einblenden.
Weitere Informationen
- Stündliche Vorhersage:Die zukünftige Luftqualität für einen bestimmten Ort und einen bestimmten Zeitraum oder für eine bestimmte Stunde in der Zukunft, bis zu 96 Stunden (4 Tage). Jede Antwort enthält möglicherweise stündliche Vorhersageindizes zur Luftqualität, Schadstoffdaten und umsetzbare Empfehlungen.
Funktionsweise der Air Quality API
Die Air Quality API hat die folgenden Methoden:
currentConditions: Der Endpunkt currentConditions bietet aktuelle stündliche Informationen zur Luftqualität.
history: Der Endpunkt history bietet stündliche Informationen zur Luftqualität für einen bestimmten Ort und einen bestimmten Zeitraum von maximal 30 Tagen.
heatmapTiles: Der Endpunkt heatmapTiles bietet Heatmaps zur Luftqualität über ein Kachel-Overlay.
forecast: Der Endpunkt forecast bietet stündliche Informationen zur Luftqualität für einen bestimmten Ort und einen bestimmten Zeitraum von bis zu 96 Stunden (4 Tage).
Air Quality API – Abdeckung nach Land und Region
Unterstützte Länder und verfügbare Luftqualitätsindizes (AQIs) für die Air Quality API finden Sie die aktuellen Details zur Abdeckung für die einzelnen Länder, für die Informationen zur Luftqualität (AQI) und lokale Informationen zur Luftqualität (LAQI) verfügbar sind.
Air Quality API verwenden
Nächste Schritte
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-31 (UTC).
[null,null,["Zuletzt aktualisiert: 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)"]]
