שיוכים

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

פורמט נתונים

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

ייצוג ב-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

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

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

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.