Package google.travel.sustainability.travelimpactmodel.v1

فهرست

سرویس TravelImpactModel

API برای ارائه تخمین‌های انتشار کربن.

محاسبه دقیق میزان انتشار گازهای گلخانه‌ای پرواز

rpc ComputeDetailedFlightEmissions( ComputeDetailedFlightEmissionsRequest ) returns ( ComputeDetailedFlightEmissionsResponse )

تخمین‌های دقیق انتشار را بازیابی می‌کند.

انتشار گازهای گلخانه‌ای دقیق پرواز، تخمین‌های شفافی از میزان انتشار گازهای گلخانه‌ای به ازای هر مسافر هستند که با فراداده‌های جامعی که روش محاسبه، تفکیک انتشار گازهای گلخانه‌ای، تأثیر پسدمه‌ها و منشأ داده‌ها را شرح می‌دهند، تکمیل می‌شوند.

جزئیات مربوط به نحوه محاسبه تخمین انتشار گازهای گلخانه‌ای در گیت‌هاب موجود است.

پاسخ شامل تمام ورودی‌هایی خواهد بود که با مراحل پرواز ورودی، به همان ترتیب، مطابقت دارند. اگر هیچ تخمینی برای یک مرحله پرواز خاص در دسترس نباشد، پاسخ شیء مرحله پرواز را با فیلدهای انتشار خالی برمی‌گرداند. درخواست همچنان موفقیت‌آمیز تلقی می‌شود. دلایل عدم وجود تخمین‌های انتشار عبارتند از:

  • پرواز برای سرور ناشناخته است.
  • پای پرواز ورودی فاقد یک یا چند شناسه است.
  • تاریخ پرواز مربوط به گذشته است.
  • نوع هواپیما توسط مدل پشتیبانی نمی‌شود.
  • پیکربندی صندلی موجود نیست.

این درخواست می‌تواند شامل حداکثر ۱۰۰ مرحله پرواز باشد. اگر درخواست بیش از ۱۰۰ مرحله پرواز داشته باشد، با خطای INVALID_ARGUMENT مواجه خواهد شد.

ComputeFlightEmissions

rpc ComputeFlightEmissions( ComputeFlightEmissionsRequest ) returns ( ComputeFlightEmissionsResponse )

تخمین‌های انتشار را بازیابی می‌کند. جزئیات نحوه محاسبه تخمین‌های انتشار در GitHub موجود است.

پاسخ شامل تمام ورودی‌هایی خواهد بود که با مراحل پرواز ورودی، به همان ترتیب، مطابقت دارند. اگر هیچ تخمینی برای یک مرحله پرواز خاص در دسترس نباشد، پاسخ شیء مرحله پرواز را با فیلدهای انتشار خالی برمی‌گرداند. درخواست همچنان موفقیت‌آمیز تلقی می‌شود. دلایل عدم وجود تخمین‌های انتشار عبارتند از:

  • پرواز برای سرور ناشناخته است.
  • پای پرواز ورودی فاقد یک یا چند شناسه است.
  • تاریخ پرواز مربوط به گذشته است.
  • نوع هواپیما توسط مدل پشتیبانی نمی‌شود.
  • پیکربندی صندلی موجود نیست.

این درخواست می‌تواند شامل حداکثر ۱۰۰۰ مرحله پرواز باشد. اگر درخواست بیش از ۱۰۰۰ پرواز مستقیم داشته باشد، با خطای INVALID_ARGUMENT مواجه خواهد شد.

ComputeScope3FlightEmissions

rpc ComputeScope3FlightEmissions( ComputeScope3FlightEmissionsRequest ) returns ( ComputeScope3FlightEmissionsResponse )

تخمین‌های انتشار گازهای گلخانه‌ای را برای مجموعه‌ای از بخش‌های پروازی برای گزارش‌دهی Scope 3 بازیابی می‌کند.

پاسخ شامل تمام ورودی‌هایی خواهد بود که با بخش‌های پرواز ورودی Scope3FlightSegment مطابقت دارند، به همان ترتیب ارائه شده. تخمین‌ها با استفاده از منطق آبشاری زیر (با استفاده از اولین مورد موجود) محاسبه می‌شوند:

  1. انتشار گازهای گلخانه‌ای مبتنی بر TIM با توجه به origin ، destination ، carrier ، flightNumber ، departureDate و cabinClass .
  2. میزان انتشار گازهای گلخانه‌ای معمول در پروازها با توجه به origin ، destination ، سال departureDate و cabinClass .
  3. میزان انتشار گازهای گلخانه‌ای مبتنی بر مسافت با استفاده از distanceKm ، سال در departureDate و cabinClass محاسبه می‌شود.

اگر پروازی در آینده در این سال تقویمی درخواست شود، ما از سطح انتشار گازهای گلخانه‌ای سطح ۱ پشتیبانی نمی‌کنیم و به سطح انتشار گازهای گلخانه‌ای سطح ۲ یا ۳ رجوع خواهیم کرد. اگر پرواز آینده درخواستی در این سال تقویمی نباشد، یک پاسخ خالی برمی‌گردانیم. توصیه می‌کنیم برای پروازهای آینده، به جای آن از رابط برنامه‌نویسی کاربردی computeFlightEmissions استفاده شود.

