تتيح لك واجهة برمجة تطبيقات جودة الهواء طلب بيانات عن جودة الهواء في موقع جغرافي معيّن، بما في ذلك أكثر من 70 مؤشرًا لجودة الهواء (AQI) وملوّثات وتوصيات صحية. فهو يغطي أكثر من 100 بلد بدقة 500 × 500 متر.
أسباب استخدام واجهة برمجة التطبيقات Air Quality API
توفّر واجهة برمجة التطبيقات نقاط نهاية تتيح لك طلب البحث عن:
- الظروف الحالية: معلومات عن جودة الهواء في الوقت الفعلي كل ساعة.
- السجلّ بالساعة: يعرض سجلّ جودة الهواء لموقع جغرافي محدّد، وخلال نطاق زمني محدّد، على مدى 30 يومًا كحدّ أقصى.
- خرائط التمثيل اللوني: المربّعات المرمّزة بالألوان للمؤشرات والملوّثات المختلفة
- توقّعات الطقس كل ساعة: أحوال جودة الهواء المستقبلية في موقع جغرافي معيّن، لما يصل إلى 96 ساعة (4 أيام)
ميزات واجهة برمجة التطبيقات Air Quality API
- مؤشرات جودة الهواء وفئاتها في الوقت الفعلي: تحتسب واجهة برمجة تطبيقات جودة الهواء باستمرار قيمة مؤشرات جودة الهواء المختلفة بدقة 500 × 500 متر.
- التوصيات الصحية: مئات النصائح الصحية المستندة إلى أبحاث والمُوجَّهة إلى الجمهور العام والمجموعات التي تواجه حساسية، بما في ذلك: الأطفال وكبار السن والنساء الحوامل والرياضيات وأولئك الذين يعانون من مشاكل في القلب أو الربو.
- تفاصيل الملوّثات: تشمل هذه التفاصيل معلومات مفصّلة حول الملوّثات المختلفة وتسليط الضوء على الملوّثات السائدة وتركيزاتها ومصادرها وتأثيراتها.
- السجلّ بالساعة: يعرض سجلّ جودة الهواء لموقع جغرافي محدّد خلال نطاق زمني محدّد. من المحتمل أن تتضمّن كل استجابة مؤشرات جودة الهواء كل ساعة وبيانات ملوّثة واقتراحات بشأن الصحة لمدة لا تزيد عن 720 ساعة (30 يومًا).
- خرائط التمثيل اللوني: هي مجموعة من فهارس AQ ومربّعات صور الملوّثات التي يمكن عرضها في أعلى إحدى "خرائط Google".
- توقّعات الطقس كل ساعة: أحوال جودة الهواء المستقبلية في موقع جغرافي معيّن، ولنطاق زمني محدّد أو لساعة معيّنة في المستقبل، بما يصل إلى 96 ساعة (4 أيام). من المحتمل أن تتضمن كل استجابة مؤشرات توقّعات جودة الهواء كل ساعة وبيانات ملوّثات واقتراحات قابلة للتنفيذ.
طريقة عمل Air Quality API
تتوفّر في واجهة برمجة التطبيقات Air Quality API الطرق التالية:
currentConditions: توفّر نقطة نهاية
currentConditionsمعلومات حول جودة الهواء كل ساعة.السجلّ: توفّر نقطة نهاية
historyمعلومات تاريخية عن جودة الهواء كل ساعة لموقع جغرافي محدَّد، لنطاق زمني محدّد يصل إلى 30 يومًا كحدّ أقصى.heatmapTiles: توفّر نقطة نهاية
heatmapTilesخرائط التمثيل اللوني المتعلّقة بجودة الهواء من خلال عرض مربّع على سطح الفيديو.التوقّعات: توفّر نقطة نهاية
forecastمعلومات عن جودة الهواء المستقبلية كل ساعة في موقع جغرافي معيّن وخلال نطاق زمني محدّد، على أن يصل إلى 96 ساعة (4 أيام) كحدّ أقصى.
تغطية البلدان والمناطق التي تتوفر في واجهة برمجة التطبيقات Air Quality API
يمكنك الاطّلاع على البلدان التي تتوفّر فيها واجهة Air Quality API ومؤشرات جودة الهواء المتوفّرة للاطّلاع على أحدث تفاصيل التغطية، حسب كل بلد على حدة، حيث تتوفّر معلومات عن جودة الهواء (AQI) ومعلومات جودة الهواء المحلية (LAQI).
كيفية استخدام واجهة برمجة التطبيقات Air Quality API
| 1 | بدء الإعداد | ابدأ بعنوان إعداد مشروعك على Google Cloud وأكمِل التعليمات الواردة أدناه. |
| 2 | الحصول على معلومات عن جودة الهواء كل ساعة | يمكنك الاطّلاع على الشروط الحالية. |
| 3 | الاطّلاع على سجلّ جودة الهواء كل ساعة | يمكنك الاطّلاع على السجلّ. |
| 4 | الحصول على خرائط التمثيل اللوني ذات الصلة بجودة الهواء من خلال عرض مربّعات على سطح الصفحة | يمكنك الاطّلاع على خرائط التمثيل اللوني. |
| 5 | الحصول على معلومات عن توقّعات جودة الهواء كل ساعة | الاطّلاع على توقّعات الطقس |