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

FlightDetails

הגדרה של כל פרטי הטיסה שמוחזרים בתשובה.

ייצוג ב-JSON 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": string
}
שדות
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

אות הקריאה של כלי הטיס שמשויך לנקודת הדרך.
analyzedFlightDistanceMeters

string (int64 format)

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

ContrailAttributes

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

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

string (int64 format)

אורך משוער של היווצרות שובל התעבות, במטרים.
effectiveEnergyForcingJoules

string (int64 format)

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