اگر هیچ تخمینی برای یک پرواز خاص با هیچ یک از سه روش موجود نباشد، پاسخ یک شیء Scope3FlightEmissions با فیلدهای انتشار خالی را برمی‌گرداند. درخواست همچنان موفق تلقی می‌شود. به طور کلی، تخمین‌های انتشار از دست رفته زمانی رخ می‌دهند که پرواز برای سرور ناشناخته باشد (مثلاً هیچ پرواز خاصی وجود ندارد، یا انتشار معمول پرواز برای جفت درخواستی در دسترس نیست).

اگر موارد زیر را داشته باشید، درخواست با خطای INVALID_ARGUMENT با شکست مواجه خواهد شد:

  • این درخواست شامل بیش از ۱۰۰۰ مرحله پرواز است.
  • بخش پرواز ورودی فاقد یک یا چند شناسه است. برای مثال، مبدأ/مقصد بدون فاصله معتبر برای تطبیق نوع TIM_EMISSIONS یا TYPICAL_FLIGHT_EMISSIONS ، یا فاصله برای تطبیق نوع DISTANCE_BASED_EMISSIONS وجود ندارد (اگر می‌خواهید به انتشار گازهای گلخانه‌ای مبتنی بر فاصله برگردید یا تخمین انتشار گازهای گلخانه‌ای مبتنی بر فاصله را می‌خواهید، باید فاصله را مشخص کنید).
  • تاریخ پرواز قبل از سال ۲۰۱۹ است (داده‌های Scope 3 فقط برای سال ۲۰۱۹ و پس از آن در دسترس است).
  • مسافت پرواز صفر یا کمتر است.
  • کلاس کابین از دست رفته.

از آنجا که درخواست با منطق پشتیبان پردازش می‌شود، ممکن است درخواست‌های پیکربندی‌شده‌ی نادرست، تخمین‌های معتبری از میزان انتشار گازهای گلخانه‌ای را با استفاده از روش‌های پشتیبان برگردانند. به عنوان مثال، اگر درخواستی شماره پرواز اشتباهی داشته باشد اما مبدا و مقصد را مشخص کند، درخواست همچنان موفق خواهد بود، اما میزان انتشار گازهای گلخانه‌ای بازگشتی صرفاً بر اساس میزان انتشار گازهای گلخانه‌ای معمول پرواز خواهد بود. به طور مشابه، اگر درخواستی مبدا یک درخواست معمول انتشار گازهای گلخانه‌ای پرواز را مشخص نکند، اما فاصله معتبری را مشخص کند، درخواست می‌تواند صرفاً بر اساس میزان انتشار گازهای گلخانه‌ای مبتنی بر فاصله موفق شود. در نتیجه، باید منبع انتشار گازهای گلخانه‌ای بازگشتی ( source ) را بررسی کرد تا تأیید شود که نتایج مطابق انتظار هستند.

محاسبه‌ی میزان انتشار گازهای گلخانه‌ای پرواز معمولی

rpc ComputeTypicalFlightEmissions( ComputeTypicalFlightEmissionsRequest ) returns ( ComputeTypicalFlightEmissionsResponse )

تخمین‌های معمول انتشار گازهای گلخانه‌ای پروازهای بین دو فرودگاه، که به عنوان بازار نیز شناخته می‌شود، را بازیابی می‌کند. اگر هیچ تخمینی برای یک بازار خاص در دسترس نباشد، پاسخ، شیء بازار را با فیلدهای انتشار خالی برمی‌گرداند. درخواست همچنان موفقیت‌آمیز تلقی می‌شود.

جزئیات مربوط به نحوه محاسبه تخمین‌های معمول انتشار گازهای گلخانه‌ای در GitHub موجود است.

این درخواست می‌تواند شامل حداکثر ۱۰۰۰ بازار باشد. اگر درخواست بیش از ۱۰۰۰ بازار داشته باشد، با خطای INVALID_ARGUMENT مواجه خواهد شد.

محاسبه‌ی درخواست انتشار گازهای گلخانه‌ای پرواز با جزئیات

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

فیلدها
flights[]

Flight

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

محاسبه دقیق پاسخ انتشار گازهای گلخانه‌ای پرواز

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

فیلدها
flights_with_detailed_emissions[]

FlightWithDetailedEmissions

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

model_version

ModelVersion

نسخه مدلی که تحت آن تخمین‌های انتشار برای همه پروازها در این پاسخ محاسبه شد.

درخواست انتشار گازهای گلخانه‌ای ComputeFlight

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

فیلدها
flights[]

Flight

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

پاسخ به انتشار گازهای گلخانه‌ای در پرواز محاسباتی

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

فیلدها
flight_emissions[]

FlightWithEmissions

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

model_version

