סקירה כללית על Contrails API

תלמדו מה אפשר לבנות באמצעות Contrails API ותבינו איך נקודות הקצה שלו מתנהגות.

סקירה כללית

‫Contrails API משלב נתוני מזג אוויר בקנה מידה גדול, נתוני טיסות ותמונות לוויין עם מודל מתקדם של ראייה ממוחשבת, כדי ליצור תחזיות של שובלי התעבות שמבוססות על AI. התחזיות האלה מציגות אזורים שבהם סביר להניח שיווצרו פסי התעבות, ואת ההשפעה הפוטנציאלית של פסי התעבות ב-48 השעות הבאות.

שילוב התחזיות האלה בתהליכי עבודה של תכנון טיסות יכול לעזור לטייסים להימנע מטיסה באזורים האלה, וכך למנוע יצירה של שובלי התעבות שגורמים להתחממות.

כדי להבין את התובנות האלה לגבי המיקום שבו ייווצרו פסי התעבות ומידת ההתחממות שלהם, Contrails API מציע תחזיות בצורת רשתות ואזורים.

תחזיות

‫Contrails API מציע תחזיות בצורה הבאה:

  • רשתות: נתונים באיכות גבוהה ב-4 מימדים שמייצגים ערכים של מדד ההשפעה של שובלי מטוסים בצירים של קו רוחב, קו אורך, גובה וזמן, בפורמט NetCDF. הרשתות האלה מייצגות את כל כדור הארץ כרשת של רבע מעלה, שבה המרווחים בין קווי הרוחב וקווי האורך הם 0.25 מעלות. כל רשת מתוכננת לשעה מלאה (UTC).

    ערכי מדד הכפייה של ענני התעבות נעים בין 0, שמייצג מיקום ללא התחממות משמעותית, לבין 4, שמייצג מיקום עם התחממות חמורה כתוצאה מענני התעבות.

    מומלץ להשתמש ברשתות לתכנון טיסות באופן פרוגרמטי, במיוחד לשינוי מסלול של טיסות.

  • אזורים: גרסה פשוטה של התחזית, שמוצגת בצורת מצולעים ומייצגת אזורים שבהם מומלץ להימנע מטיסה כדי למנוע יצירת שובלי התעבות, בפורמט GeoJSON multipolygon.

    אזורים שבהם יש סיכון להיווצרות שובל התעבות מדורגים באותן רמות חומרה, אבל לא כוללים את 0 ומתחילים רק מ-1 (השפעה קלה).

    האזורים מומלצים למתכנני טיסות אנושיים שיכולים לקבוע מדיניות על סמך רמות חומרה, ולשנות ידנית את מסלולי הטיסה, בדרך כלל באמצעות סטיות אנכיות (כלומר, על ידי שינוי גובה הטיסה).

    הדמיה של אזורים צפויים במפה של חלקים באירופה, עם האזור שנבחר להימנעות מפסי התעבות ברמת טיסה מקסימלית של 340 ורמת טיסה מינימלית של 310.

אימות

כדי להשתמש ב-Contrails API, צריך מפתח API ולהפעיל את Contrails API.

פרטים נוספים זמינים במאמר בנושא הגדרת הסביבה.

שגיאות

כשמשתמשים ב-Contrails API, יכול להיות שיופיעו השגיאות הבאות:

קוד סיבה טיפול בשגיאות
‫400 (בקשות לא תקפות) בקשה עם נתונים שגויים לא לנסות שוב באופן אוטומטי. השגיאה הזו נגרמת בגלל בעיות בקוד. צריך לוודא שאתם משתמשים בפורמט הנכון של הפרמטר.
404 בקשה לחיזוי של שעה שעוד לא חושבה ניסיון חוזר עם אסטרטגיית השהיה מעריכית לפני ניסיון חוזר (exponential backoff).
429 יותר מדי בקשות (מידע נוסף זמין במאמר בנושא מכסות שימוש) ניסיון חוזר עם השהיה מעריכית לפני ניסיון חוזר (exponential backoff).
‫5XX שגיאה בחיבור לשרת ניסיון חוזר עם השהיה מעריכית לפני ניסיון חוזר (exponential backoff).

ניהול גרסאות

בגרסאות חדשות, כמו ההשקה של v2, יכולים להיות שינויים בהתנהגות שלא תואמים לגרסאות קודמות, ולכן יכול להיות שיידרשו שינויים בקוד.

עדכונים רגילים בין פרסומים של גרסאות ראשיות צפויים להיות תואמים לאחור.

אפשר לקרוא על עדכונים חשובים בנתוני הגרסה של Contrails API.

המאמרים הבאים