Method: flights.computeScope3FlightEmissions

روش بدون تابعیت برای بازیابی تخمین‌های انتشار گازهای گلخانه‌ای برای مجموعه‌ای از بخش‌های پروازی برای گزارش‌دهی 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 ) را بررسی کرد تا تأیید شود که نتایج مطابق انتظار هستند.

درخواست HTTP

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

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

درخواست بدنه

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

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

object ( Scope3FlightSegment )

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

modelVersion

object ( ModelVersion )

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

بدنه پاسخ

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

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

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

object ( Scope3FlightEmissions )

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

modelVersion

object ( ModelVersion )

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

بخش پرواز Scope3

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

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

object ( Date )

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

cabinClass

enum ( CabinClass )

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

origin

string

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

destination

string

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

carrierCode

string

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

flightNumber

integer

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

distanceKm

string ( int64 format)

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

کابین کلاس

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

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

انتشارات Scope3Flight

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

نمایش JSON 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3DataType)
}
فیلدها
flight

object ( Scope3FlightSegment )

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

wtwEmissionsGramsPerPax

string ( int64 format)

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

ttwEmissionsGramsPerPax

string ( int64 format)

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

wttEmissionsGramsPerPax

string ( int64 format)

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

source

enum ( Scope3DataType )

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

نوع داده Scope3

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

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