Method: flights.computeFlightEmissions

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

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

  • הטיסה לא מוכרת לשרת.
  • חסר מזהה אחד או יותר בקטע הטיסה של הקלט.
  • תאריך הטיסה חל בעבר.
  • סוג המטוס לא אפשרי בדגם.
  • חסרה הגדרה של עמדות.

הבקשה יכולה להכיל עד 1,000 קטעי טיסה. אם הבקשה כוללת יותר מ-1,000 טיסות ישירות, היא תיכשל עם השגיאה INVALID_ARGUMENT.

בקשת HTTP

POST https://travelimpactmodel.googleapis.com/v1/flights:computeFlightEmissions

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

גוף הבקשה

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

ייצוג ב-JSON 
{
  "flights": [
    {
      object (Flight)
    }
  ]
}
שדות
flights[]

object (Flight)

חובה. טיסות ישירות להערכת פליטות בטיסות חזרה.

גוף התשובה

הגדרת הפלט של התגובה flights.computeFlightEmissions.

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

ייצוג ב-JSON 
{
  "flightEmissions": [
    {
      object (FlightWithEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
שדות
flightEmissions[]

object (FlightWithEmissions)

רשימה של מקטעי טיסה עם אומדני פליטות.
modelVersion

object (ModelVersion)

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

טיסה

כל הפרטים שקשורים לפריט בקשה יחיד לאומדני פליטות של טיסה ישירה.

ייצוג ב-JSON 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
שדות
origin

string

חובה. קוד IATA של שדה התעופה שממנו הטיסה ממריאה, למשל LHR.
destination

string

חובה. קוד IATA של שדה התעופה שבו הטיסה נוחתת, לדוגמה: 'JFK'.
operatingCarrierCode

string

חובה. קוד חברת התעופה של IATA, לדוגמה, 'AA'.
flightNumber

integer

חובה. מספר טיסה, לדוגמה 324.
departureDate

object (Date)

חובה. תאריך הטיסה באזור הזמן של נמל התעופה שממנו ממריאה הטיסה. התאריך חייב להיות בהווה או בעתיד.

FlightWithEmissions

טיסה ישירה עם אומדני פליטות.

ייצוג ב-JSON 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
שדות
flight

object (Flight)

מזהה. תואם למזהי הטיסות בבקשה. הערה: כל קודי ה-IATA הם באותיות רישיות.
source

enum (Source)

אופציונלי. המקור של נתוני הפליטות.
emissionsGramsPerPax

object (EmissionsGramsPerPax)

אופציונלי. מספרים של אומדני פליטות לנפש. העמודה לא תופיע אם לא ניתן לחשב את פליטת הפחמן. רשימת הסיבות לכך שלא ניתן לחשב את פליטת הפחמן מופיעה במאמר flights.computeFlightEmissions.
easaLabelMetadata

object (EasaLabelMetadata)

אופציונלי. מטא-נתונים על EASA Flight Emissions Label (תווית פליטות הטיסה של הסוכנות האירופית לבטיחות תעופה). הערך מוגדר רק כשמקור נתוני הפליטות הוא EASA.
contrailsImpactBucket

enum (ContrailsImpactBucket)

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

מקור

המקור של נתוני הפליטות.

טיפוסים בני מנייה (enum)
SOURCE_UNSPECIFIED מקור נתוני הפליטות לא צוין.
TIM נתוני הפליטות מגיעים מ-Travel Impact Model ‏(TIM).
EASA נתוני הפליטות מגיעים מתוויות הסביבה של EASA.

EasaLabelMetadata

מטא-נתונים על EASA Flight Emissions Label (תווית פליטות הטיסה של הסוכנות האירופית לבטיחות תעופה).

ייצוג ב-JSON 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
שדות
labelIssueDate

object (Date)

התאריך שבו התווית הונפקה.
labelExpiryDate

object (Date)

התאריך שבו התווית פוקעת. התווית תוצג עד סוף התאריך הזה.
labelVersion

string

גרסת התווית.
safDiscountPercentage

number

אחוז ההנחה על פליטות מדלק מטוסים בר קיימא (SAF) שחל על התווית. הערך הוא אחוז שמוצג כמספר עשרוני. הערכים הם בטווח [0,1]. לדוגמה, 0.0021 מייצג 0.21%.

ההנחה הזו והפחתת הפליטות מדווחות בתווית של EASA, אבל הן לא נכללות באומדני ה-CO2e שמופצים על ידי ה-API הזה.

ContrailsImpactBucket

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

טיפוסים בני מנייה (enum)
CONTRAILS_IMPACT_UNSPECIFIED ההשפעה של פסי ההתעבות לא צוינה.
CONTRAILS_IMPACT_NEGLIGIBLE ההשפעה של פסי התעבות זניחה בהשוואה לפליטות הכוללות של CO2e.
CONTRAILS_IMPACT_MODERATE ההשפעה של פסי ההתעבות דומה לפליטות הכוללות של CO2e.
CONTRAILS_IMPACT_SEVERE ההשפעה של פסי ההתעבות גבוהה יותר מההשפעה של פליטות CO2e הכוללות.