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 נתוני הפליטות מגיעים ממודל ההשפעה של נסיעות.
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 הכוללות.