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. אם הטיסה העתידית המבוקשת לא מתרחשת בשנה הקלנדרית הנוכחית, נחזיר תגובה ריקה. מומלץ להשתמש ב-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 (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

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

string

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

integer

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

string (int64 format)

אופציונלי. המרחק בקילומטרים, למשל 2423, מתוך [‎1, 2.5e16) km. המאפיין הזה משמש להתאמת טיסה לפליטות שמבוססות על מרחק, אם לא צוינו נקודת המוצא והיעד או אם אין טיסות אופייניות תואמות.

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)
}
שדות
flight

object (Scope3FlightSegment)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

enum (Scope3FlightEmissions.Scope3DataType)

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

Scope3FlightEmissions.Scope3DataType

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

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