Method: flights.computeFlightEmissions

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

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

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

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

درخواست HTTP

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

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

درخواست بدنه

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

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

object ( Flight )

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

بدنه پاسخ

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

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

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

object ( FlightWithEmissions )

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

modelVersion

object ( ModelVersion )

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

پرواز

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

نمایش JSON 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
فیلدها
origin

string

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

destination

string

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

operatingCarrierCode

string

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

flightNumber

integer

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

departureDate

object ( Date )

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

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

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

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

object ( Flight )

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

source

enum ( Source )

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

emissionsGramsPerPax

object ( EmissionsGramsPerPax )

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

easaLabelMetadata

object ( EasaLabelMetadata )

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

contrailsImpactBucket

enum ( ContrailsImpactBucket )

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

منبع

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

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

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

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

نمایش JSON 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
فیلدها
labelIssueDate

object ( Date )

تاریخی که برچسب صادر شده است.

labelExpiryDate

object ( Date )

تاریخ انقضای برچسب. برچسب تا پایان این تاریخ قابل نمایش است.

labelVersion

string

نسخه برچسب.

safDiscountPercentage

number

درصد تخفیف انتشار گازهای گلخانه‌ای سوخت پایدار هوانوردی (SAF) که روی برچسب اعمال شده است. این درصد به صورت اعشاری است. مقادیر در بازه [0،1] قرار دارند. به عنوان مثال، 0.0021 به معنی 0.21٪ است.

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

سطل ضربه گیر

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

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