ModelVersion

نسخه مدلی که تحت آن تخمین‌های انتشار برای همه پروازها در این پاسخ محاسبه شد.

درخواست ComputeScope3FlightEmissions

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

فیلدها
flights[]

Scope3FlightSegment

الزامی. پروازهایی که قرار است تخمین‌های انتشار گازهای گلخانه‌ای را ارائه دهند.

model_version

ModelVersion

اختیاری. نسخه مدلی که تحت آن تخمین‌های انتشار برای همه پروازهای این درخواست محاسبه شده است.

ComputeScope3FlightEmissionsResponse

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

فیلدها
flight_emissions[]

Scope3FlightEmissions

فهرست بخش‌های پروازی به همراه تخمین میزان انتشار گازهای گلخانه‌ای.

model_version

ModelVersion

نسخه مدلی که تحت آن تخمین‌های انتشار برای همه پروازها در این پاسخ محاسبه شد.

درخواست محاسبه‌ی میزان انتشار گازهای گلخانه‌ای پرواز معمولی

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

فیلدها
markets[]

Market

الزامی. تخمین‌های معمول انتشار گازهای گلخانه‌ای پروازی را برای این جفت بازار درخواست کنید. حداکثر ۱۰۰۰ بازار قابل درخواست است.

محاسبه‌ی پاسخ معمول پرواز به انتشار گازهای گلخانه‌ای

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

فیلدها
typical_flight_emissions[]

TypicalFlightEmissions

میزان انتشار گازهای گلخانه‌ای معمول درخواستی بازار.

model_version

ModelVersion

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

سطل ضربه گیر

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

انوم‌ها
CONTRAILS_IMPACT_UNSPECIFIED تأثیر ردّ دنباله‌ها مشخص نیست.
CONTRAILS_IMPACT_NEGLIGIBLE تأثیر گازهای خروجی از اگزوز در مقایسه با کل انتشار CO2e ناچیز است.
CONTRAILS_IMPACT_MODERATE تأثیر این ردها با کل انتشار CO2e قابل مقایسه است.
CONTRAILS_IMPACT_SEVERE تأثیر ردّ هوا (contrails) بیشتر از کل تأثیر انتشار CO2e است.

فراداده برچسب آسان

فراداده درباره برچسب انتشار گازهای گلخانه‌ای پرواز 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 لحاظ نشده است.

تجزیه و تحلیل انتشار گازهای گلخانه‌ای

جزئیات مربوط به بخش‌های مختلف انتشار گازهای گلخانه‌ای از کل مقدار emission_grams_per_pax. مقدار حاصل از تجزیه و تحلیل‌های جمع‌شده باید همیشه برابر با emission_grams_per_pax باشد.

فیلدها
wtt_emissions_grams_per_pax

EmissionsGramsPerPax

اعداد تخمینی انتشار گازهای گلخانه‌ای از چاه تا باک به ازای هر مسافر. اگر نتوان میزان انتشار گازهای گلخانه‌ای را محاسبه کرد، ارائه نخواهد شد. برای فهرست دلایلی که چرا نمی‌توان میزان انتشار گازهای گلخانه‌ای را محاسبه کرد، به ComputeFlightEmissions مراجعه کنید.

ttw_emissions_grams_per_pax

EmissionsGramsPerPax

اعداد تخمینی انتشار گازهای گلخانه‌ای به ازای هر سرنشین از مخزن تا زمان بیدار شدن از خواب. اگر نتوان میزان انتشار گازهای گلخانه‌ای را محاسبه کرد، این اعداد ارائه نخواهند شد. برای فهرست دلایلی که چرا نمی‌توان میزان انتشار گازهای گلخانه‌ای را محاسبه کرد، ComputeFlightEmissions مراجعه کنید.

میزان انتشار (گرم در هر نفر)

نتایج انتشار گازهای گلخانه‌ای گروه‌بندی‌شده به ازای هر کلاس صندلی.

فیلدها
first

int32

میزان انتشار گازهای گلخانه‌ای برای هر مسافر در بخش فرست کلاس بر حسب گرم. این فیلد همیشه محاسبه و پر می‌شود، صرف نظر از اینکه هواپیما صندلی‌های فرست کلاس داشته باشد یا نه.

business

int32

میزان انتشار گازهای گلخانه‌ای برای هر مسافر در کلاس تجاری بر حسب گرم. این فیلد همیشه محاسبه و پر می‌شود، صرف نظر از اینکه هواپیما صندلی‌های کلاس تجاری داشته باشد یا خیر.

premium_economy

int32

میزان انتشار گازهای گلخانه‌ای برای هر مسافر در کلاس اقتصادی ممتاز (پریمیوم اکونومی) بر حسب گرم. این فیلد همیشه محاسبه و پر می‌شود، صرف نظر از اینکه هواپیما صندلی‌های کلاس اقتصادی ممتاز دارد یا خیر.

economy

int32

