POST AI agent ready /v1/air-quality/check

واجهة برمجة تطبيقات جودة الهواء - مؤشر جودة الهواء ومستويات الملوثات حسب الإحداثيات

إرجاع مؤشر جودة الهواء الحالي (كل من مقياس وكالة حماية البيئة الأمريكية والمقياس الأوروبي) وتركيزات الملوثات الفردية لخط عرض وخط طول معين. وتشمل الملوثات PM2.5، PM10، وأول أكسيد الكربون، وثاني أكسيد النيتروجين، وثاني أكسيد الكبريت، والأوزون.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/air-quality/check \
  -H "Content-Type: application/json" \
  -d '{"lat":40.7128,"lng":-74.006}'

When to use this API

توصيات لتطبيقات الصحة واللياقة البدنية

تحقق من جودة الهواء المحلي قبل التوصية بالأنشطة الخارجية. عندما يتجاوز مؤشر جودة الهواء (AQI) 100 (غير صحي للمجموعات الحساسة)، اقترح ممارسة التمارين الرياضية في الداخل بدلاً من الجري أو ركوب الدراجات في الهواء الطلق. اعرض شارة AQI المرمزة بالألوان في لوحة معلومات التطبيق.

إثراء قائمة العقارات والممتلكات

أضف نتائج جودة الهواء إلى قوائم العقارات. يمكن للمشترين الذين يبحثون عن منازل التصفية حسب متوسط مؤشر جودة الهواء (AQI)، ويمكن لصفحات القوائم عرض مستويات الملوثات الحالية إلى جانب بيانات الأحياء مثل المدارس ووسائل النقل.

لوحات مراقبة البيئة

أنشئ لوحة معلومات لجودة الهواء المباشر تستقصي نقطة النهاية هذه كل 30 دقيقة لمواقع متعددة. عرض الاتجاهات التاريخية، وتعيين تنبيهات الحد الأدنى لارتفاع PM2.5 أو الأوزون، وإنشاء تقارير يومية عن جودة الهواء لمديري المرافق.

Frequently asked questions

ما هو الفرق بين القاعدة الأمريكية والقاعدة الأوروبية؟

يتراوح مقياس AQI الخاص بوكالة حماية البيئة الأمريكية من 0 إلى 500 مع نقاط توقف عند 50 (جيد)، و100 (معتدل)، و150 (غير صحي للمجموعات الحساسة)، وأعلى. يستخدم مؤشر جودة الهواء (AQI) الأوروبي مقياسًا من 0 إلى 100+ مع ترجيح مختلف للملوثات. يتم إرجاع كلاهما حتى تتمكن من استخدام المقياس الذي يتوقعه جمهورك.

ما هي الوحدات التي توجد بها تركيزات الملوثات؟

PM2.5 وPM10 مُقاسة بالميكروجرام لكل متر مكعب (ميكروجرام/م3). أول أكسيد الكربون بوحدة ميكروجرام/م3. ثاني أكسيد النيتروجين، وثاني أكسيد الكبريت، والأوزون بوحدة ميكروجرام/م3. هذه هي وحدات قياس الغلاف الجوي القياسية.

كم مرة يتم تحديث بيانات جودة الهواء؟

يتم تحديث قراءات جودة الهواء كل ساعة من شبكات المراقبة الأولية. بالنسبة لمعظم حالات الاستخدام، يعد التخزين المؤقت لمدة 30-60 دقيقة أمرًا معقولًا.

هل يمكنني الحصول على بيانات جودة الهواء لاسم المدينة بدلاً من الإحداثيات؟

تتطلب نقطة النهاية هذه إحداثيات خطوط الطول والعرض. استخدم نقطة نهاية الرمز الجغرافي الجغرافي أولاً لتحويل اسم المدينة إلى إحداثيات، ثم قم بتمريرها إلى نقطة النهاية هذه.

ماذا يعني aqi_category؟

يُرجع حقل aqi_category تسمية يمكن قراءتها بواسطة الإنسان بناءً على معايير وكالة حماية البيئة الأمريكية AQI: "جيد" (0-50)، أو "معتدل" (51-100)، أو "غير صحي للمجموعات الحساسة" (101-150)، أو "غير صحي" (151-200)، أو "غير صحي جدًا" (201-300)، أو "خطر" (301+).

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.