Method: flights.computeFlightEmissions

روش بدون تابعیت برای بازیابی برآوردهای انتشار جزئیات در مورد نحوه محاسبه برآوردهای انتشار: https://github.com/google/travel-impact-model

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

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

این درخواست می‌تواند تا 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][google.travel.sustainability.travelimpactmodel.v1.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)
  },
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
زمینه های
flight

object ( Flight )

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

emissionsGramsPerPax

object ( EmissionsGramsPerPax )

اختیاری. اعداد برآورد انتشار گازهای گلخانه ای به ازای هر مسافر اگر انتشار گازهای گلخانه ای قابل محاسبه نباشد، وجود نخواهد داشت. برای فهرست دلایلی که چرا انتشارات را نمی توان محاسبه کرد، به [flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions] مراجعه کنید.

EmissionsGramsPerPax

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

نمایندگی JSON
{
  "first": integer,
  "business": integer,
  "premiumEconomy": integer,
  "economy": integer
}
زمینه های
first

integer

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

business

integer

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

premiumEconomy

integer

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

economy

integer

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

ModelVersion

نسخه Travel Impact Model. برای اطلاعات بیشتر در مورد نسخه‌سازی مدل به https://github.com/google/travel-impact-model/#versioning مراجعه کنید.

نمایندگی JSON
{
  "major": integer,
  "minor": integer,
  "patch": integer,
  "dated": string
}
زمینه های
major

integer

نسخه های اصلی: تغییرات عمده در روش (مانند افزودن منابع داده جدید به مدل که منجر به تغییرات عمده خروجی می شود). چنین تغییراتی نادر خواهد بود و از قبل اعلام می شود. ممکن است شامل تغییرات نسخه API باشد که به دستورالعمل‌های موجود در https://cloud.google.com/endpoints/docs/openapi/versioning-an-api#backwards-incompatible احترام می‌گذارد.

minor

integer

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

patch

integer

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

dated

string

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