میزان انتشار گازهای گلخانه‌ای برای هر مسافر در کلاس اکونومی بر حسب گرم. این فیلد همیشه محاسبه و پر می‌شود، صرف نظر از اینکه هواپیما صندلی‌های کلاس اکونومی داشته باشد یا نه.

فراداده‌های انتشار

تمام متادیتای اضافی.

فیلدها
emissions_provenance

EmissionsProvenance

فقط خروجی. جزئیات مربوط به منشأ داده‌های مورد استفاده برای محاسبه داده‌های انتشار، از جمله عوامل مؤثر به همراه منابع داده‌های آنها.

easa_label_metadata

EasaLabelMetadata

فقط خروجی. فراداده درباره برچسب انتشار گازهای گلخانه‌ای پرواز EASA. فقط زمانی تنظیم می‌شود که منبع داده‌های انتشار گازهای گلخانه‌ای EASA باشد.

tim_website_emissions_calculator_url

string

فقط خروجی. پیوند به وب‌سایت travelimpactmodel.org Emissions Calculator. مثال: https://travelimpactmodel.org/lookup/flight?itinerary=ZRH-BOS-LX-52-20261225 .

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

اطلاعات مربوط به منشأ داده‌های مورد استفاده برای محاسبه تخمین انتشار گازهای گلخانه‌ای، شامل عوامل مؤثر و منابع داده‌های آنها.

فیلدها
provenance_entries[]

EmissionsProvenance.EmissionsProvenanceEntry

فقط خروجی. تمام عوامل مؤثر برای محاسبه انتشار گازهای گلخانه‌ای استفاده می‌شوند.

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

جزئیات مربوط به یک عامل مؤثر در محاسبات انتشار گازهای گلخانه‌ای.

فیلدها
provenance_entry_type

EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType

فقط خروجی. نوع ورودی منشأ.

source

EmissionsProvenance.EmissionsProvenanceEntry.DataSource

فقط خروجی. منبع داده‌ها.

source_version

string

فقط خروجی. نسخه داده‌های منبع. به عنوان مثال، "2025/04".

data_category

EmissionsProvenance.EmissionsProvenanceEntry.DataCategory

فقط خروجی. دسته داده منبع داده.

فیلد اتحادیه data_strategy . استراتژی مورد استفاده برای محاسبه انتشار گازهای گلخانه‌ای برای منبع داده داده شده. مجموعه فیلد با نوع data_source مطابقت دارد. data_strategy فقط می‌تواند یکی از موارد زیر باشد:
fuel_burn_eea_strategy

EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy

فقط خروجی. استراتژی برای مصرف سوخت در منطقه اقتصادی اروپا.

load_factors_t100_strategy

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy

فقط خروجی. استراتژی برای ضرایب بار T100.

load_factors_ch_aviation_strategy

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy

فقط خروجی. استراتژی برای ضرایب بار هوانوردی CH.

cargo_mass_fraction_t100_strategy

EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy

فقط خروجی. استراتژی برای کسر جرمی محموله T100.

seat_area_ratio_iata_strategy

EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy

فقط خروجی. استراتژی برای نسبت مساحت صندلی‌های یاتا.

distance_adjustment_strategy

EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy

فقط خروجی. استراتژی برای تنظیم فاصله.

data_value از نوع داده‌ی داده‌ی داده شده (union field). این فیلد با نوع داده‌ی provance_entry_type مطابقت دارد. data_value می‌تواند فقط یکی از موارد زیر باشد:
load_factors_data

double

فقط خروجی. مقدار داده‌های ضرایب بار. اگر تنظیم نشده باشد، مقدار ضرایب بار در دسترس نیست.

cargo_mass_fraction_data

double

فقط خروجی. مقدار کسر جرمی بار. اگر تنظیم نشود، مقدار کسر جرمی بار در دسترس نیست.

seat_area_ratio_data

EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData

فقط خروجی. مقدار نسبت مساحت صندلی برای هر کلاس صندلی. اگر تنظیم نشود، مقدار نسبت مساحت صندلی در دسترس نیست.

estimated_flight_distance_km

int32

فقط خروجی. مسافت تخمینی طی شده در فاز پرواز CCD بر حسب کیلومتر، مقدار محاسبه شده با استفاده از ضریب تعدیل مسافت (DAF). در صورت عدم تنظیم، مقدار مسافت تخمینی پرواز در دسترس نیست.

CargoMassFractionT100

این نوع هیچ فیلدی ندارد.

استراتژی مورد استفاده برای کسر جرمی محموله T100.

استراتژی

استراتژی برای کسر جرمی محموله T100. مقادیر جدید ممکن است در آینده اضافه شوند. مشتریان باید آماده باشند تا با مقادیر شمارشی ناشناخته به خوبی برخورد کنند.

