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 (سرشماری)
• TypicalFlightEmissions (پیام)

TravelImpactModelService

API برای ارائه برآورد انتشار کربن.

ComputeFlightEmissions

rpc ComputeFlightEmissions( ComputeFlightEmissionsRequest ) returns ( ComputeFlightEmissionsResponse ) روش بدون تابعیت برای بازیابی برآوردهای انتشار جزئیات نحوه محاسبه برآورد انتشار در GitHub است پاسخ شامل تمام ورودی‌هایی است که با پایه‌های پرواز ورودی مطابقت دارند، به همان ترتیب. اگر هیچ تخمینی برای یک پرواز مشخص وجود نداشته باشد، پاسخ جسم پای پرواز را با میدان‌های انتشار خالی برمی‌گرداند. درخواست همچنان موفق تلقی خواهد شد. دلایل عدم برآورد انتشار عبارتند از: پرواز برای سرور ناشناخته است. پای پرواز ورودی یک یا چند شناسه ندارد. تاریخ پرواز در گذشته است. نوع هواپیما توسط مدل پشتیبانی نمی شود. پیکربندی صندلی وجود ندارد. این درخواست می‌تواند تا 1000 پای پرواز داشته باشد. اگر درخواست بیش از 1000 پرواز مستقیم داشته باشد، اگر با خطای INVALID_ARGUMENT ناموفق خواهد بود.

ComputeScope3FlightEmissions

rpc ComputeScope3FlightEmissions( ComputeScope3FlightEmissionsRequest ) returns ( ComputeScope3FlightEmissionsResponse ) روش بدون حالت برای بازیابی برآوردهای انتشار گازهای گلخانه ای برای مجموعه ای از بخش های پرواز برای گزارش محدوده 3. پاسخ شامل تمام ورودی‌هایی است که با بخش‌های پرواز ورودی Scope3FlightSegment مطابقت دارند، به همان ترتیب ارائه‌شده. تخمین ها با استفاده از منطق آبشاری زیر (با استفاده از اولین مورد موجود) محاسبه خواهند شد: انتشارات مبتنی بر TIM origin ، destination ، carrier ، flightNumber ، departureDate ، و cabinClass . انتشارات معمولی پرواز با توجه به origin ، destination ، سال در departureDate ، و cabinClass . گازهای گلخانه ای مبتنی بر فاصله با استفاده از distanceKm ، سال در departureDate ، و cabinClass محاسبه شده است. اگر درخواست پرواز آینده در این سال تقویمی وجود داشته باشد، از انتشار گازهای گلخانه‌ای سطح 1 پشتیبانی نمی‌کنیم و به انتشارات سطح 2 یا 3 برمی‌گردیم. اگر پرواز آینده درخواستی در این سال تقویمی نباشد، ما یک پاسخ خالی را برمی گردانیم. توصیه می کنیم که برای پروازهای آینده، به جای آن از computeFlightEmissions API استفاده شود. اگر هیچ تخمینی برای یک پرواز خاص با هر یک از این سه روش وجود نداشته باشد، پاسخ یک شی Scope3FlightEmissions با فیلدهای انتشار خالی را برمی گرداند. درخواست همچنان موفق تلقی خواهد شد. به طور کلی، تخمین‌های آلاینده‌های از دست رفته زمانی اتفاق می‌افتد که پرواز برای سرور ناشناخته باشد (مثلاً پرواز خاصی وجود ندارد، یا انتشار گازهای گلخانه‌ای معمولی برای جفت درخواست‌شده در دسترس نیست). درخواست با خطای INVALID_ARGUMENT شکست خواهد خورد اگر: درخواست شامل بیش از 1000 پای پرواز است. پای پرواز ورودی یک یا چند شناسه ندارد. به عنوان مثال، از دست دادن مبدا/مقصد بدون فاصله معتبر برای تطابق نوع TIM_EMISSIONS یا TYPICAL_FLIGHT_EMISSIONS ، یا فاصله از دست رفته برای تطابق نوع DISTANCE_BASED_EMISSIONS (اگر می‌خواهید به انتشارات مبتنی بر فاصله برگردید یا می‌خواهید یک برآورد انتشار بر اساس مسافت را مشخص کنید، باید یک تخمین مشخص کنید). تاریخ پرواز قبل از سال 2019 است (داده های Scope 3 فقط برای سال 2019 و بعد از آن در دسترس هستند). فاصله پرواز 0 یا کمتر است. گم شدن کلاس کابین از آنجایی که درخواست با منطق بازگشتی پردازش می‌شود، ممکن است درخواست‌های پیکربندی نادرست با استفاده از روش‌های بازگشتی، تخمین‌های انتشار معتبر را برگردانند. به عنوان مثال، اگر درخواستی شماره پرواز اشتباهی داشته باشد اما مبدا و مقصد را مشخص کند، درخواست همچنان موفق خواهد بود، اما انتشار آلاینده‌های برگشتی تنها بر اساس انتشار معمولی پرواز خواهد بود. به طور مشابه، اگر درخواستی مبدأ درخواست انتشار گازهای گلخانه ای معمولی را از دست داده باشد، اما فاصله معتبری را مشخص کند، این درخواست می تواند تنها بر اساس انتشارات مبتنی بر فاصله موفق شود. در نتیجه، باید منبع انتشار آلاینده های برگشتی ( source ) را بررسی کرد تا نتایج مطابق انتظار باشد.

