نظرة عامة على Air Quality API
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتيح لك Air Quality API طلب بيانات جودة الهواء لموقع جغرافي محدّد، بما في ذلك أكثر من 70 مؤشرًا لجودة الهواء (AQI) وملوّثات وتوصيات صحية. ويشمل أكثر من 100 بلد بدقة تبلغ 500 x 500 متر.
أسباب استخدام Air Quality API
توفّر واجهة برمجة التطبيقات نقاط نهاية تتيح لك طلب البحث عن:
- الظروف الحالية: معلومات عن جودة الهواء كل ساعة في الوقت الفعلي
- السجلّ كل ساعة: سجلّ جودة الهواء في موقع جغرافي معيّن، ضمن نطاق زمني محدّد، لمدة 30 يومًا كحد أقصى
- الخرائط الحرارية: مربّعات مرمّزة بالألوان لمختلف المؤشرات والملوّثات
- التوقّعات كل ساعة: أحوال جودة الهواء المستقبلية في موقع جغرافي محدّد،
لمدة تصل إلى 96 ساعة (4 أيام).
ميزات Air Quality API
- مؤشرات وفئات جودة الهواء في الوقت الفعلي: تحسب واجهة برمجة التطبيقات Air Quality API باستمرار قيمة مؤشرات جودة الهواء المختلفة بدقة 500 × 500 متر.
- اقتراحات صحية: مئات الاقتراحات الصحية المستندة إلى أبحاث والموجّهة إلى عامة الناس والفئات الحساسة، بما في ذلك الأطفال وكبار السن والنساء الحوامل والرياضيون والأشخاص الذين يعانون الربو أو أمراض القلب
- تفاصيل الملوّثات: معلومات مفصّلة حول الملوّثات المختلفة، مع إبراز الملوّث السائد ومستويات تركيزه ومصادره وتأثيراته
- السجلّ بالساعة: سجلّ جودة الهواء في موقع جغرافي محدّد خلال نطاق زمني معيّن يمكن أن يتضمّن كل رد مؤشرات جودة الهواء كل ساعة، وبيانات الملوّثات، واقتراحات صحية لمدة 720 ساعة (30 يومًا) كحد أقصى.
- خرائط الكثافة: خرائط الكثافة هي مجموعة من فهارس جودة الهواء ومربّعات صور الملوّثات التي يمكن عرضها أعلى خريطة Google.
إذا كان عنوان إرسال الفواتير يقع في المنطقة الاقتصادية الأوروبية، يمكنك عرض خرائط التمثيل اللوني فوق أي خريطة.
مزيد من المعلومات
- التوقعات كل ساعة: أحوال جودة الهواء المستقبلية في موقع جغرافي معيّن،
وذلك لنطاق زمني محدّد أو لساعة معيّنة في المستقبل، لمدة تصل إلى 96
ساعة (4 أيام). يمكن أن يتضمّن كل رد مؤشرات لتوقّعات جودة الهواء كل ساعة، وبيانات عن الملوّثات، وتوصيات قابلة للتنفيذ.
طريقة عمل Air Quality API
تتضمّن Air Quality API الطرق التالية:
currentConditions: تقدّم نقطة النهاية
currentConditions معلومات حالية عن جودة الهواء كل ساعة.
history: تقدّم نقطة النهاية
history معلومات تاريخية عن جودة الهواء كل ساعة لموقع جغرافي محدّد، وذلك
خلال نطاق زمني معيّن، لمدة 30 يومًا كحد أقصى.
heatmapTiles: تقدّم نقطة النهاية heatmapTiles خرائط حرارية ذات صلة بجودة الهواء من خلال تراكب مربّعات.
التوقّعات: يوفّر نقطة النهاية forecast معلومات مستقبلية عن جودة الهواء كل ساعة لموقع جغرافي محدّد، وذلك لنطاق زمني معيّن، ولمدة تصل إلى 96 ساعة (4 أيام) كحد أقصى.
البلدان والمناطق التي يغطيها Air Quality API
يمكنك الاطّلاع على البلدان التي تتوفّر فيها Air Quality API ومؤشرات جودة الهواء المتاحة للحصول على أحدث تفاصيل التغطية، وذلك على أساس كل بلد على حدة، والتي تتوفّر فيها معلومات جودة الهواء (AQI) ومعلومات جودة الهواء المحلية (LAQI).
كيفية استخدام Air Quality API
الخطوات التالية
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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)"]]