انوم‌ها
STRATEGY_UNSPECIFIED استراتژی مشخص نشده است.
CARRIER_ROUTE_AIRCRAFT_CLASS داده‌ها بر اساس شرکت حمل و نقل، مسیر و کلاس هواپیما.
ROUTE_AIRCRAFT_CLASS داده‌ها بر اساس مسیر و کلاس هواپیما.
DISTANCE_AIRCRAFT_CLASS داده‌ها بر اساس باند مسافت و کلاس هواپیما.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH_AIRCRAFT_CLASS داده‌های تاریخی که شرکت حمل و نقل، مسیر، سال، ماه و کلاس هواپیما را تطبیق می‌دهند.

دسته بندی داده

دسته داده منبع داده. مقادیر جدید ممکن است در آینده اضافه شوند. کلاینت‌ها باید آماده باشند تا مقادیر enum ناشناخته را به خوبی مدیریت کنند.

انوم‌ها
DATA_CATEGORY_UNSPECIFIED دسته بندی داده ها مشخص نشده است.
PRIMARY داده‌های اولیه، همانطور که در ISO 14083 تعریف شده است.
MODELED داده‌های مدل‌سازی شده، مطابق تعریف ISO 14083.
DEFAULT داده‌های مقدار پیش‌فرض، همانطور که در ISO 14083 تعریف شده است.

منبع داده

منبع داده‌ها برای عوامل منشأ انتشار گازهای گلخانه‌ای. مقادیر جدید ممکن است در آینده اضافه شوند. مشتریان باید آماده باشند تا با مقادیر شمارشی ناشناخته به طرز شایسته‌ای برخورد کنند.

انوم‌ها
DATA_SOURCE_UNSPECIFIED منبع داده مشخص نشده است.
EEA داده‌ها توسط آژانس محیط زیست اروپا (EEA) ارائه شده است.
T100 داده‌ها از مجموعه داده‌های T-100، ارائه شده توسط دفتر آمار حمل و نقل ایالات متحده.
CH_AVIATION اطلاعات ارائه شده توسط ch-aviation.
OAG اطلاعات ارائه شده توسط راهنمای رسمی هوانوردی (OAG).
OPERATING_CARRIER داده‌ها توسط اپراتور ارائه شده‌اند.
AIRCRAFT_MODEL_TYPICAL داده‌های معمول بر اساس مدل هواپیما.
GLOBAL_DEFAULT یک مقدار پیش‌فرض سراسری، که زمانی استفاده می‌شود که هیچ منبع داده دیگری در دسترس نباشد.
IATA اطلاعات ارائه شده توسط انجمن بین‌المللی حمل و نقل هوایی (یاتا).
ICL داده‌ها توسط کالج امپریال لندن ارائه شده است.

تنظیم فاصله

این نوع هیچ فیلدی ندارد.

استراتژی مورد استفاده برای تنظیم فاصله.

استراتژی

استراتژی برای تنظیم فاصله. ممکن است در آینده مقادیر جدیدی اضافه شود. کلاینت‌ها باید آماده باشند تا با مقادیر enum ناشناخته به خوبی برخورد کنند.

انوم‌ها
STRATEGY_UNSPECIFIED استراتژی مشخص نشده است.
ORIGIN_DESTINATION ضریب تعدیل فاصله که توسط جفت فرودگاه مبدا و مقصد تعیین می‌شود.
COUNTRY_PAIR ضریب تعدیل فاصله که توسط جفت کشور مبدا و مقصد تعیین می‌شود.
DEFAULT ضریب تعدیل فاصله بر اساس مقدار پیش‌فرض است زیرا ما ضریب تعدیل مختص فرودگاه یا کشور پیدا نکردیم.

نوع ورود

نوع ورودی مبدأ. مقادیر جدید ممکن است در آینده اضافه شوند. کلاینت‌ها باید آماده باشند تا با مقادیر enum ناشناخته به خوبی برخورد کنند.

انوم‌ها
EMISSIONS_PROVENANCE_ENTRY_TYPE_UNSPECIFIED نوع ورودی منشأ نامشخص.
FUEL_BURN نوع ورودی احتراق سوخت.
LOAD_FACTORS نوع ورودی ضرایب بار.
CARGO_MASS_FRACTION نوع ورود کسر جرمی بار.
SEATING_CONFIG نوع ورودی پیکربندی صندلی.
SEAT_AREA_RATIOS نوع ورودی نسبت مساحت صندلی.
DISTANCE_ADJUSTMENT نوع ورودی تنظیم فاصله.

FuelBurnEea

این نوع هیچ فیلدی ندارد.

استراتژی مورد استفاده برای تخمین مصرف سوخت منطقه اقتصادی اروپا.

استراتژی

استراتژی برای مصرف سوخت EEA. ممکن است در آینده مقادیر جدیدی اضافه شود. کلاینت‌ها باید آماده باشند تا با مقادیر enum ناشناخته به خوبی برخورد کنند.

انوم‌ها
STRATEGY_UNSPECIFIED استراتژی مشخص نشده است.
AIRCRAFT_MAPPING_FALLBACK_WITH_CORRECTION_FACTOR ضریب تصحیح استاتیک اعمال شد.
AIRCRAFT_MAPPING_EXACT از نقشه‌برداری دقیق هواپیما استفاده شد.
AIRCRAFT_MAPPING_FALLBACK از نقشه‌برداری هواپیمای پشتیبان استفاده شد.

