שיוכים

מקטעי פסי התעבות משויכים לרשימה ספציפית של טיסות.

פורמט נתונים

בקשות לפסי התעבות משויכים מכילות נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
שדות
attributions[]

object (Attribution)

רשימה של שיוכים, אחד לכל שם משאב שצוין ב-BatchGetAttributionsRequest.names. סדר השיוכים ברשימה הזו יהיה זהה לסדר השמות ב-BatchGetAttributionsRequest. אם לא נמצאה טיסה, הודעת השיוך (Attribution) המתאימה בתגובה תכלול רק את השדה name, והשדות flightDetails ו-contrail יהיו ריקים.

שיוך (Attribution)

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

ייצוג ב-JSON 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ],
  "visualizationUrl": string
}
שדות
name

string

מזהה. שם המשאב של הטיסה.

פורמט:

carriers/{carrier}/flightNumbers/{flightNumber}/departureDates/{departure_date}/departureAirports/{departure_airport}

רכיבים:

  • {carrier}: קוד IATA של חברת התעופה, באורך 2 תווים (למשל, "AA", "UA").
  • ‫{flightNumber}: מספר טיסה בן 1-4 ספרות (למשל, "123").
  • {departure_date}: תאריך ההמראה של הטיסה לפי השעון המקומי של נמל התעופה שממנו היא יוצאת, בפורמט YYYY-MM-DD (זמין משנת 2024 ואילך).
  • ‫{departure_airport}: קוד שדה תעופה של IATA, שמורכב מ-3 אותיות (למשל, "JFK", "LHR").
flightDetails

object (FlightDetails)

הפרטים של הטיסה הזו.
contrail

object (ContrailAttributes)

מאפיינים מצטברים של פסי התעבות לכל הטיסה. זהו סיכום של מאפייני פסי ההתעבות מכל הפלחים המשויכים.

פרשנות של המצב (בטיסה שנמצאה):

  • אם מופיע: בוצע ניתוח של פסי ההתעבות. השדות בתוך ContrailAttributes מציינים את התוצאות (למשל, lengthMeters > 0 מציין שפסי ההתעבות שויכו). אם מופיעה הודעת ContrailAttributes ריקה, זה אומר שהניתוח בוצע אבל גם lengthMeters וגם אילוץ האנרגיה הוערכו כאפס.
  • אם הנתונים לא קיימים: אי אפשר לבצע ניתוח של פסי ההתעבות בטיסה הזו.
    • בדרך כלל זה קורה כי אין מספיק נתוני קלט (למשל, חסרים נתוני מזג אוויר או שיש חוסר ודאות לגבי נתיב הטיסה).
    • זה לא אומר שלא נוצרו פסי התעבות, אלא רק שלא ניתן היה לקבוע זאת.
segments[]

object (SegmentAttribution)

שיוך פסי התעבות לכל מקטע. כל רשומה מייצגת מרווח זמן נפרד של הטיסה שבו נוצרו פסי התעבות.
visualizationUrl

string

פלט בלבד. קישור להדמיה אינטראקטיבית של שיוך פסי ההתעבות של הטיסה הזו בדף ContrailWatch של ContrailExplorer. הוא מציג את נתיב הטיסה בהתאמה לפסי ההתעבות שזוהו על ידי לוויינים.

השדה הזה מאוכלס רק בטיסות שנמצאו כשמשתמשים בתצוגה ATTRIBUTION_VIEW_OBSERVATION.

FlightDetails

מגדיר את קבוצת פרטי הטיסה המלאה שמוחזרת בתגובה.

ייצוג ב-JSON 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": integer
}
שדות
carrier

string

קוד IATA של חברת התעופה (למשל, "AA").
flightNumber

integer

מספר הטיסה (לדוגמה, "123").
departureTime

string

תאריך היציאה באזור הזמן של שדה התעופה שממנו יוצאת הטיסה, בפורמט YYYYMMDD.
icao24

string

כתובת מטוס של 24 ביט לפי ICAO
originAirport

string

קוד IATA של נמל התעופה שממנו הטיסה ממריאה.
destinationAirport

string

קוד שדה התעופה של יעד IATA.
callSign

string

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

integer

מרחק הטיסה שנותח, במטרים.

ContrailAttributes

מייצג את מאפייני פסי ההתעבות של טיסה או של קטע טיסה.

ייצוג ב-JSON 
{
  "lengthMeters": integer,
  "effectiveEnergyForcingJoules": string
}
שדות
lengthMeters

integer

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

string (int64 format)

האילוץ האנרגטי האפקטיבי הכולל של פסי ההתעבות, בג'אולים. הנתון הזה מופק על ידי חילוץ של אילוץ קרינתי אפקטיבי מפלט של תחזית CoCiP ברשת 4D וביצוע אינטרפולציה לינארית. המתודולוגיה הזו עשויה להשתנות.

