Method: flights.computeScope3FlightEmissions

אחזור של אומדני פליטות גזי חממה (GHG) לקבוצה של מקטעי טיסה לצורך דיווח על היקף 3.

התשובה תכיל את כל הרשומות שתואמות ל-Scope3FlightSegment מקטעי הטיסה שהוזנו, באותו סדר שבו הם הוזנו. ההערכות יחושבו לפי הלוגיקה המדורגת הבאה (המערכת תשתמש באפשרות הראשונה שזמינה):

  1. פליטות גזים לפי TIM בהתאם לנתונים הבאים: origin,‏ destination,‏ carrier,‏ flightNumber,‏ departureDate ו-cabinClass.
  2. פליטות אופייניות של טיסה בהתחשב בorigin, בdestination, בשנה בdepartureDate ובcabinClass.
  3. הפליטות מבוססות-המרחק מחושבות לפי distanceKm, שנה ב-departureDate ו-cabinClass.

אם יש בקשה לטיסה עתידית בשנה הקלנדרית הזו, אנחנו לא תומכים בפליטות ברמה 1 ונחזור לפליטות ברמה 2 או 3. אם הטיסה העתידית המבוקשת לא מתקיימת בשנה הקלנדרית הנוכחית, ה-API יחזיר תשובה ריקה. אנחנו ממליצים להשתמש ב-API של computeFlightEmissions לטיסות עתידיות.

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

הבקשה תיכשל עם השגיאה INVALID_ARGUMENT אם:

  • הבקשה מכילה יותר מ-1,000 מקטעי טיסה.
  • בקטע הטיסה שהוזן חסר מזהה אחד או יותר. לדוגמה, חסרים מקור/יעד בלי מרחק חוקי להתאמה מסוג TIM_EMISSIONS או TYPICAL_FLIGHT_EMISSIONS, או חסר מרחק להתאמה מסוג DISTANCE_BASED_EMISSIONS (אם רוצים לחזור לפליטות מבוססות-מרחק או לקבל אומדן של פליטות מבוססות-מרחק, צריך לציין מרחק).
  • תאריך הטיסה הוא לפני 2019 (נתוני היקף 3 זמינים רק משנת 2019 ואילך).
  • מרחק הטיסה הוא 0 או פחות.
  • חסרה מחלקה במטוס.

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

בקשת HTTP

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

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

גוף הבקשה

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

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

object (Scope3FlightSegment)

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

object (ModelVersion)

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

גוף התשובה

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

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

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

object (Scope3FlightEmissions)

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

object (ModelVersion)

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

Scope3FlightSegment

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