ComputeTypicalFlightEmissions

rpc ComputeTypicalFlightEmissions( ComputeTypicalFlightEmissionsRequest ) returns ( ComputeTypicalFlightEmissionsResponse ) تخمین‌های معمولی انتشار گازهای گلخانه‌ای بین دو فرودگاه را که بازار نیز نامیده می‌شود، بازیابی می‌کند. اگر هیچ تخمینی برای یک بازار خاص وجود نداشته باشد، پاسخ، شی بازار را با میدان‌های انتشار خالی برمی‌گرداند. درخواست همچنان موفق تلقی خواهد شد. جزئیات نحوه محاسبه تخمین های معمولی انتشار در GitHub موجود است. این درخواست می تواند تا 1000 بازار را شامل شود. اگر درخواست بیش از 1000 بازار داشته باشد، با خطای INVALID_ARGUMENT شکست می خورد.

ComputeFlightEmissionsRequest

تعریف ورودی برای درخواست ComputeFlightEmissions .

فیلدها
flights[]	Flight مورد نیاز. پروازهای مستقیم به بازگشت تخمین آلاینده برای.

ComputeFlightEmissionsResponse

تعریف خروجی برای پاسخ ComputeFlightEmissions .

فیلدها
flight_emissions[]	FlightWithEmissions فهرست پاهای پرواز با برآورد انتشار.
model_version	ModelVersion نسخه مدلی که بر اساس آن برآورد انتشار برای همه پروازها در این پاسخ محاسبه شد.

ComputeScope3FlightEmissionsRequest

فهرستی از بخش‌های پرواز برای درخواست انتشارات Scope 3.

فیلدها
flights[]	Scope3FlightSegment مورد نیاز. پروازها برای بازگشت تخمین آلایندگی برای.
model_version	ModelVersion اختیاری. نسخه مدلی که براساس آن برآورد انتشار برای همه پروازها در این درخواست محاسبه شده است.

ComputeScope3FlightEmissionsResponse

فهرستی از پروازها با تخمین‌های آلایندگی محدوده 3.

فیلدها
flight_emissions[]	Scope3FlightEmissions فهرست بخش‌های پرواز با برآورد انتشار.
model_version	ModelVersion نسخه مدلی که بر اساس آن برآورد انتشار برای همه پروازها در این پاسخ محاسبه شد.

