Method: flights.computeDetailedFlightEmissions

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

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

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

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

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

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

درخواست HTTP

POST https://travelimpactmodel.googleapis.com/v1/flights:computeDetailedFlightEmissions

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

درخواست بدنه

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

نمایش JSON 
{
  "flights": [
    {
      object (Flight)
    }
  ]
}
فیلدها
flights[]

object ( Flight )

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

بدنه پاسخ

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

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "flightsWithDetailedEmissions": [
    {
      object (FlightWithDetailedEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
فیلدها
flightsWithDetailedEmissions[]

object ( FlightWithDetailedEmissions )

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

modelVersion

object ( ModelVersion )

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

FlightWithDetailedEmissions

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

نمایش JSON 
{
  "flight": {
    object (Flight)
  },
  "flightEmissionsDetails": {
    object (FlightEmissionsDetails)
  },
  "emissionsMetadata": {
    object (EmissionsMetadata)
  }
}
فیلدها
flight

object ( Flight )

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

flightEmissionsDetails

object ( FlightEmissionsDetails )

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

emissionsMetadata

object ( EmissionsMetadata )

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

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

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

نمایش JSON 
{
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "emissionsBreakdown": {
    object (EmissionsBreakdown)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket),
  "source": enum (Source)
}
فیلدها
emissionsGramsPerPax

object ( EmissionsGramsPerPax )

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

emissionsBreakdown

object ( EmissionsBreakdown )

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

contrailsImpactBucket

enum ( ContrailsImpactBucket )

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

source

enum ( Source )

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

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

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

نمایش JSON 
{
  "wttEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "ttwEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
فیلدها
wttEmissionsGramsPerPax

object ( EmissionsGramsPerPax )

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

ttwEmissionsGramsPerPax

object ( EmissionsGramsPerPax )

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

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

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

نمایش JSON 
{
  "emissionsProvenance": {
    object (EmissionsProvenance)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "timWebsiteEmissionsCalculatorUrl": string
}
فیلدها
emissionsProvenance

object ( EmissionsProvenance )

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

easaLabelMetadata

object ( EasaLabelMetadata )

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

timWebsiteEmissionsCalculatorUrl

string

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

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

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

نمایش JSON 
{
  "provenanceEntries": [
    {
      object (EmissionsProvenance.EmissionsProvenanceEntry)
    }
  ]
}
فیلدها
provenanceEntries[]

object ( EmissionsProvenance.EmissionsProvenanceEntry )

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

انتشار-منشا.ورودی منشأ انتشار

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

نمایش JSON 
{
  "provenanceEntryType": enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType),
  "source": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource),
  "sourceVersion": string,
  "dataCategory": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory),

  // Union field data_strategy can be only one of the following:
  "fuelBurnEeaStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy),
  "loadFactorsT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy),
  "loadFactorsChAviationStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy),
  "cargoMassFractionT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy),
  "seatAreaRatioIataStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy),
  "distanceAdjustmentStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)
  // End of list of possible types for union field data_strategy.

  // Union field data_value can be only one of the following:
  "loadFactorsData": number,
  "cargoMassFractionData": number,
  "seatAreaRatioData": {
    object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)
  },
  "estimatedFlightDistanceKm": integer
  // End of list of possible types for union field data_value.
}
فیلدها
provenanceEntryType

enum ( EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType )

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

source

enum ( EmissionsProvenance.EmissionsProvenanceEntry.DataSource )

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

sourceVersion

string

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

dataCategory

enum ( EmissionsProvenance.EmissionsProvenanceEntry.DataCategory )

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

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

enum ( EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy )

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

loadFactorsT100Strategy

enum ( EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy )

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

loadFactorsChAviationStrategy

enum ( EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy )

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

cargoMassFractionT100Strategy

enum ( EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy )

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

seatAreaRatioIataStrategy

enum ( EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy )

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

distanceAdjustmentStrategy

enum ( EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy )

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

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

number

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

cargoMassFractionData

number

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

seatAreaRatioData

object ( EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData )

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

estimatedFlightDistanceKm

integer

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

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

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

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

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

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

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

انتشار، منشأ، ورود، منشأ، انتشار، استراتژی، سوخت، انرژی، انرژی

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

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

انتشار، منشأ، ورودی، منشأ، انتشار، ضرایب بار، استراتژی T100

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

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

انتشار، منشأ، ورودی، منشأ، عوامل بار، استراتژی هوانوردی

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

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

انتشار، منشأ، ورود، منشأ، انتشار، کسر جرم محموله، استراتژی T100

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

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

انتشار، منشأ، ورود، منشأ، نسبت، منطقه، صندلی، استراتژی

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

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

استراتژی تعدیل فاصله. ورود منشأ انتشار. منشأ انتشار

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

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

رده‌بندی داده‌ها - منشأ انتشار

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

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