Method: batchGetAttributions

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

אם הפעולה בוצעה ללא שגיאות, התגובה תהיה רשימה של שיוכים של שובלי התעבות.

בקשת HTTP

GET https://contrails.googleapis.com/v2/{parent=attributions}:batchGet

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. משאב האב שמשותף לכל השיוכים שאותם מאחזרים. פורמט: attributions

פרמטרים של שאילתה

פרמטרים
names[]

string

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

פורמט:

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").

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

תגובה שמכילה את נתוני השיוך של שובלי ההתעבות עבור attributions.batchGet.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

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

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

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

  • אם קיים: בוצע ניתוח של נתיב הטיסה. השדות בתוך 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)

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

string (Timestamp format)

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

object (ContrailAttributes)

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

object (ContrailDetectionEvidence)

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

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

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

טיפוסים בני מנייה (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.