ComputeTypicalFlightEmissionsRequest

فهرستی از جفت فرودگاه ها (بازارها) برای درخواست آلاینده های معمولی.

فیلدها
markets[]	Market مورد نیاز. تخمین های معمولی انتشار گازهای گلخانه ای را برای این جفت بازار درخواست کنید. حداکثر 1000 بازار قابل درخواست است.

ComputeTypicalFlightEmissionsResponse

پاسخ شامل انتشار گازهای گلخانه ای و همچنین نسخه مدل است.

فیلدها
typical_flight_emissions[]	TypicalFlightEmissions انتشارات پرواز معمولی بازار درخواست شده است.
model_version	ModelVersion نسخه مدلی که بر اساس آن برآورد انتشار معمولی پرواز برای همه پروازها در این پاسخ محاسبه شد.

ContrailsImpactBucket

اهمیت تأثیر گرم شدن contrails در مقایسه با تأثیر کل انتشار CO2e.

Enums
CONTRAILS_IMPACT_UNSPECIFIED	تاثیر contrails نامشخص است.
CONTRAILS_IMPACT_NEGLIGIBLE	تاثیر contrails در مقایسه با انتشار کل CO2e ناچیز است.
CONTRAILS_IMPACT_MODERATE	تاثیر contrails با کل انتشار CO2e قابل مقایسه است.
CONTRAILS_IMPACT_SEVERE	تأثیر contrails بیشتر از تأثیر کل انتشار CO2e است.

EasaLabel Metadata

فراداده در مورد برچسب انتشارات پرواز EASA.

فیلدها
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 مورد نیاز. کد فرودگاه یاتا برای مبدا پرواز، به عنوان مثال "LHR".
destination	string مورد نیاز. کد فرودگاه یاتا برای مقصد پرواز، به عنوان مثال "JFK".
operating_carrier_code	string مورد نیاز. کد حامل یاتا، به عنوان مثال "AA".
flight_number	int32 مورد نیاز. شماره پرواز، به عنوان مثال 324.
departure_date	Date مورد نیاز. تاریخ پرواز در منطقه زمانی فرودگاه مبدا. باید تاریخی در حال یا آینده باشد.

FlightWithEmissions

پرواز مستقیم با تخمین آلایندگی

فیلدها
flight	Flight مورد نیاز. با شناسه های پرواز در درخواست مطابقت دارد. توجه: تمام کدهای یاتا با حروف بزرگ نوشته شده اند.
source	Source اختیاری. منبع داده های انتشار
emissions_grams_per_pax	EmissionsGramsPerPax اختیاری. اعداد برآورد انتشار گازهای گلخانه ای به ازای هر مسافر اگر انتشار گازهای گلخانه ای قابل محاسبه نباشد، وجود نخواهد داشت. برای فهرست دلایلی که چرا انتشارات را نمی توان محاسبه کرد، ComputeFlightEmissions ببینید.
easa_label_metadata	EasaLabelMetadata اختیاری. فراداده در مورد برچسب انتشارات پرواز EASA. فقط زمانی تنظیم شود که منبع داده انتشار EASA باشد.
contrails_impact_bucket	ContrailsImpactBucket اختیاری. اهمیت تأثیر گرم شدن contrails در مقایسه با تأثیر کل انتشار CO2e.

بازار

یک جفت فرودگاه

فیلدها
origin	string مورد نیاز. کد فرودگاه یاتا برای مبدا پرواز، به عنوان مثال "LHR".
destination	string مورد نیاز. کد فرودگاه یاتا برای مقصد پرواز، به عنوان مثال "JFK".

ModelVersion

نسخه Travel Impact Model. برای اطلاعات بیشتر در مورد نسخه‌سازی مدل به GitHub مراجعه کنید.

