Package google.travel.sustainability.travelimpactmodel.v1

אינדקס

• ‫TravelImpactModelService (ממשק)
• ‫ComputeFlightEmissionsRequest (הודעה)
• ‫ComputeFlightEmissionsResponse (הודעה)
• ‫ComputeScope3FlightEmissionsRequest (הודעה)
• ‫ComputeScope3FlightEmissionsResponse (הודעה)
• ‫ComputeTypicalFlightEmissionsRequest (הודעה)
• ‫ComputeTypicalFlightEmissionsResponse (הודעה)
• ContrailsImpactBucket (enum)
• ‫EasaLabelMetadata (הודעה)
• ‫EmissionsGramsPerPax (הודעה)
• ‫Flight (הודעה)
• ‫FlightWithEmissions (הודעה)
• ‫Market (הודעה)
• ‫ModelVersion (הודעה)
• ‫Scope3FlightEmissions (הודעה)
• Scope3FlightEmissions.Scope3DataType (enum)
• ‫Scope3FlightSegment (הודעה)
• Scope3FlightSegment.CabinClass (enum)
• Source (enum)
• ‫TypicalFlightEmissions (הודעה)

TravelImpactModelService

‫API שמספק הערכות של פליטות פחמן.

ComputeFlightEmissions

rpc ComputeFlightEmissions(ComputeFlightEmissionsRequest) returns (ComputeFlightEmissionsResponse) שיטה חסרת מצב לאחזור אומדני פליטות. פרטים על אופן החישוב של אומדני הפליטות מופיעים ב-GitHub התשובה תכיל את כל הערכים שתואמים לקטעי הטיסה שהוזנו, באותו סדר. אם אין אומדנים זמינים לקטע טיסה מסוים, התגובה תחזיר את אובייקט קטע הטיסה עם שדות פליטה ריקים. הבקשה עדיין תיחשב כבקשה שהושלמה בהצלחה. הסיבות לכך שאומדני הפליטות לא מוצגים כוללות: הטיסה לא מוכרת לשרת. חסר מזהה אחד או יותר בקטע הטיסה של הקלט. תאריך הטיסה חל בעבר. הדגם לא תומך בסוג המטוס. חסרה הגדרה של עמדות. הבקשה יכולה להכיל עד 1,000 קטעי טיסה. אם הבקשה כוללת יותר מ-1,000 טיסות ישירות, היא תיכשל עם השגיאה INVALID_ARGUMENT.

ComputeScope3FlightEmissions

rpc ComputeScope3FlightEmissions(ComputeScope3FlightEmissionsRequest) returns (ComputeScope3FlightEmissionsResponse) שיטה ללא שמירת מצב (stateless) לאחזור הערכות של פליטות גזי חממה (GHG) עבור קבוצה של פלחי טיסה לצורך דיווח על פליטות היקף 3. התשובה תכיל את כל הערכים שתואמים לקטע הטיסה Scope3FlightSegment שהוזן, באותו סדר שבו הם סופקו. ההערכות יחושבו באמצעות הלוגיקה המדורגת הבאה (השימוש יהיה בשיטה הראשונה שזמינה): פליטות שמבוססות על TIM, עבור origin, destination, carrier, flightNumber, departureDate ו-cabinClass. ערכי פליטה אופייניים של טיסות בהינתן origin, destination, שנה בdepartureDate וcabinClass. פליטות שמבוססות על מרחק מחושבות באמצעות 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) כדי לוודא שהתוצאות הן כמו שציפיתם.

ComputeTypicalFlightEmissions

rpc ComputeTypicalFlightEmissions(ComputeTypicalFlightEmissionsRequest) returns (ComputeTypicalFlightEmissionsResponse) הפונקציה מחזירה אומדנים של שיעורי פליטה אופייניים בטיסה בין שני נמלי תעופה, שנקראים גם שוק. אם אין אומדנים זמינים לשוק מסוים, התגובה תחזיר את אובייקט השוק עם שדות פליטה ריקים. הבקשה עדיין תיחשב כבקשה שהושלמה בהצלחה. ב-GitHub יש פרטים על אופן החישוב של אומדני הפליטות האופייניים. הבקשה יכולה להכיל עד 1,000 שווקים. אם הבקשה כוללת יותר מ-1,000 שווקים, היא תיכשל עם השגיאה INVALID_ARGUMENT.

ComputeFlightEmissionsRequest

הגדרת הקלט לבקשה ComputeFlightEmissions.

