שיוכים

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

פורמט נתונים

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

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

object (Attribution)

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

שיוך (Attribution)

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

ייצוג JSON 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ]
}
שדות
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.
  • ‫{departure_airport}: קוד IATA בן 3 אותיות של נמל התעופה (למשל, "JFK", "LHR").
flightDetails

object (FlightDetails)

מידע מפורט על הטיסה הזו.
contrail

object (ContrailAttributes)

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

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

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

object (SegmentAttribution)

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

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

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

string

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

string

קוד IATA של נמל התעופה שבו הטיסה נוחתת.
callSign

string

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

integer

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

ContrailAttributes

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

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

integer

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

string (int64 format)

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

SegmentAttribution

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

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

string (Timestamp format)

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

string (Timestamp format)

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

object (ContrailAttributes)

מאפייני Contrail לפלח הספציפי הזה.
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)

השעה שבה צולמה תמונת הלוויין שבה זוהה שובל ההתעבות. בדרך כלל זה זמן ההתחלה של הסריקה. חותמת הזמן הזו היא בשניות מאז תקופת ה-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.

צילומי הלוויין של ממשק ה-API של שובלי התעבות מבוססים על:

WaypointAttribution

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

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

string (Timestamp format)

השעה בנקודת הדרך בשניות מאז תקופת ה-Epoch לפי שעון 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.