LoadFactorsهوانوردی

این نوع هیچ فیلدی ندارد.

استراتژی مورد استفاده برای ضرایب بار CH-Aviation.

استراتژی

استراتژی برای ضرایب بار CH-Aviation. مقادیر جدید ممکن است در آینده اضافه شوند. مشتریان باید آماده باشند تا با مقادیر شمارشی ناشناخته به طرز شایسته‌ای برخورد کنند.

انوم‌ها
STRATEGY_UNSPECIFIED استراتژی مشخص نشده است.
CARRIER_MONTH داده‌ها بر اساس شرکت حمل و نقل و ماه سفر.
ACTUAL_CARRIER_YEAR_MONTH داده‌های تاریخی که حامل، سال و ماه را تطبیق می‌دهند.

فاکتورهای بارگذاریT100

این نوع هیچ فیلدی ندارد.

استراتژی مورد استفاده برای ضرایب بار T100.

استراتژی

استراتژی برای ضرایب بار T100. مقادیر جدید ممکن است در آینده اضافه شوند. کلاینت‌ها باید آماده باشند تا مقادیر enum ناشناخته را به خوبی مدیریت کنند.

انوم‌ها
STRATEGY_UNSPECIFIED استراتژی مشخص نشده است.
CARRIER_ROUTE_MONTH داده‌ها بر اساس شرکت حمل و نقل، مسیر و ماه سفر.
CARRIER_MONTH داده‌ها بر اساس شرکت حمل و نقل و ماه سفر.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH داده‌های تاریخی که حامل، مسیر، سال و ماه را تطبیق می‌دهند.

داده‌های نسبت صندلی

مقادیر داده‌های نسبت مساحت صندلی. اقتصاد همیشه ۱.۰ است و به عنوان نقطه مرجع عمل می‌کند؛ مقادیر کلاس دیگر نسبت به اقتصاد هستند. هر ۴ فیلد همیشه تنظیم می‌شوند، چه کلاس صندلی در هواپیما وجود داشته باشد چه نباشد.

فیلدها
first

double

فقط خروجی. مقدار داده کلاس صندلی اول.

business

double

فقط خروجی. مقدار داده کلاس صندلی تجاری.

premium_economy

double

فقط خروجی. مقدار داده‌های صندلی‌های کلاس اقتصادی ممتاز.

economy

double

فقط خروجی. مقدار داده‌های کلاس صندلی‌های اکونومی.

نسبت مساحت صندلی

این نوع هیچ فیلدی ندارد.

استراتژی مورد استفاده برای نسبت مساحت صندلی‌های یاتا.

استراتژی

استراتژی برای نسبت مساحت صندلی‌های یاتا. ممکن است در آینده مقادیر جدیدی اضافه شود. مشتریان باید آماده باشند تا با مقادیر ناشناخته enum به طرز شایسته‌ای برخورد کنند.

انوم‌ها
STRATEGY_UNSPECIFIED استراتژی مشخص نشده است.
NARROW_AIRCRAFT_BODY نسبت‌های مساحت صندلی برای هواپیماهای بدنه باریک مورد استفاده قرار گرفت.
WIDE_AIRCRAFT_BODY نسبت‌های مساحت صندلی برای هواپیماهای پهن‌پیکر مورد استفاده قرار گرفت.

پرواز

تمام جزئیات مربوط به یک مورد درخواست واحد برای تخمین مستقیم انتشار گازهای گلخانه‌ای از پرواز.

فیلدها
origin

string

الزامی. کد فرودگاه یاتا برای مبدا پرواز، مثلاً "LHR".

destination

string

الزامی. کد فرودگاه یاتا برای مقصد پرواز، مثلاً "JFK".

operating_carrier_code

string

الزامی. کد اپراتور IATA، مثلاً "AA".

flight_number

int32

الزامی. شماره پرواز، مثلاً ۳۲۴.

departure_date

Date

الزامی. تاریخ پرواز در منطقه زمانی فرودگاه مبدا. باید تاریخی در حال یا آینده باشد.

جزئیات انتشار گازهای گلخانه‌ای پرواز

جزئیات مربوط به میزان انتشار گازهای گلخانه‌ای مربوط به پرواز خاص.

فیلدها
emissions_grams_per_pax

EmissionsGramsPerPax

فقط خروجی. اعداد تخمینی انتشار گازهای گلخانه‌ای به ازای هر مسافر. اگر نتوان میزان انتشار گازهای گلخانه‌ای را محاسبه کرد، ارائه نخواهد شد. برای فهرست دلایلی که چرا نمی‌توان میزان انتشار گازهای گلخانه‌ای را محاسبه کرد، به ComputeDetailedFlightEmissions مراجعه کنید.

emissions_breakdown

EmissionsBreakdown