SegmentAttribution

מייצג את השיוך של פסי ההתעבות לפלח זמן ספציפי של טיסה.

ייצוג ב-JSON 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}
שדות
startTime

string (Timestamp format)

שעת ההתחלה של קטע הטיסה שאליו משויכים פסי ההתעבות. חותמת הזמן הזו היא בשניות לפי ראשית זמן יוניקס (Unix epoch) ב-UTC.
endTime

string (Timestamp format)

שעת הסיום של קטע הטיסה שאליו משויכים פסי ההתעבות. חותמת הזמן הזו היא בשניות לפי ראשית זמן יוניקס (Unix epoch) ב-UTC.
contrail

object (ContrailAttributes)

מאפייני פס ההתעבות של הפלח הספציפי הזה.
detectionEvidences[]

object (ContrailDetectionEvidence)

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

enum (AttributionMethod)

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

boolean

פלט בלבד. הערך True מציין שנתיב הטיסה של המקטע נוצר על ידי אינטרפולציה על פער גדול בנתוני ADS-B (יותר מ-5 דקות).
waypointAttributions[]

object (WaypointAttribution)

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

ContrailDetectionEvidence

פרטים של תצפית לוויין אחת על פס התעבות.

ייצוג ב-JSON 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
שדות
observationTime

string (Timestamp format)

השעה שבה צולמה תמונת הלוויין שבה זוהה פס ההתעבות. בדרך כלל זו שעת ההתחלה של הסריקה. חותמת הזמן הזו היא בשניות לפי ראשית זמן יוניקס (Unix epoch) ב-UTC.
observedLengthMeters

integer

האורך הנצפה מקצה לקצה של פס ההתעבות הליניארי במטרים, כפי שזוהה בתצלום הלוויין שצוין על ידי observationTime. האורך הזה יכול להיות שונה מהערך של lengthMeters ב-SegmentAttribution.contrail מהסיבות הבאות:

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

enum (DataSource)

פלט בלבד. מקור נתוני הלוויין ששימשו לזיהוי הזה.

DataSource

מקור נתוני הלוויין שמשמשים לזיהוי פסי התעבות. יכול להיות שבעתיד נוסיף עוד ערכים.

מבין פלטי נתוני הלוויין הזמינים, השיוכים שמבוססים על GOES East ו-Himawari הם באיכות של רמת ייצור, ואילו השיוכים שמבוססים על MTG עדיין בשלב הבטא ועוברים שיפורי איכות באופן פעיל.

טיפוסים בני מנייה (enum)
DATA_SOURCE_UNSPECIFIED מקור נתונים לא מוגדר.
GOES_EAST_FULL_DISK נתונים מסריקות דיסק מלאות של GOES-East.
GOES_WEST_FULL_DISK נתונים מסריקות דיסק מלאות של GOES-West.
MTG_000_FULL_DISK נתונים מסריקות דיסק מלאות של MTG-000.
HIMAWARI_FULL_DISK נתונים מסריקות דיסק מלאות של Himawari.

צילומי הלוויין של Contrails API מבוססים על:

WaypointAttribution

מייצג מאפיינים של פסי התעבות בנקודת ציון ספציפית בקטע טיסה.

ייצוג ב-JSON 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
שדות
time

string (Timestamp format)

השעה בנקודת הציון בשניות לפי שעון UTC.
contrailAttributes

object (ContrailAttributes)

מאפייני פס ההתעבות שמופו בנקודת הציון הספציפית הזו.

AttributionMethod

מגדיר את ההליך או המתודולוגיה הספציפיים שמשמשים לביצוע השיוך.

טיפוסים בני מנייה (enum)
ATTRIBUTION_METHOD_OBSERVATION השיוך נגזר אך ורק מהתאמה לזיהויים של פסי התעבות על ידי לוויינים.
ATTRIBUTION_METHOD_COCIP השיוכים מסתמכים אך ורק על מודל CoCiP שמבוסס על פיזיקה.
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

שיוך היברידי שמשלב תחזיות של מודל CoCiP עם התאמות בתחזית לפי זיהויים של לוויינים.

  • עם זיהויים: אם מופיע detectionEvidences, פס ההתעבות נחזה ואושר באמצעות תצפית, וקיבל משקל התחממות משופר.
  • ללא זיהויים: אם חסר detectionEvidences, פס ההתעבות נחזה אבל לא נצפה, ולכן ההתחממות המחושבת לא נכללת.
ATTRIBUTION_METHOD_UNSPECIFIED שיטה לא מוגדרת.

הערות

לכל DataSource יש גבולות שונים לעיבוד צפיות שמבוססות על תצפיות:

תיבות תוחמות של כיסוי לווייני (תצוגת מרקטור שטוחה)

רישיון

הנתונים שחשופים דרך ContrailWatch Attributions API כפופים לרישיון CC BY-NC 4.0.