שדות
flights[]	Flight חובה. טיסות ישירות להערכת פליטות בטיסות חזרה.

ComputeFlightEmissionsResponse

הגדרת הפלט של התגובה ComputeFlightEmissions.

שדות
flight_emissions[]	FlightWithEmissions רשימה של מקטעי טיסה עם אומדני פליטות.
model_version	ModelVersion גרסת המודל שבאמצעותה חושבו אומדני הפליטות של כל הטיסות בתשובה הזו.

ComputeScope3FlightEmissionsRequest

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

שדות
flights[]	Scope3FlightSegment חובה. טיסות שעבורן רוצים לקבל אומדני פליטות.
model_version	ModelVersion אופציונלי. גרסת המודל שבאמצעותה חושבו אומדני הפליטות של כל הטיסות בבקשה הזו.

ComputeScope3FlightEmissionsResponse

רשימה של טיסות עם הערכות פליטה מדרגה 3.

שדות
flight_emissions[]	Scope3FlightEmissions רשימה של מקטעי טיסה עם אומדני פליטות.
model_version	ModelVersion גרסת המודל שבאמצעותה חושבו אומדני הפליטות של כל הטיסות בתשובה הזו.

ComputeTypicalFlightEmissionsRequest

רשימה של זוגות שדות תעופה (שווקים) שרוצים לקבל את נתוני הפליטות האופייניים שלהם.

שדות
markets[]	Market חובה. שולחים בקשה לאומדני פליטות הפחמן האופייניים לטיסה לזוג השווקים הזה. אפשר לבקש עד 1,000 שווקים.

ComputeTypicalFlightEmissionsResponse

התשובה כוללת את פליטת גזי החממה, אבל גם את גרסת המודל.

שדות
typical_flight_emissions[]	TypicalFlightEmissions הוגשה בקשה לשיעורי פליטה אופייניים בטיסה בשוק.
model_version	ModelVersion גרסת המודל שבאמצעותה חושבו אומדני פליטות הפחמן האופייניים לכל הטיסות בתגובה הזו.

ContrailsImpactBucket

המשמעות של השפעת ההתחממות של פסי ההתעבות בהשוואה להשפעה הכוללת של פליטות CO2e.

טיפוסים בני מנייה (enum)
CONTRAILS_IMPACT_UNSPECIFIED	לא צוינה השפעה של פסי התעבות.
CONTRAILS_IMPACT_NEGLIGIBLE	ההשפעה של פסי התעבות זניחה בהשוואה לפליטות הכוללות של CO2e.
CONTRAILS_IMPACT_MODERATE	ההשפעה של פסי ההתעבות דומה לסך הפליטות של CO2e.
CONTRAILS_IMPACT_SEVERE	ההשפעה של פסי ההתעבות גבוהה יותר מההשפעה של פליטות CO2e הכוללות.

EasaLabelMetadata

מטא-נתונים על EASA Flight Emissions Label (תווית פליטות הטיסה של הסוכנות האירופית לבטיחות תעופה).

שדות
label_issue_date	Date התאריך שבו התווית הונפקה.
label_expiry_date	Date התאריך שבו התווית פוקעת. התווית תוצג עד סוף התאריך הזה.
label_version	string גרסת התווית.
saf_discount_percentage	double אחוז ההנחה על פליטות של דלק מטוסים בר קיימא (SAF) שמופיע בתווית. הערך הזה מוצג באחוזים כמספר עשרוני. הערכים הם בטווח [0,1]. לדוגמה, 0.0021 מייצג 0.21%. ההנחה הזו והפחתת הפליטות מדווחות בתווית של EASA, אבל הן לא נכללות באומדני ה-CO2e שמופצים על ידי ה-API הזה.

EmissionsGramsPerPax

תוצאות של פליטות מקובצות לפי מחלקה.

שדות
first	int32 פליטות לנוסע אחד במחלקה ראשונה בגרמים. השדה הזה תמיד מחושב ומאוכלס, גם אם במטוס יש מושבים במחלקה ראשונה וגם אם לא.
business	int32 פליטות לנוסע אחד במחלקת עסקים בגרמים. השדה הזה תמיד מחושב ומאוכלס, גם אם במטוס יש מושבים במחלקת עסקים וגם אם לא.
premium_economy	int32 פליטות לנוסע אחד במחלקת תיירים פלוס בגרמים. השדה הזה תמיד מחושב ומאוכלס, גם אם במטוס יש מושבים במחלקת תיירים פרימיום וגם אם לא.
economy	int32 פליטות לנוסע אחד במחלקת תיירים בגרמים. השדה הזה תמיד מחושב ומאוכלס, גם אם במטוס יש מושבים במחלקת תיירים וגם אם לא.