فقط خروجی. جزئیات مربوط به بخش‌های مختلف انتشار از کل مقدار emission_grams_per_pax. مقدار تجزیه‌های جمع‌شده باید همیشه برابر با emission_grams_per_pax باشد.

contrails_impact_bucket

ContrailsImpactBucket

فقط خروجی. اهمیت تأثیر گرمایش ناشی از ردپاها در مقایسه با کل تأثیر انتشار CO2e.

source

Source

فقط خروجی. منبع داده‌های انتشار.

FlightWithDetailedEmissions

پرواز مستقیم با جزئیات تخمین انتشار گازهای گلخانه‌ای.

فیلدها
flight

Flight

فقط خروجی. با شناسه‌های پرواز در درخواست مطابقت دارد. توجه: تمام کدهای IATA با حروف بزرگ نوشته شده‌اند.

flight_emissions_details

FlightEmissionsDetails

فقط خروجی. تمام داده‌های انتشار گازهای گلخانه‌ای پرواز.

emissions_metadata

EmissionsMetadata

فقط خروجی. فراداده‌های اضافی در مورد محاسبه انتشار گازهای گلخانه‌ای پرواز.

پرواز با انتشار گازهای گلخانه‌ای

پرواز مستقیم با تخمین میزان انتشار گازهای گلخانه‌ای.

فیلدها
flight

Flight

شناسه. با شناسه‌های پرواز در درخواست مطابقت دارد. توجه: تمام کدهای IATA با حروف بزرگ نوشته شده‌اند.

source

Source

اختیاری. منبع داده‌های انتشار.

emissions_grams_per_pax

EmissionsGramsPerPax

اختیاری. اعداد تخمینی انتشار گازهای گلخانه‌ای به ازای هر مسافر. اگر نتوان میزان انتشار گازهای گلخانه‌ای را محاسبه کرد، ارائه نخواهد شد. برای فهرست دلایل عدم امکان محاسبه میزان انتشار گازهای گلخانه‌ای، به ComputeFlightEmissions مراجعه کنید.

easa_label_metadata

EasaLabelMetadata

اختیاری. فراداده درباره برچسب انتشار گازهای گلخانه‌ای پرواز EASA. فقط زمانی تنظیم می‌شود که منبع داده‌های انتشار گازهای گلخانه‌ای EASA باشد.

contrails_impact_bucket

ContrailsImpactBucket

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

بازار

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

فیلدها
origin

string

الزامی. کد فرودگاه یاتا برای مبدا پرواز، مثلاً "LHR".

destination

string

الزامی. کد فرودگاه یاتا برای مقصد پرواز، مثلاً "JFK".

نسخه مدل

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

فیلدها
major

int32

نسخه‌های اصلی: تغییرات عمده در روش‌شناسی (مثلاً اضافه کردن منابع داده جدید به مدل که منجر به تغییرات عمده در خروجی می‌شود). چنین تغییراتی به ندرت و از قبل اعلام می‌شوند. ممکن است شامل تغییرات نسخه API باشد که با رعایت دستورالعمل‌های Google Cloud API انجام می‌شود.

minor

int32

نسخه‌های جزئی: تغییراتی در مدل که، در حالی که در نسخه‌های مختلف طرحواره سازگار هستند، پارامترها یا پیاده‌سازی مدل را تغییر می‌دهند.

patch

int32

نسخه‌های وصله: تغییرات پیاده‌سازی که برای رفع اشکالات یا نادرستی‌های پیاده‌سازی مدل در نظر گرفته شده‌اند.

dated

string

نسخه‌های تاریخ‌دار: مجموعه داده‌های مدل با داده‌های ورودی به‌روز شده بازسازی می‌شوند، اما هیچ تغییری در الگوریتم‌ها به‌طور منظم اعمال نمی‌شود.

انتشارات Scope3Flight

پرواز اسکوپ ۳ به همراه تخمین میزان انتشار گازهای گلخانه‌ای.

فیلدها
flight

Scope3FlightSegment

شناسه. با شناسه‌های پرواز در درخواست مطابقت دارد.

wtw_emissions_grams_per_pax

int64

اختیاری. کل انتشار گازهای گلخانه‌ای پرواز (مجموع انتشار از چاه تا مخزن و انتشار از مخزن تا زمان بیدار شدن) به ازای هر مسافر بر اساس اطلاعات درخواستی. این کل انتشار گازهای گلخانه‌ای است و مگر اینکه دلایل خاصی برای استفاده از انتشار گازهای گلخانه‌ای TTW یا WTT داشته باشید، باید از این عدد استفاده کنید.

ttw_emissions_grams_per_pax

int64

اختیاری. میزان انتشار گازهای گلخانه‌ای از مخزن سوخت تا زمان بیدار شدن مسافر در پرواز بر اساس اطلاعات درخواستی.

wtt_emissions_grams_per_pax

int64

اختیاری. میزان انتشار گازهای گلخانه‌ای پرواز از چاه تا مخزن به ازای هر مسافر بر اساس اطلاعات درخواستی.

source

Scope3FlightEmissions.Scope3DataType

