بررسی کنید که با API Contrails چه چیزهایی میتوانید بسازید و بفهمید که نقاط پایانی آن چگونه رفتار میکنند.
نمای کلی
رابط برنامهنویسی کاربردی Contrails دادههای آب و هوایی در مقیاس بزرگ، دادههای پرواز و تصاویر ماهوارهای را با یک مدل بینایی رایانهای پیشرفته ترکیب میکند تا پیشبینیهای مربوط به ردپای هوایی مبتنی بر هوش مصنوعی را ارائه دهد. این پیشبینیها، مناطق احتمالی ردپای هوایی و تأثیر احتمالی آن را برای ۴۸ ساعت آینده پیشبینی میکنند.
ادغام این پیشبینیها در گردشهای کاری برنامهریزی پرواز میتواند به خلبانان کمک کند تا از پرواز در این مناطق اجتناب کنند و از ایجاد ردپای گرمکننده جلوگیری شود.
برای درک این بینشها در مورد محل تشکیل پسدمهها و میزان گرمایش آنها، رابط برنامهنویسی کاربردی (API) پسدمهها پیشبینیهایی را به صورت شبکهای و منطقهای ارائه میدهد.
پیشبینیها
رابط برنامهنویسی کاربردی Contrails پیشبینیها را به صورت زیر ارائه میدهد:
شبکهها: دادههای چهاربعدی با دقت بالا که مقادیر شاخص نیروی پسدمه را روی محورهای عرض جغرافیایی، طول جغرافیایی، ارتفاع و زمان، در قالب NetCDF نشان میدهند. این شبکهها کل کره زمین را به صورت یک شبکه ربع درجهای نشان میدهند که در آن گامهای عرض جغرافیایی و طول جغرافیایی 0.25 درجه است. هر شبکه برای یک ساعت کامل (UTC) پیشبینی میشود.
مقادیر شاخص نیروی پسدمه از ۰، که نشاندهنده مکانی بدون گرمایش قابل توجه است، تا ۴، که نشاندهنده مکانی با گرمایش شدید پسدمه است، متغیر است.
استفاده از شبکهها برای برنامهریزی پرواز برنامهریزیشده، بهویژه برای تغییر مسیر پروازها، توصیه میشود.
مناطق: نسخه سادهشده و چندضلعیشده پیشبینی، که مناطق اجتناب از ردپیله را در قالب چندچندضلعی GeoJSON نشان میدهد.
مناطق اجتناب از ردپیله با همان سطوح شدت رتبهبندی میشوند، اما عدد ۰ حذف شده و فقط از ۱ (برخورد سبک) شروع میشوند.
مناطق برای برنامهریزان پرواز انسانی توصیه میشوند که میتوانند سیاستهایی را بر اساس سطوح شدت ایجاد کنند و میتوانند پروازها را به صورت دستی، معمولاً از طریق انحرافات عمودی (یعنی با تنظیم سطوح پرواز)، تغییر مسیر دهند.
احراز هویت
برای استفاده از API مربوط به Contrails، به یک کلید API نیاز دارید و باید API مربوط به Contrails را فعال کنید.
برای جزئیات، راهنمای راهاندازی محیط خود را دنبال کنید.
خطاها
هنگام استفاده از API Contrails، ممکن است با خطاهای زیر مواجه شوید:
| کد | علت | مدیریت خطا |
|---|---|---|
| ۴۰۰ (درخواستهای نامعتبر) | درخواست با دادههای اشتباه | دوباره به صورت خودکار امتحان نکنید. این خطا به دلیل مشکلات کد ایجاد شده است؛ بررسی کنید که از قالب پارامتر صحیح استفاده میکنید. |
| ۴۰۴ | درخواست برای زمان پیشبینی که هنوز محاسبه نشده است | با یک استراتژی عقبنشینی نمایی دوباره امتحان کنید. |
| ۴۲۹ | درخواستهای بسیار زیاد (به محدودیتهای استفاده مراجعه کنید) | با استفاده از backoff نمایی دوباره امتحان کنید. |
| 5XX | خطای سرور | با استفاده از backoff نمایی دوباره امتحان کنید. |
نسخهبندی
انتشار نسخههای اصلی، مانند انتشار نسخه ۲ ، میتواند رفتارهایی ناسازگار با نسخههای قبلی را معرفی کند و ممکن است نیاز به تغییر کد داشته باشد.
انتظار میرود بهروزرسانیهای منظم بین نسخههای اصلی، با نسخههای قبلی سازگار باشند.
میتوانید درباره بهروزرسانیهای کلیدی در یادداشتهای انتشار API Contrails مطالعه کنید.
قدم بعدی چیست؟
- برای شروع استفاده از API مربوط به Contrails، محیط خود را تنظیم کنید .
- برای راهنمایی دقیق در مورد روشهای موجود API مربوط به Contrails ، مستندات مرجع API مربوط به Contrails را مطالعه کنید.
- برای آشنایی با نحوه محاسبه پیشبینیهای API مربوط به Contrails ، بخش مرور کلی پیشبینی Contrails را مطالعه کنید.