ייצוג ב-JSON 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (Scope3FlightSegment.CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
שדות
departureDate

object (Date)

חובה. תאריך הטיסה באזור הזמן של שדה התעופה שממנו יוצאת הטיסה. במודלים של פליטות אופייניות בטיסה ופליטות לפי מרחק, צריך לציין רק את השנה (המערכת מתעלמת מערכי החודש והיום, ולכן אפשר להשמיט אותם, להגדיר אותם כ-0 או להגדיר אותם כתאריך חוקי במקרים האלה). בהתאם, אם לא צוין תאריך ספציפי לשיעורי הפליטה של TIM, נחזור לשיעורי הפליטה האופייניים בטיסה (או לשיעורי הפליטה שמבוססים על מרחק).
cabinClass

enum (Scope3FlightSegment.CabinClass)

חובה. המחלקה במטוס.
origin

string

אופציונלי. קוד שדה תעופה של IATA שממנו הטיסה ממריאה (3 תווים), למשל YVR. הנתון הזה משמש להתאמה לטיסה ספציפית אם הוא מסופק לצד היעד, חברת התעופה ומספר הטיסה. אם אין התאמה, ננסה קודם להתאים את הטיסה לטיסה אופיינית בין נמלי התעופה שצוינו כמקור וכיעד. אחרת, נשתמש במודל הפליטות שמבוסס על מרחק, אם מרחק הטיסה צוין.
destination

string

אופציונלי. קוד שדה תעופה של IATA (3 תווים) שבו הטיסה נוחתת, לדוגמה ICN. הנתון הזה משמש להתאמה לטיסה ספציפית אם הוא מסופק לצד נקודת המוצא, חברת התעופה ומספר הטיסה. אם אין התאמה, ננסה קודם להתאים את הטיסה לטיסה אופיינית בין נמלי התעופה שצוינו כמקור וכיעד. אחרת, נשתמש במודל הפליטות שמבוסס על מרחק, אם מרחק הטיסה צוין.
carrierCode

string

אופציונלי. קוד חברת תעופה של IATA באורך 2 תווים, למשל KE. השדה הזה נדרש אם רוצים להתאים טיסה ספציפית. אחרת, לא משתמשים בנתון הזה במודלים רגילים של פליטות גזים שמבוססים על טיסות ומרחקים. הקוד יכול להיות גם קוד תפעולי וגם קוד שיווקי של חברת התעופה (כלומר, קוד משותף נכלל).
flightNumber

integer

אופציונלי. מספר טיסה של עד 4 ספרות, למשל 71, מ-[1, 9999]. הוא משמש קודם כל כדי להתאים טיסה ספציפית אם מספר הטיסה מצוין לצד נקודת המוצא, היעד וחברת התעופה. אם לא צוין מספר טיסה, ננסה קודם להתאים את הטיסה לטיסה אופיינית בין נמלי התעופה שצוינו כמקור וכיעד. אם זה לא יצליח ו/או אם לא יסופקו נקודת המוצא והיעד, נשתמש במודל הפליטות שמבוסס על מרחק הטיסה שסופק.
distanceKm

string (int64 format)

אופציונלי. מרחק בקילומטרים, למשל 2423, מ-[1, 1e12) ק"מ. המרחק משמש להתאמת טיסה לפליטות מבוססות-מרחק כשלא צוינו מוצא ויעד או כשאין טיסות אופייניות תואמות.

Scope3FlightSegment.CabinClass

המחלקה במטוס.

טיפוסים בני מנייה (enum)
CABIN_CLASS_UNSPECIFIED לא צוינה מחלקה במטוס.
ECONOMY מחלקת תיירים.
PREMIUM_ECONOMY מחלקת תיירים פלוס.
BUSINESS מחלקת עסקים.
FIRST מחלקה ראשונה.

Scope3FlightEmissions

טיסה בהיקף 3 עם אומדני פליטות.

ייצוג ב-JSON 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3FlightEmissions.Scope3DataType),
  "modelVersion": string
}
שדות
flight

object (Scope3FlightSegment)

מזהה. תואם למזהי הטיסות בבקשה.
wtwEmissionsGramsPerPax

string (int64 format)

אופציונלי. סך הפליטות בטיסה (הסכום של פליטות WTT ופליטות TTW) לכל נוסע, על סמך המידע המבוקש. זהו סך הפליטות, ואלא אם יש לכם סיבות ספציפיות להשתמש בפליטות TTW או WTT, כדאי להשתמש במספר הזה.
ttwEmissionsGramsPerPax

string (int64 format)

אופציונלי. פליטות מטיסה לפי נוסע, מהמכל למנוע, על סמך המידע המבוקש.
wttEmissionsGramsPerPax

string (int64 format)

אופציונלי. פליטות Well-to-tank של טיסה לכל נוסע, על סמך המידע המבוקש.
source

enum (Scope3FlightEmissions.Scope3DataType)

אופציונלי. המקור של נתוני פליטות הגזים.
modelVersion

string

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

Scope3FlightEmissions.Scope3DataType

סוג ההתאמה שמשמש לחישוב פליטות בהיקף 3. השדה הזה משמש לתגובה של היקף 3, ומציין באיזו שיטה השתמשו כדי לחשב את הפליטות.

טיפוסים בני מנייה (enum)
SCOPE3_DATA_TYPE_UNSPECIFIED סוג נתונים לא מזוהה.
TIM_EMISSIONS פליטות מבוססות-TIM לפי מוצא, יעד, חברת תעופה, מספר טיסה, תאריך המראה ושנה.
TYPICAL_FLIGHT_EMISSIONS שיעורי הפליטה האופייניים בטיסה לפי נקודת המוצא, היעד והשנה.
DISTANCE_BASED_EMISSIONS פליטות לפי מרחק, בהתאם למרחק הנסיעה ולשנה.