שיוכים

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

פורמט נתונים

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

ייצוג ב-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}: מספר טיסה בן ספרה אחת עד 4 ספרות (לדוגמה, "123").
  • ‫{departure_date}: תאריך ההמראה בפורמט YYYY-MM-DD.
  • ‫{departure_airport}: קוד שדה תעופה IATA בן 3 אותיות (למשל, "JFK", "LHR").
flightDetails

object (FlightDetails)

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

object (ContrailAttributes)

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

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

  • אם קיים: בוצע ניתוח של נתיב הטיסה. השדות בתוך ContrailAttributes מציינים את התוצאות (למשל, lengthMeters > 0 פירושו שפסי התעבות שויכו).
  • אם לא מופיע: לא ניתן היה לבצע ניתוח של שובל ההתעבות עבור הטיסה הזו.
    • הסיבה לכך היא בדרך כלל נתוני קלט לא מספיקים (למשל, חוסר בנתוני מזג אוויר או אי ודאות לגבי נתיב הטיסה).
    • המשמעות היא שלא ניתן היה לקבוע אם נוצרו עקבות של מטוסים, ולא שלא נוצרו עקבות כאלה.
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

תאריך ההמראה באזור הזמן של שדה התעופה של מוצא; int: unix epoch או str: ISO 8601.
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)

הכוח הכולל של אנרגיית שובל התעבות, בג'ול. החישוב הזה מבוסס כרגע על ממוצעים אקלימיים, והוא עשוי להשתנות.

SegmentAttribution

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

ייצוג ב-JSON 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ]
}
שדות
startTime

string (Timestamp format)

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

string (Timestamp format)

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

object (ContrailAttributes)

מאפייני Contrail לפלח הספציפי הזה.
detectionEvidences[]

object (ContrailDetectionEvidence)

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

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 ו-MTG. השיוכים שמבוססים על GOES East הם באיכות של שלב הייצור, בעוד שהשיוכים שמבוססים על 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.