טיסה

כל הפרטים שקשורים לפריט בקשה יחיד לאומדני פליטות של טיסה ישירה.

שדות
origin	string חובה. קוד IATA של נמל התעופה שממנו הטיסה ממריאה, למשל LHR.
destination	string חובה. קוד IATA של נמל התעופה שבו הטיסה נוחתת, לדוגמה: 'JFK'.
operating_carrier_code	string חובה. קוד חברת התעופה של IATA, לדוגמה, 'AA'.
flight_number	int32 חובה. מספר טיסה, לדוגמה 324.
departure_date	Date חובה. תאריך הטיסה באזור הזמן של נמל התעופה שממנו ממריאים. התאריך חייב להיות בהווה או בעתיד.

FlightWithEmissions

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

שדות
flight	Flight חובה. תואם למזהי הטיסות בבקשה. הערה: כל קודי ה-IATA הם באותיות רישיות.
source	Source אופציונלי. המקור של נתוני הפליטות.
emissions_grams_per_pax	EmissionsGramsPerPax אופציונלי. מספרים של הערכות פליטה לכל נוסע. העמודה לא תופיע אם לא ניתן לחשב את פליטת הפחמן. רשימת הסיבות לכך שלא ניתן לחשב את פליטת הפחמן מופיעה במאמר ComputeFlightEmissions.
easa_label_metadata	EasaLabelMetadata אופציונלי. מטא-נתונים על EASA Flight Emissions Label (תווית פליטות הטיסה של הסוכנות האירופית לבטיחות תעופה). הערך מוגדר רק כשמקור נתוני הפליטות הוא EASA.
contrails_impact_bucket	ContrailsImpactBucket אופציונלי. המשמעות של השפעת ההתחממות של פסי ההתעבות בהשוואה להשפעה הכוללת של פליטות CO2e.

שוק

זוג שדות תעופה.

שדות
origin	string חובה. קוד IATA של נמל התעופה שממנו הטיסה ממריאה, למשל LHR.
destination	string חובה. קוד IATA של נמל התעופה שבו הטיסה נוחתת, לדוגמה: 'JFK'.

ModelVersion

גרסת מודל ההשפעה של הנסיעות. מידע נוסף על ניהול גרסאות של מודלים זמין ב-GitHub.

שדות
major	int32 גרסאות ראשיות: שינויים משמעותיים במתודולוגיה (למשל, הוספה של מקורות נתונים חדשים למודל שמובילה לשינויים משמעותיים בתוצאות). שינויים כאלה יתבצעו לעיתים רחוקות, ונודיע עליהם מראש. יכול להיות שיהיו שינויים בגרסת ה-API, בהתאם להנחיות של Google Cloud API
minor	int32 גרסאות משניות: שינויים במודל, שמתבצעים באופן עקבי בגרסאות הסכימה, אבל משנים את הפרמטרים או את ההטמעה של המודל.
patch	int32 גרסאות תיקון: שינויים בהטמעה שנועדו לטפל בבאגים או בחוסר דיוק בהטמעה של המודל.
dated	string גרסאות עם תאריך: מערכי הנתונים של המודלים נוצרים מחדש עם נתוני קלט מעודכנים, אבל ללא שינוי באלגוריתמים באופן קבוע.

Scope3FlightEmissions

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

שדות
flight	Scope3FlightSegment חובה. תואם למזהי הטיסות בבקשה.
wtw_emissions_grams_per_pax	int64 אופציונלי. פליטות כוללות מטיסה (סכום הפליטות מ-well-to-tank ומ-tank-to-wake) לכל נוסע, על סמך המידע המבוקש. אלה הפליטות הכוללות, ואם אין לכם סיבות ספציפיות להשתמש בפליטות מ-TTW או מ-WTT, כדאי להשתמש במספר הזה.
ttw_emissions_grams_per_pax	int64 אופציונלי. פליטות מטיסה מדלק ועד המראה לכל נוסע, על סמך המידע שביקשת.
wtt_emissions_grams_per_pax	int64 אופציונלי. פליטות מטיסה לכל נוסע, מהבאר ועד למיכל הדלק, על סמך המידע שביקשת.
source	Scope3DataType אופציונלי. המקור של נתוני הפליטות.

