نمای کلی API کیفیت هوا
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Air Quality API به شما امکان می دهد داده های کیفیت هوا را برای یک مکان خاص درخواست کنید، از جمله بیش از 70 شاخص کیفیت هوا (AQI)، آلاینده ها و توصیه های بهداشتی. بیش از 100 کشور را با وضوح 500 در 500 متر پوشش می دهد.
چرا از Air Quality API استفاده کنید
API نقاط پایانی را ارائه می دهد که به شما امکان می دهد پرس و جو کنید:
- شرایط فعلی: اطلاعات ساعتی کیفیت هوا در زمان واقعی.
- تاریخچه ساعتی: تاریخچه کیفیت هوا برای یک مکان خاص، برای یک محدوده زمانی معین، حداکثر تا 30 روز.
- نقشه های حرارتی: کاشی های کدگذاری شده رنگی از شاخص ها و آلاینده های مختلف.
- پیش بینی ساعتی: شرایط کیفیت هوای آینده برای یک مکان خاص، تا 96 ساعت (4 روز).
ویژگی های Air Quality API
- شاخص ها و دسته بندی های کیفیت هوا در زمان واقعی: API کیفیت هوا به طور مداوم مقدار شاخص های مختلف کیفیت هوا را با وضوح 500×500 متر محاسبه می کند.
- توصیه های بهداشتی: صدها توصیه بهداشتی مبتنی بر تحقیقات برای عموم مردم و گروه های حساس از جمله: کودکان، سالمندان، زنان باردار، ورزشکاران و مبتلایان به آسم یا بیماری های قلبی.
- جزئیات آلاینده: اطلاعات عمیق در مورد آلاینده های مختلف، برجسته کردن آلاینده غالب، غلظت ها، منابع و اثرات.
- تاریخچه ساعتی: تاریخچه کیفیت هوا برای یک مکان خاص برای یک محدوده زمانی معین. هر پاسخ به طور بالقوه شامل شاخص های ساعتی کیفیت هوا، داده های آلاینده و توصیه های بهداشتی برای حداکثر 720 ساعت (30 روز) است.
- نقشه های حرارتی: نقشه های حرارتی مجموعه ای از نمایه های AQ و کاشی های تصویر آلاینده ها هستند که می توانند در بالای نقشه گوگل نمایش داده شوند. اگر آدرس صورت‌حساب شما در منطقه اقتصادی اروپا (EEA) است، می‌توانید نقشه‌های حرارتی را در بالای هر نقشه نشان دهید. بیشتر بدانید .
- پیش‌بینی ساعتی: شرایط کیفیت هوای آینده برای یک مکان خاص، و برای یک محدوده زمانی معین یا برای یک ساعت خاص در آینده، تا 96 ساعت (4 روز). هر پاسخ به طور بالقوه شامل شاخص های پیش بینی ساعتی کیفیت هوا، داده های آلاینده و توصیه های عملی است.
چگونه API کیفیت هوا کار می کند
Air Quality API روش های زیر را دارد:
currentConditions : نقطه پایانی currentConditions اطلاعات ساعتی فعلی کیفیت هوا را ارائه می دهد.
تاریخچه : نقطه پایانی history اطلاعات ساعتی کیفیت هوا را برای یک مکان خاص، برای یک محدوده زمانی معین، حداکثر تا 30 روز ارائه می دهد.
HeatmapTiles : نقطه پایانی heatmapTiles نقشه های حرارتی مربوط به کیفیت هوا را از طریق پوشش کاشی ارائه می دهد.
پیش‌بینی : نقطه پایانی forecast اطلاعات ساعتی کیفیت هوای آینده را برای یک مکان خاص، برای یک محدوده زمانی معین، حداکثر تا 96 ساعت (4 روز) ارائه می‌کند.
API کیفیت هوا پوشش کشور و منطقه
برای اطلاع از آخرین جزئیات پوشش، بر اساس کشور به کشور، کشورهای پشتیبانی‌شده از Air Quality API و AQIهای موجود را ببینید، که اطلاعات کیفیت هوا (AQI) و اطلاعات محلی کیفیت هوا (LAQI) در دسترس است.
نحوه استفاده از Air Quality API
بعدش چی
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\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)"]]
