Method: flights.computeScope3FlightEmissions

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

پاسخ شامل تمام ورودی‌هایی است که با بخش‌های پرواز ورودی Scope3FlightSegment مطابقت دارند، به همان ترتیب ارائه‌شده. تخمین ها با استفاده از منطق آبشاری زیر (با استفاده از اولین مورد موجود) محاسبه خواهند شد:

  1. انتشارات مبتنی بر TIM origin ، destination ، carrier ، flightNumber ، departureDate ، و cabinClass .
  2. انتشارات معمولی پرواز با توجه به origin ، destination ، سال در departureDate ، و cabinClass .
  3. گازهای گلخانه ای مبتنی بر فاصله با استفاده از distanceKm ، سال در departureDate ، و cabinClass محاسبه شده است.

اگر درخواست پرواز آینده در این سال تقویمی وجود داشته باشد، از انتشار گازهای گلخانه‌ای سطح 1 پشتیبانی نمی‌کنیم و به انتشارات سطح 2 یا 3 برمی‌گردیم. اگر پرواز آینده درخواستی در این سال تقویمی نباشد، ما یک پاسخ خالی را برمی گردانیم. توصیه می کنیم که برای پروازهای آینده، به جای آن از computeFlightEmissions API استفاده شود.

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

درخواست با خطای INVALID_ARGUMENT شکست خواهد خورد اگر:

  • درخواست شامل بیش از 1000 پای پرواز است.
  • پای پرواز ورودی یک یا چند شناسه ندارد. به عنوان مثال، از دست دادن مبدا/مقصد بدون فاصله معتبر برای تطابق نوع TIM_EMISSIONS یا TYPICAL_FLIGHT_EMISSIONS ، یا فاصله از دست رفته برای تطابق نوع DISTANCE_BASED_EMISSIONS (اگر می‌خواهید به انتشارات مبتنی بر فاصله برگردید یا می‌خواهید یک برآورد انتشار بر اساس مسافت را مشخص کنید، باید یک تخمین مشخص کنید).
  • تاریخ پرواز قبل از سال 2019 است (داده های Scope 3 فقط برای سال 2019 و بعد از آن در دسترس هستند).
  • فاصله پرواز 0 یا کمتر است.
  • گم شدن کلاس کابین

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

درخواست HTTP

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

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

درخواست بدن

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

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

object ( Scope3FlightSegment )

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

modelVersion

object ( ModelVersion )

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

بدن پاسخگو

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

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

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

object ( Scope3FlightEmissions )

فهرست بخش‌های پرواز با برآورد انتشار.

modelVersion

object ( ModelVersion )

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

Scope3FlightSegment

پارامترهای پرواز که با آنها انتشارات Scope 3 واکشی می شود.

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

object ( Date )

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

cabinClass

enum ( CabinClass )

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

origin

string

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

destination

string

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

carrierCode

string

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

flightNumber

integer

اختیاری. شماره پرواز، به عنوان مثال 71 . اگر شماره پرواز در کنار مبدا، مقصد و شرکت حامل مشخص شده باشد، ابتدا برای مطابقت با یک پرواز خاص استفاده می شود. اگر شماره پروازی مشخص نشده باشد، ابتدا سعی می کنیم پرواز را با یک پرواز معمولی بین فرودگاه های مبدأ و مقصد ارائه شده مطابقت دهیم. در صورت عدم موفقیت و/یا عدم ارائه مبدأ و مقصد، از مدل انتشار گازهای گلخانه ای مبتنی بر فاصله بر اساس فاصله پرواز ارائه شده استفاده خواهیم کرد.

distanceKm

string ( int64 format)

اختیاری. فاصله بر حسب کیلومتر، به عنوان مثال 2423 . این برای تطبیق یک پرواز با انتشار گازهای گلخانه‌ای مبتنی بر فاصله زمانی که مبدا و مقصد ارائه نشده‌اند یا پروازهای معمولی مشابهی وجود ندارد، استفاده می‌شود. این فیلد مقادیر بین 0 تا 2.5e16 کیلومتر را پشتیبانی می کند.

کلاس کابین

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

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

Scope3FlightEmissions

پرواز محدوده 3 با برآورد انتشار.

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

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

Scope3DataType

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

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