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 של שדה התעופה שממנו הטיסה ממריאה, בן 3 תווים, לדוגמה YVR. הפרמטר הזה משמש להתאמה של טיסה ספציפית אם הוא מסופק לצד היעד, חברת התעופה ומספר הטיסה. אם לא נמצאה התאמה, ננסה קודם להתאים את הטיסה לטיסה רגילה בין שדות התעופה של המוצא והיעד שצוינו. אחרת, נשתמש במודל הפליטות שמבוסס על מרחק, אם מרחק הטיסה מסופק.
destination

string

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

string

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

integer

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

string (int64 format)

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

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 פליטות שמבוססות על מרחק, לפי המרחק שעברתם והשנה.