Scope3DataType

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

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

Scope3FlightSegment

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

שדות
departure_date	Date חובה. תאריך הטיסה באזור הזמן של נמל התעופה שממנו ממריאים. במודלים של פליטות אופייניות בטיסה ובמודלים של פליטות שמבוססים על מרחק, נדרשת רק השנה (המערכת מתעלמת מהערכים של החודש והיום, ולכן אפשר להשמיט אותם, להגדיר אותם כ-0 או להגדיר אותם כתאריך תקין). בהתאם לכך, אם לא יסופק תאריך ספציפי לפליטות של TIM, נחזור לפליטות אופייניות של טיסה (או לפליטות שמבוססות על מרחק).
cabin_class	CabinClass חובה. המחלקה במטוס.
origin	string אופציונלי. קוד IATA של נמל התעופה שממנו הטיסה ממריאה, לדוגמה YVR. הפרמטר הזה משמש להתאמה של טיסה ספציפית אם הוא מסופק לצד היעד, חברת התעופה ומספר הטיסה. אם לא נמצאה התאמה, ננסה קודם להתאים את הטיסה לטיסה רגילה בין שדות התעופה של המוצא והיעד שצוינו. אחרת, נשתמש במודל הפליטות שמבוסס על מרחק, אם מרחק הטיסה מסופק.
destination	string אופציונלי. קוד IATA של נמל התעופה שבו הטיסה נוחתת, לדוגמה ICN. הפרמטר הזה משמש להתאמה של טיסה ספציפית אם הוא מסופק לצד נקודת המוצא, חברת התעופה ומספר הטיסה. אם לא נמצאה התאמה, ננסה קודם להתאים את הטיסה לטיסה רגילה בין שדות התעופה של המוצא והיעד שצוינו. אחרת, נשתמש במודל הפליטות שמבוסס על מרחק, אם מרחק הטיסה מסופק.
carrier_code	string אופציונלי. קוד חברת תעופה של IATA, למשל KE. ההגדרה הזו נדרשת אם רוצים להתאים טיסות ספציפיות. אחרת, המשתנה הזה לא בשימוש במודלים אופייניים של פליטות שמבוססים על טיסה ומרחק. הקוד יכול להיות קוד של חברת תובלה שמתפעלת את הטיסה וגם קוד שיווקי של חברת תובלה (כלומר, קוד שיתוף מכוסה).
flight_number	int32 אופציונלי. מספר טיסה, למשל 71. הפרמטר הזה משמש קודם כול להתאמה של טיסה ספציפית אם מציינים מספר טיסה לצד נקודת המוצא, היעד וחברת התעופה. אם לא מציינים מספר טיסה, ננסה קודם להתאים את הטיסה לטיסה טיפוסית בין שדות התעופה שצוינו כנקודת מוצא ויעד. אם זה לא יצליח או אם לא יסופקו נתוני המקור והיעד, נשתמש במודל פליטות שמבוסס על מרחק, על סמך מרחק הטיסה שסופק.
distance_km	int64 אופציונלי. המרחק בקילומטרים, למשל 2423. המאפיין הזה משמש להתאמת טיסה לפליטות שמבוססות על מרחק, אם לא צוינו נקודת המוצא והיעד או אם אין טיסות אופייניות תואמות. השדה הזה תומך בערכים בין 0 ל-2.5e16 ק"מ.

CabinClass

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

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

מקור

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

טיפוסים בני מנייה (enum)
SOURCE_UNSPECIFIED	מקור נתוני הפליטות לא צוין.
TIM	נתוני הפליטות מגיעים ממודל ההשפעה של נסיעות.
EASA	נתוני הפליטות מגיעים מתוויות הסביבה של EASA.

TypicalFlightEmissions

אומדני פליטות אופייניים בטיסה בשוק מסוים

שדות
market	Market חובה. תואם למזהי הטיסות בבקשה. הערה: כל קודי ה-IATA הם באותיות רישיות.
emissions_grams_per_pax	EmissionsGramsPerPax אופציונלי. פליטות פחמן אופייניות בטיסה לכל נוסע בשוק המבוקש. הערך לא יופיע אם לא ניתן היה לחשב את פליטת הפחמן האופיינית. רשימת הסיבות שבגללן לא ניתן לחשב את פליטת הפחמן האופיינית של טיסה מופיעה ב-GitHub.