סקירה כללית על Air Quality API
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
ה-API של איכות האוויר מאפשר לכם לבקש נתונים על איכות האוויר במיקום ספציפי, כולל יותר מ-70 מדדי איכות אוויר (AQI), מזהמים והמלצות בריאותיות. הוא מכסה יותר מ-100 מדינות ברזולוציה של 500 מטר על 500 מטר.
למה כדאי להשתמש ב-Air Quality API
ה-API מספק נקודות קצה שמאפשרות לשלוח שאילתות לגבי:
- תנאים נוכחיים: מידע על איכות האוויר בזמן אמת, לפי שעה.
- היסטוריה לפי שעה: היסטוריה של איכות האוויר במיקום ספציפי, בטווח זמן נתון, עד 30 ימים.
- מפות חום: משבצות עם קוד צבע של מדדים ומזהמים שונים.
- תחזית לפי שעה: תנאי איכות האוויר העתידיים במיקום ספציפי, עד 96 שעות (4 ימים).
תכונות של Air Quality API
- מדדים וקטגוריות של איכות האוויר בזמן אמת: Air Quality API מחשב באופן רציף את הערך של מדדים שונים של איכות האוויר ברזולוציה של 500x500 מטרים.
- המלצות בריאותיות: מאות המלצות בריאותיות שמגובות במחקרים לציבור הרחב ולקבוצות רגישות, כולל: ילדים, קשישים, נשים בהיריון, ספורטאים ואנשים שסובלים מאסתמה או מבעיות לב.
- פרטים על חומרים מזהמים: מידע מפורט על חומרים מזהמים שונים, עם דגש על החומר המזהם הדומיננטי, הריכוזים, המקורות וההשפעות.
- היסטוריה לפי שעה: היסטוריה של איכות האוויר במיקום ספציפי בטווח זמן מסוים. כל תשובה עשויה לכלול מדדים של איכות האוויר לפי שעה,
נתונים על מזהמים והמלצות בריאותיות למשך 720 שעות (30 ימים) לכל היותר.
- מפות חום: מפות חום הן אוסף של אינדקסים של איכות האוויר ומשבצות תמונה של מזהמים שאפשר להציג מעל מפת Google.
אם הכתובת שלכם לחיוב נמצאת באזור הכלכלי האירופי (EEA), אתם יכולים להציג מפות חום על כל מפה.
מידע נוסף
- תחזית לפי שעה: תנאי איכות האוויר העתידיים במיקום ספציפי, וטווח זמן נתון או שעה מסוימת בעתיד, עד 96 שעות (4 ימים). כל תגובה עשויה לכלול מדדים של תחזית איכות האוויר לפי שעה, נתוני מזהמים והמלצות פרקטיות.
איך Air Quality API פועל
ל-Air Quality API יש את השיטות הבאות:
currentConditions: נקודת הקצה currentConditions מספקת מידע על איכות האוויר לפי שעה.
history: נקודת הקצה history מספקת מידע היסטורי על איכות האוויר לפי שעה במיקום ספציפי, בטווח זמן נתון, עד 30 ימים לכל היותר.
heatmapTiles: נקודת הקצה heatmapTiles מספקת מפות חום שקשורות לאיכות האוויר באמצעות שכבת-על של משבצות.
forecast: נקודת הקצה forecast מספקת מידע על איכות האוויר בעתיד לפי שעה במיקום ספציפי, בטווח זמן נתון, עד למקסימום של 96 שעות (4 ימים).
היקף הכיסוי של Air Quality API לפי מדינה ואזור
במאמר מדינות נתמכות ב-Air Quality API ומדדי איכות אוויר (AQI) זמינים מפורטים פרטי הכיסוי העדכניים, לפי מדינה, שבהם זמין מידע על איכות האוויר (AQI) ומידע מקומי על איכות האוויר (LAQI).
איך משתמשים ב-Air Quality API
| 1 |
הגדרה |
מתחילים עם הגדרת פרויקט ב-Google Cloud ופועלים לפי ההוראות שבהמשך. |
| 2 |
איך מקבלים מידע עדכני על איכות האוויר לפי שעה |
תנאים נוכחיים |
| 3 |
קבלת היסטוריה של איכות האוויר לפי שעה |
מידע נוסף זמין במאמר בנושא היסטוריה. |
| 4 |
קבלת מפות חום שקשורות לאיכות האוויר באמצעות שכבת-על של משבצת |
מפות צפיפות |
| 5 |
איך מקבלים תחזית שעתית של איכות האוויר |
תחזית |
המאמרים הבאים
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-31 (שעון UTC).
[null,null,["עדכון אחרון: 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)"]]
