Method: flights.computeScope3FlightEmissions

برآوردهای انتشار گازهای گلخانه‌ای را برای مجموعه‌ای از بخش‌های پرواز برای گزارش «حوزه ۳» بازیابی می‌کند.

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

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

اگر پرواز آتی درخواست‌شده‌ای در این سال تقویمی وجود داشته باشد، از انتشار کربن «سطح ۱» پشتیبانی نمی‌کنیم و به انتشار کربن «سطح ۲» یا «سطح ۳» برمی‌گردیم. اگر پرواز آینده درخواست‌شده در این سال تقویمی نباشد، پاسخ خالی برمی‌گردانیم. توصیه می‌کنیم برای پروازهای آینده، از computeFlightEmissions API استفاده شود.

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

درخواست با خطای INVALID_ARGUMENT ناموفق خواهد بود اگر:

  • درخواست حاوی بیش‌از ۱۰۰۰ بخش پرواز است.
  • بخش پرواز ورودی یک یا چند شناسه ندارد. برای مثال، مبدأ/مقصد ناموجود بدون مسافت معتبر برای مطابقت نوع TIM_EMISSIONS یا TYPICAL_FLIGHT_EMISSIONS، یا مسافت ناموجود برای مطابقت نوع DISTANCE_BASED_EMISSIONS (اگر می‌خواهید به انتشار مبتنی بر مسافت برگردید یا برآورد انتشار مبتنی بر مسافت می‌خواهید، باید مسافت را مشخص کنید).
  • تاریخ پرواز قبل‌از ۲۰۱۹ است (داده‌های «حوزه ۳» فقط برای ۲۰۱۹ و بعداز آن دردسترس است).
  • مسافت پرواز ۰ یا کمتر است.
  • کلاس پروازی وجود ندارد.

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

درخواست HTTP

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

نشانی وب از نحو تراتبدیل gRPC استفاده می‌کند.

متن درخواست

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

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

object (Scope3FlightSegment)

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

object (ModelVersion)

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

بدنه پاسخ

فهرستی از پروازها با برآوردهای انتشار کربن «حوزه ۳».

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

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

object (Scope3FlightEmissions)

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

object (ModelVersion)

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

Scope3FlightSegment

پارامترهای پرواز که انتشار کربن «حوزه ۳» با آن‌ها واکشی می‌شود.

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

object (Date)

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

enum (Scope3FlightSegment.CabinClass)

الزامی. کلاس پروازی پرواز.
origin

string

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

string

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

string

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

integer

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

string (int64 format)

اختیاری. فاصله برحسب کیلومتر، مثلاً 2423، از [1، 1e12) کیلومتر. این مقدار برای مطابقت دادن پرواز با میزان انتشار براساس فاصله استفاده می‌شود، زمانی‌که مبدأ و مقصد ارائه نشده باشد یا پرواز معمولی منطبقی وجود نداشته باشد.

Scope3FlightSegment.CabinClass

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

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

Scope3FlightEmissions

پرواز حوزه ۳ با برآورد انتشار کربن.

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

object (Scope3FlightSegment)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

enum (Scope3FlightEmissions.Scope3DataType)

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

string

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

Scope3FlightEmissions.Scope3DataType

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

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