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)

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

תאריך

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

  • תאריך מלא, עם ערכים שאינם אפס לשנה, לחודש וליום.
  • חודש ויום, עם שנה אפס (לדוגמה, יום נישואים).
  • שנה לבד, עם חודש אפס ויום אפס.
  • שנה וחודש, עם יום אפס (לדוגמה, תאריך התפוגה של כרטיס אשראי).

סוגים קשורים:

ייצוג ב-JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
שדות
year

integer

השנה של התאריך. חייב להיות בין 1 ל-9999, או 0 כדי לציין תאריך ללא שנה.
month

integer

החודש בשנה. הערך צריך להיות בין 1 ל-12, או 0 כדי לציין שנה בלי חודש ויום.
day

integer

היום בחודש. הערך חייב להיות בין 1 ל-31, והוא צריך להיות תקף לשנה ולחודש, או 0 כדי לציין רק שנה או שנה וחודש שבהם היום לא משמעותי.

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.