فیلدها
major	int32 نسخه های اصلی: تغییرات عمده در روش (مانند افزودن منابع داده جدید به مدل که منجر به تغییرات عمده خروجی می شود). چنین تغییراتی نادر خواهد بود و از قبل اعلام می شود. ممکن است شامل تغییرات نسخه API باشد که به دستورالعمل‌های Google Cloud API احترام می‌گذارد
minor	int32 نسخه‌های جزئی: تغییراتی در مدلی که در عین اینکه در نسخه‌های طرحواره سازگار است، پارامترهای مدل یا پیاده‌سازی را تغییر می‌دهد.
patch	int32 نسخه‌های وصله: تغییرات پیاده‌سازی به منظور رفع اشکال یا عدم دقت در اجرای مدل.
dated	string نسخه‌های دارای تاریخ: مجموعه داده‌های مدل با داده‌های ورودی تازه‌سازی‌شده، اما هیچ تغییری در الگوریتم‌ها به‌طور منظم ایجاد می‌شوند.

Scope3FlightEmissions

پرواز محدوده 3 با برآورد انتشار.

فیلدها
flight	Scope3FlightSegment مورد نیاز. با شناسه های پرواز در درخواست مطابقت دارد.
wtw_emissions_grams_per_pax	int64 اختیاری. مجموع گازهای گلخانه ای پرواز (مجموع چاه تانک و تانک به بیدار) به ازای هر مسافر بر اساس اطلاعات درخواستی. این مجموع انتشار است و مگر اینکه دلایل خاصی برای استفاده از انتشارات TTW یا WTT داشته باشید، باید از این عدد استفاده کنید.
ttw_emissions_grams_per_pax	int64 اختیاری. انتشارات پرواز تانک به بیدار به ازای هر مسافر بر اساس اطلاعات درخواستی.
wtt_emissions_grams_per_pax	int64 اختیاری. انتشار گازهای گلخانه‌ای پرواز به ازای هر مسافر بر اساس اطلاعات درخواستی.
source	Scope3DataType اختیاری. منبع داده های انتشار

Scope3DataType

نوع تطبیق مورد استفاده برای محاسبه انتشارات محدوده 3. این برای پاسخ Scope 3 استفاده می شود، که مشخص می کند کدام یک از روش ها برای محاسبه انتشار استفاده شده است.

Enums
SCOPE3_DATA_TYPE_UNSPECIFIED	نوع داده نامشخص
TIM_EMISSIONS	انتشارات مبتنی بر TIM مبدا، مقصد، حامل، شماره پرواز، تاریخ عزیمت و سال.
TYPICAL_FLIGHT_EMISSIONS	انتشارات معمولی پرواز با توجه به مبدا، مقصد و سال.
DISTANCE_BASED_EMISSIONS	انتشار بر اساس مسافت بر اساس مسافت طی شده و سال.

Scope3FlightSegment

پارامترهای پرواز که با آنها انتشارات Scope 3 واکشی می شود.