اختیاری. منبع داده‌های انتشار.

نوع داده Scope3

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

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

بخش پرواز Scope3

پارامترهای پروازی که با آنها میزان انتشار گازهای گلخانه‌ای Scope 3 جمع‌آوری می‌شود.

فیلدها
departure_date

Date

الزامی. تاریخ پرواز در منطقه زمانی فرودگاه مبدا. فقط سال برای مدل‌های پرواز معمولی و انتشار گازهای گلخانه‌ای مبتنی بر مسافت مورد نیاز است (مقادیر ماه و روز نادیده گرفته می‌شوند و بنابراین، می‌توانند حذف شوند، روی ۰ تنظیم شوند یا برای این موارد روی یک تاریخ معتبر تنظیم شوند). به همین ترتیب، اگر تاریخ مشخصی برای انتشار گازهای گلخانه‌ای TIM ارائه نشود، ما به انتشار گازهای گلخانه‌ای پرواز معمولی (یا مبتنی بر مسافت) رجوع خواهیم کرد.

cabin_class

Scope3FlightSegment.CabinClass

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

origin

string

اختیاری. کد فرودگاه IATA سه حرفی برای مبدا پرواز، مثلاً YVR . این کد برای تطبیق پرواز خاص در صورت ارائه در کنار مقصد، شرکت هواپیمایی و شماره پرواز استفاده می‌شود. اگر تطابقی وجود نداشته باشد، ابتدا سعی می‌کنیم پرواز را با یک پرواز معمولی بین فرودگاه‌های مبدا و مقصد ارائه شده تطبیق دهیم. در غیر این صورت، اگر فاصله پرواز ارائه شده باشد، از مدل انتشار مبتنی بر فاصله استفاده خواهیم کرد.

destination

string

اختیاری. کد فرودگاه IATA سه حرفی برای مقصد پرواز، مثلاً ICN . این کد برای تطبیق پرواز خاص در صورت ارائه در کنار مبدا، شرکت هواپیمایی و شماره پرواز استفاده می‌شود. اگر تطابقی وجود نداشته باشد، ابتدا سعی می‌کنیم پرواز را با یک پرواز معمولی بین فرودگاه‌های مبدا و مقصد ارائه شده تطبیق دهیم. در غیر این صورت، اگر فاصله پرواز ارائه شده باشد، از مدل انتشار مبتنی بر فاصله استفاده خواهیم کرد.

carrier_code

string

اختیاری. کد حامل IATA دو کاراکتری، مثلاً KE . در صورت نیاز به تطبیق پرواز خاص، این مورد الزامی است. در غیر این صورت، برای پروازهای معمولی و مدل‌های انتشار مبتنی بر مسافت استفاده نمی‌شود. این می‌تواند هم کد حامل عملیاتی و هم کد حامل بازاریابی باشد (یعنی کد اشتراکی پوشش داده می‌شود).

flight_number

int32

اختیاری. شماره پرواز تا سقف ۴ رقم، مثلاً 71 ، از [۱، ۹۹۹۹]. این شماره پرواز ابتدا برای تطبیق یک پرواز خاص در صورتی که شماره پرواز در کنار مبدا، مقصد و شرکت حمل و نقل مشخص شده باشد، استفاده می‌شود. اگر شماره پرواز مشخص نشده باشد، ابتدا سعی می‌کنیم پرواز را با یک پرواز معمولی بین فرودگاه‌های مبدا و مقصد ارائه شده تطبیق دهیم. اگر این کار انجام نشود و/یا مبدا و مقصد ارائه نشوند، از مدل انتشار گازهای گلخانه‌ای مبتنی بر فاصله بر اساس فاصله پرواز ارائه شده استفاده خواهیم کرد.

distance_km

int64

اختیاری. مسافت بر حسب کیلومتر، مثلاً 2423 ، از [۱، ۲.۵e۱۶) کیلومتر. این برای تطبیق پرواز با انتشار گازهای گلخانه‌ای مبتنی بر مسافت، زمانی که مبدا و مقصد ارائه نشده یا پروازهای معمولی منطبقی وجود ندارد، استفاده می‌شود.

کابین کلاس

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

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

منبع

منبع داده‌های انتشار گازهای گلخانه‌ای.

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

میزان انتشار گازهای گلخانه‌ای در پرواز معمولی

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

فیلدها
market

Market

شناسه. با شناسه‌های پرواز در درخواست مطابقت دارد. توجه: تمام کدهای IATA با حروف بزرگ نوشته شده‌اند.

emissions_grams_per_pax

EmissionsGramsPerPax

اختیاری. میزان انتشار گازهای گلخانه‌ای معمول پرواز به ازای هر مسافر برای بازار درخواستی. در صورت عدم امکان محاسبه میزان انتشار گازهای گلخانه‌ای معمول، این مقدار ارائه نخواهد شد. برای مشاهده فهرست دلایل عدم امکان محاسبه میزان انتشار گازهای گلخانه‌ای معمول پرواز، به GitHub مراجعه کنید.