Method: flights.computeFlightEmissions

روش بدون تابعیت برای بازیابی برآوردهای انتشار جزئیات نحوه محاسبه برآورد انتشار در GitHub است

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

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

این درخواست می‌تواند تا 1000 پای پرواز داشته باشد. اگر درخواست بیش از 1000 پرواز مستقیم داشته باشد، اگر با خطای INVALID_ARGUMENT ناموفق خواهد بود.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی 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

مورد نیاز. کد حامل یاتا، به عنوان مثال "AA".

flightNumber

integer

مورد نیاز. شماره پرواز، به عنوان مثال 324.

departureDate

object ( Date )

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

تاریخ

نمایانگر یک تاریخ تقویم کامل یا جزئی، مانند روز تولد است. زمان روز و منطقه زمانی یا در جای دیگری مشخص شده است یا ناچیز است. تاریخ مربوط به تقویم میلادی است. این می تواند نشان دهنده یکی از موارد زیر باشد:

  • تاریخ کامل، با مقادیر سال، ماه و روز غیر صفر.
  • یک ماه و روز، با یک سال صفر (مثلاً یک سالگرد).
  • یک سال به تنهایی، با یک ماه صفر و یک روز صفر.
  • یک سال و یک ماه، با روز صفر (مثلاً تاریخ انقضای کارت اعتباری).

انواع مرتبط:

نمایندگی JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
فیلدها
year

integer

سال تاریخ. برای تعیین تاریخ بدون سال باید از 1 تا 9999 یا 0 باشد.

month

integer

ماه از یک سال. باید از 1 تا 12 یا 0 باشد تا یک سال بدون ماه و روز مشخص شود.

day

integer

روز یک ماه. باید از 1 تا 31 باشد و برای سال و ماه معتبر باشد، یا 0 برای مشخص کردن یک سال به تنهایی یا یک سال و ماهی که در آن روز مهم نیست، معتبر باشد.

FlightWithEmissions

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

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

object ( Flight )

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

source

enum ( Source )

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

emissionsGramsPerPax

object ( EmissionsGramsPerPax )

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

easaLabelMetadata

object ( EasaLabelMetadata )

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

contrailsImpactBucket

enum ( ContrailsImpactBucket )

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

منبع

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

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

EasaLabel Metadata

فراداده در مورد برچسب انتشارات پرواز 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 گنجانده نشده است.

ContrailsImpactBucket

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

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