نظرة عامة على Contrails API

استكشِف ما يمكنك إنشاؤه باستخدام Contrails API وتعرَّف على طريقة عمل نقاط النهاية.

نظرة عامة

تجمع واجهة Contrails API بين بيانات الطقس على نطاق واسع وبيانات الرحلات الجوية وصور الأقمار الصناعية، بالإضافة إلى نموذج متطوّر للرؤية الآلية، وذلك لإنتاج توقّعات حول آثار التكاثف مستندة إلى الذكاء الاصطناعي. تتوقّع هذه التنبؤات المناطق المحتملة لتشكّل مسارات التكاثف والتأثير المحتمل لهذه المسارات خلال الـ 48 ساعة القادمة.

يمكن أن يساعد دمج هذه التوقعات في سير عمل تخطيط الرحلات الجوية الطيارين على تجنُّب التحليق فوق هذه المناطق، ما يمنع تكوّن آثار تكثّف مساهمة في الاحترار.

لفهم هذه الإحصاءات حول أماكن تكوُّن آثار التكاثف ومدى تأثيرها في الاحترار، يقدّم Contrails API توقعات على شكل شبكات ومناطق.

التوقعات

تقدّم واجهة برمجة التطبيقات Contrails توقعات على النحو التالي:

  • الشبكات: بيانات رباعية الأبعاد عالية الدقة تمثّل قيم مؤشر تأثير الطائرات النفاثة على محاور خط العرض وخط الطول والارتفاع والوقت، بتنسيق NetCDF تمثّل هذه الشبكات الكرة الأرضية بأكملها كشبكة ربع درجة، حيث تبلغ خطوات خطوط الطول والعرض 0.25 درجة. يتم توقّع كل شبكة لمدة ساعة كاملة (بتوقيت غرينتش).

    تتراوح قيم مؤشر تأثير التكاثف بين 0، ما يمثّل موقعًا جغرافيًا لا يشهد ارتفاعًا كبيرًا في درجة الحرارة، و4، ما يمثّل موقعًا جغرافيًا يشهد ارتفاعًا حادًا في درجة الحرارة بسبب التكاثف.

    ننصح باستخدام الشبكات في التخطيط الآلي للرحلات الجوية، خاصةً لإعادة توجيه الرحلات.

  • المناطق: نسخة مبسطة ومضلّعة من التوقعات، تمثّل مناطق تجنُّب تشكّل السحب المتكاثفة بتنسيق GeoJSON متعدد الأضلاع.

    يتم تقييم مناطق تجنُّب آثار الطائرات بمستويات الخطورة نفسها، ولكن بدون المستوى 0، أي تبدأ من المستوى 1 (تأثير خفيف).

    يُنصح باستخدام المناطق لمخطّطي الرحلات الجوية الذين يمكنهم وضع سياسات استنادًا إلى مستويات الخطورة ويمكنهم إعادة توجيه الرحلات الجوية يدويًا، عادةً من خلال الانحرافات العمودية (أي عن طريق تعديل مستويات الرحلات الجوية).

    تصوّر "مستكشف مسارات التكاثف" للمناطق المتوقّعة في أجزاء من أوروبا، مع منطقة تجنُّب مسارات التكاثف المحدّدة التي يبلغ فيها الحد الأقصى لارتفاع الطيران 340 والحد الأدنى 310

المصادقة

لاستخدام Contrails API، يجب توفّر مفتاح واجهة برمجة تطبيقات وتفعيل Contrails API.

للاطّلاع على التفاصيل، اتّبِع دليل إعداد بيئتك.

الأخطاء

عند استخدام Contrails API، قد تواجه الأخطاء التالية:

الرمز السبب معالجة الأخطاء
‫400 (طلبات غير صالحة) طلب يتضمّن بيانات غير صحيحة عدم إعادة المحاولة تلقائيًا يحدث هذا الخطأ بسبب مشاكل في الرمز البرمجي، لذا تأكَّد من أنّك تستخدم تنسيق المَعلمات الصحيح.
404 طلب وقت توقّع لم يتم احتسابه بعد أعِد المحاولة باستخدام استراتيجية الرقود الأسي الثنائي.
429 عدد الطلبات كبير جدًا (يُرجى الرجوع إلى حدود الاستخدام) أعِد المحاولة باستخدام خوارزمية الرقود الأسي الثنائي.
5XX خطأ في الخادم أعِد المحاولة باستخدام خوارزمية الرقود الأسي الثنائي.

تحديد الإصدار

يمكن أن تؤدي إصدارات الإصدار الرئيسي، مثل إطلاق v2، إلى حدوث سلوك غير متوافق مع الإصدارات السابقة، وقد تتطلّب تغييرات في الرمز.

من المتوقّع أن تكون التحديثات المنتظمة بين إصدارات الإصدارات الرئيسية متوافقة مع الإصدارات السابقة.

يمكنك الاطّلاع على التحديثات الرئيسية في ملاحظات إصدار Contrails API.

الخطوات التالية