שיוכים

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

פורמט נתונים

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

ייצוג ב-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 (זמין החל משנת 2024).
  • ‫{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

כתובת מטוס של 24 ביט לפי ICAO
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)

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

string (Timestamp format)

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