Ringkasan Air Quality API
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Air Quality API memungkinkan Anda meminta data kualitas udara untuk lokasi tertentu, termasuk lebih dari 70 indeks kualitas udara (AQI), polutan, dan rekomendasi kesehatan. Model ini mencakup lebih dari 100 negara dengan resolusi 500 x 500 meter.
Alasan menggunakan Air Quality API
API ini menyediakan endpoint yang memungkinkan Anda mengkueri:
- Kondisi Saat Ini: Informasi kualitas udara per jam secara real-time.
- Histori Per Jam: Histori kualitas udara untuk lokasi tertentu, untuk rentang waktu tertentu, hingga maksimum 30 hari.
- Peta panas: Petak berkode warna dari berbagai indeks dan polutan.
- Prakiraan Per Jam: Kondisi kualitas udara di masa mendatang untuk lokasi tertentu, hingga 96 jam (4 hari).
Fitur Air Quality API
- Indeks dan kategori kualitas udara real-time: Air Quality API terus menghitung nilai berbagai indeks kualitas udara dengan resolusi 500 x 500 meter.
- Rekomendasi kesehatan: Ratusan rekomendasi kesehatan yang didukung riset untuk masyarakat umum dan kelompok rentan, termasuk:
anak-anak, lansia, wanita hamil, atlet, dan orang-orang dengan kondisi asma atau jantung.
- Detail polutan: Informasi mendalam tentang berbagai polutan, yang menyoroti polutan dominan, konsentrasi, sumber, dan efeknya.
- Histori per jam: Histori kualitas udara untuk lokasi tertentu dalam rentang waktu tertentu. Setiap respons berpotensi mencakup indeks kualitas udara per jam, data polutan, dan rekomendasi kesehatan untuk maksimum 720 jam (30 hari).
- Peta panas: Peta panas adalah kumpulan ubin gambar indeks dan polutan AQ yang dapat ditampilkan di atas Google Maps.
Jika alamat penagihan Anda berada di Wilayah Ekonomi Eropa (EEA), Anda dapat menampilkan peta panas di atas peta apa pun.
Pelajari lebih lanjut.
- Prakiraan per jam: Kondisi kualitas udara di masa mendatang untuk lokasi tertentu, dan untuk rentang waktu tertentu atau untuk jam tertentu di masa mendatang, hingga 96 jam (4 hari). Setiap respons berpotensi mencakup indeks perkiraan kualitas udara per jam, data polutan, dan rekomendasi yang dapat ditindaklanjuti.
Cara kerja Air Quality API
Air Quality API memiliki metode berikut:
currentConditions: Endpoint
currentConditions memberikan informasi kualitas udara per jam saat ini.
history: Endpoint
history memberikan
informasi kualitas udara per jam historis untuk lokasi tertentu, untuk
rentang waktu tertentu, hingga maksimum 30 hari.
heatmapTiles: Endpoint heatmapTiles
menyediakan peta panas terkait kualitas udara melalui overlay ubin.
forecast: Endpoint forecast
memberikan informasi kualitas udara pada masa mendatang per jam untuk lokasi tertentu, untuk rentang waktu tertentu, hingga maksimum 96 jam (4 hari).
Cakupan negara dan wilayah Air Quality API
Lihat Negara yang didukung Air Quality API dan AQI yang tersedia untuk mengetahui detail cakupan terbaru, berdasarkan setiap negara, yang menyediakan informasi kualitas udara (AQI) dan informasi kualitas udara lokal (LAQI).
Cara menggunakan Air Quality API
| 1 |
Mulai penyiapan |
Mulai dengan Menyiapkan
project Google Cloud
dan selesaikan
petunjuk berikutnya. |
| 2 |
Mendapatkan informasi kualitas udara per jam saat ini |
Lihat Kondisi saat ini. |
| 3 |
Mendapatkan histori kualitas udara per jam |
Lihat Histori. |
| 4 |
Mendapatkan peta panas terkait kualitas udara melalui overlay petak |
Lihat Peta panas. |
| 5 |
Mendapatkan informasi prakiraan kualitas udara per jam |
Lihat Perkiraan. |
Langkah berikutnya
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-31 UTC.
[null,null,["Terakhir diperbarui pada 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)"]]
