Method: flights.computeScope3FlightEmissions

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

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

  1. פליטות שמבוססות על TIM, עבור origin, destination, carrier, flightNumber, departureDate ו-cabinClass.
  2. ערכי פליטה אופייניים של טיסות בהינתן origin, destination, שנה בdepartureDate וcabinClass.
  3. פליטות שמבוססות על מרחק מחושבות באמצעות distanceKm, שנה ב-departureDate ו-cabinClass.

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

אם לא זמינים אומדנים לטיסה מסוימת באף אחת משלוש השיטות, התגובה תחזיר אובייקט 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 (CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
שדות
departureDate

object (Date)

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

enum (CabinClass)

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

string

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

string

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

string

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

integer

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

string (int64 format)

אופציונלי. המרחק בקילומטרים, למשל 2423. המאפיין הזה משמש להתאמת טיסה לפליטות שמבוססות על מרחק, אם לא צוינו נקודת המוצא והיעד או אם אין טיסות אופייניות תואמות. השדה הזה תומך בערכים בין 0 ל-2.5e16 ק"מ.

CabinClass

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

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

Scope3FlightEmissions

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

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

object (Scope3FlightSegment)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

enum (Scope3DataType)

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

Scope3DataType

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

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