Air Quality API'ye genel bakış
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Hava Kalitesi API'si, 70'ten fazla hava kalitesi indeksi (HKİ), kirletici madde ve sağlık önerisi dahil olmak üzere belirli bir konumun hava kalitesi verilerini istemenize olanak tanır. 500 x 500 metre çözünürlükle 100'den fazla ülkeyi kapsar.
Air Quality API'yi neden kullanmalısınız?
API, aşağıdakileri sorgulamanıza olanak tanıyan uç noktalar sağlar:
- Mevcut koşullar: Saatlik hava kalitesi bilgileri.
- Saatlik Geçmiş: Belirli bir konumun, belirli bir zaman aralığındaki hava kalitesi geçmişi (en fazla 30 gün).
- Isı haritaları: Çeşitli endeksler ve kirletici maddeler için renk kodlu kutular.
- Saatlik Hava Durumu Tahmini: Belirli bir konumdaki gelecekteki hava kalitesi koşulları (96 saate veya 4 güne kadar).
Air Quality API'nin özellikleri
- Gerçek zamanlı hava kalitesi indeksleri ve kategorileri: Hava Kalitesi API'si, 500 x 500 metre çözünürlükle çeşitli hava kalitesi indekslerinin değerini sürekli olarak hesaplar.
- Sağlık önerileri: Genel kitle ve hassas gruplar (çocuklar, yaşlılar, hamile kadınlar, sporcular, astım veya kalp rahatsızlığı olanlar) için araştırmalara dayalı yüzlerce sağlık önerisi.
- Kirliliğe yol açan maddelerle ilgili ayrıntılar: Farklı kirliliğe yol açan maddeler hakkında ayrıntılı bilgi. Baskın kirliliğe yol açan madde, konsantrasyonlar, kaynaklar ve etkiler vurgulanır.
- Saatlik geçmiş: Belirli bir konumun belirli bir zaman aralığındaki hava kalitesi geçmişi. Her yanıtta en fazla 720 saat (30 gün) boyunca saatlik hava kalitesi indeksleri, kirletici verileri ve sağlık önerileri yer alabilir.
- Isı haritaları: Isı haritaları, Google Haritası'nın üzerinde gösterilebilen hava kalitesi indeksleri ve kirletici madde görüntü döşemelerinden oluşan bir koleksiyondur.
Fatura adresiniz Avrupa Ekonomik Alanı'ndaysa (AEA) herhangi bir haritanın üzerinde ısı haritaları gösterebilirsiniz.
Daha fazla bilgi edinin.
- Saatlik tahmin: Belirli bir konumdaki ve belirli bir zaman aralığındaki veya gelecekteki belirli bir saatteki hava kalitesi koşulları (96 saate kadar, yani 4 gün). Her yanıtta saatlik hava kalitesi tahmin indeksleri, kirletici verileri ve uygulanabilir öneriler yer alabilir.
Air Quality API'nin işleyiş şekli
Air Quality API'de aşağıdaki yöntemler bulunur:
currentConditions: currentConditions uç noktası, saatlik güncel hava kalitesi bilgilerini sağlar.
history: history uç noktası, belirli bir konum için belirli bir zaman aralığında (en fazla 30 gün) saatlik hava kalitesi bilgilerini sağlar.
heatmapTiles: heatmapTiles uç noktası, döşeme yerleşimi aracılığıyla hava kalitesiyle ilgili ısı haritaları sağlar.
forecast: forecast
uç noktası, belirli bir konum için belirli bir zaman aralığında en fazla 96 saat (4 gün) boyunca saatlik gelecekteki hava kalitesi bilgilerini sağlar.
Air Quality API'nin ülke ve bölge kapsamı
Hava kalitesi bilgileri (HKİ) ve yerel hava kalitesi bilgileri (YHKİ) için ülke bazında en son kapsam ayrıntılarını öğrenmek üzere Hava Kalitesi API'sinin desteklendiği ülkeler ve kullanılabilen HKİ'ler başlıklı makaleyi inceleyin.
Hava Kalitesi API'sini kullanma
| 1 |
Kurulum |
Google Cloud projenizi ayarlayarak başlayın ve sonraki talimatları uygulayın. |
| 2 |
Saatlik güncel hava kalitesi bilgilerini alma |
Güncel koşullar'ı inceleyin. |
| 3 |
Saatlik hava kalitesi geçmişini alma |
Geçmiş başlıklı makaleyi inceleyin. |
| 4 |
Döşeme katmanı aracılığıyla hava kalitesiyle ilgili ısı haritaları alma |
Isı haritaları başlıklı makaleyi inceleyin. |
| 5 |
Saatlik hava kalitesi tahmini bilgilerini alma |
Tahmin başlıklı makaleyi inceleyin. |
Sırada ne var?
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-31 UTC.
[null,null,["Son güncelleme tarihi: 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)"]]