فیلدها
departure_date	Date مورد نیاز. تاریخ پرواز در منطقه زمانی فرودگاه مبدا. فقط سال برای مدل‌های انتشار معمولی پرواز و مسافت مورد نیاز است (مقادیر ماه و روز نادیده گرفته می‌شوند و بنابراین، می‌توان آنها را حذف کرد، روی 0 تنظیم کرد یا برای آن موارد روی یک تاریخ معتبر تنظیم کرد). به همین ترتیب، اگر تاریخ خاصی برای انتشار آلاینده‌های TIM ارائه نشده باشد، به انتشارات معمولی پرواز (یا بر اساس مسافت) بازمی‌گردیم.
cabin_class	CabinClass مورد نیاز. کلاس کابین پرواز.
origin	string اختیاری. کد فرودگاه یاتا برای مبدا پرواز، به عنوان مثال YVR . اگر در کنار مقصد، شرکت مخابراتی و شماره پرواز ارائه شود، برای مطابقت با پرواز خاص استفاده می‌شود. در صورت عدم تطابق، ابتدا سعی می کنیم پرواز را با یک پرواز معمولی بین فرودگاه مبدأ و مقصد ارائه شده مطابقت دهیم. در غیر این صورت در صورت ارائه مسافت پرواز از مدل انتشار گازهای گلخانه ای مبتنی بر فاصله استفاده خواهیم کرد.
destination	string اختیاری. کد فرودگاه یاتا برای مقصد پرواز، به عنوان مثال ICN . اگر در کنار مبدا، حامل و شماره پرواز ارائه شود، از این برای مطابقت با پرواز خاص استفاده می‌شود. در صورت عدم تطابق، ابتدا سعی می کنیم پرواز را با یک پرواز معمولی بین فرودگاه مبدأ و مقصد ارائه شده مطابقت دهیم. در غیر این صورت در صورت ارائه مسافت پرواز از مدل انتشار گازهای گلخانه ای مبتنی بر فاصله استفاده خواهیم کرد.
carrier_code	string اختیاری. کد حامل یاتا، به عنوان مثال KE . اگر تطابق پرواز خاصی مورد نظر باشد، این مورد ضروری است. در غیر این صورت، این برای مدل‌های معمولی پرواز و انتشار گازهای گلخانه‌ای مبتنی بر مسافت استفاده نمی‌شود. این می تواند هم کد حامل عملیاتی و هم بازاریابی باشد (یعنی اشتراک کد پوشش داده شده است).
flight_number	int32 اختیاری. شماره پرواز، به عنوان مثال 71 . اگر شماره پرواز در کنار مبدا، مقصد و شرکت حامل مشخص شده باشد، ابتدا برای مطابقت با یک پرواز خاص استفاده می شود. اگر شماره پروازی مشخص نشده باشد، ابتدا سعی می کنیم پرواز را با یک پرواز معمولی بین فرودگاه های مبدأ و مقصد ارائه شده مطابقت دهیم. در صورت عدم موفقیت و/یا عدم ارائه مبدأ و مقصد، از مدل انتشار گازهای گلخانه ای مبتنی بر فاصله بر اساس فاصله پرواز ارائه شده استفاده خواهیم کرد.
distance_km	int64 اختیاری. فاصله بر حسب کیلومتر، به عنوان مثال 2423 . این برای تطبیق یک پرواز با انتشار گازهای گلخانه‌ای مبتنی بر فاصله زمانی که مبدا و مقصد ارائه نشده‌اند یا پروازهای معمولی مشابهی وجود ندارد، استفاده می‌شود. این فیلد مقادیر بین 0 تا 2.5e16 کیلومتر را پشتیبانی می کند.

کلاس کابین

کلاس کابین پرواز.

Enums
CABIN_CLASS_UNSPECIFIED	کلاس کابین نامشخص
ECONOMY	کلاس اقتصادی.
PREMIUM_ECONOMY	کلاس اقتصادی ممتاز.
BUSINESS	کلاس تجاری.
FIRST	درجه یک.

منبع

منبع داده های انتشار

Enums
SOURCE_UNSPECIFIED	منبع داده های انتشار نامشخص است.
TIM	داده های انتشار از مدل تاثیر سفر است.
EASA	داده های انتشار از برچسب های زیست محیطی EASA است.

TypicalFlightEmissions

تخمین های معمولی انتشار پرواز برای یک بازار خاص

فیلدها
market	Market مورد نیاز. با شناسه های پرواز در درخواست مطابقت دارد. توجه: تمام کدهای یاتا با حروف بزرگ نوشته شده اند.
emissions_grams_per_pax	EmissionsGramsPerPax اختیاری. انتشار معمولی پرواز به ازای هر مسافر برای بازار درخواستی. اگر انتشار معمولی قابل محاسبه نباشد، وجود نخواهد داشت. برای فهرستی از دلایلی که چرا انتشار معمولی پرواز را نمی توان محاسبه کرد، به GitHub مراجعه کنید.