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 بدلاً من ذلك للرحلات الجوية المستقبلية.

إذا لم تتوفّر تقديرات لرحلة جوية معيّنة باستخدام أيّ من الطرق الثلاث، سيعرض الردّ عنصر Scope3FlightEmissions مع حقول انبعاثات فارغة. وسيظل الطلب يُعدّ ناجحًا. بشكل عام، يحدث عدم توفّر تقديرات الانبعاثات عندما لا يكون الخادم على علم بالرحلة الجوية (مثلاً، لا توجد رحلة جوية محدّدة، أو لا تتوفّر بيانات الانبعاثات العادية للرحلات الجوية للزوج المطلوب).

سيتعذّر تنفيذ الطلب مع ظهور الخطأ INVALID_ARGUMENT في الحالات التالية:

  • يحتوي الطلب على أكثر من 1,000 جزء من رحلة جوية.
  • لا يتضمّن جزء رحلة الطيران الذي تم إدخاله معرّفًا واحدًا أو أكثر. على سبيل المثال، عدم توفّر نقطة الانطلاق/الوجهة بدون مسافة صالحة لتطابق النوع TIM_EMISSIONS أو TYPICAL_FLIGHT_EMISSIONS، أو عدم توفّر مسافة لتطابق النوع DISTANCE_BASED_EMISSIONS (إذا كنت تريد الرجوع إلى الانبعاثات المستندة إلى المسافة أو تريد تقدير الانبعاثات المستندة إلى المسافة، عليك تحديد مسافة).
  • تاريخ الرحلة الجوية يسبق العام 2019 (لا تتوفّر بيانات النطاق 3 إلا للعام 2019 وما بعده).
  • مسافة الرحلة الجوية هي 0 أو أقل.
  • درجة السفر غير متوفّرة.

بما أنّ الطلب تتم معالجته باستخدام منطق احتياطي، من المحتمل أن تعرض الطلبات التي تم إعدادها بشكل غير صحيح تقديرات صحيحة للانبعاثات باستخدام طرق احتياطية. على سبيل المثال، إذا كان الطلب يتضمّن رقم رحلة جوية غير صحيح ولكن يحدّد نقطة المغادرة والوجهة، سيظل الطلب ناجحًا، ولكن ستستند الانبعاثات التي يتم عرضها إلى الانبعاثات النموذجية للرحلة الجوية فقط. وبالمثل، إذا كان طلب عادي بشأن انبعاثات الرحلات الجوية لا يتضمّن نقطة الانطلاق، ولكنّه يحدّد مسافة صالحة، يمكن أن ينجح الطلب استنادًا إلى الانبعاثات المستندة إلى المسافة فقط. نتيجةً لذلك، يجب التحقّق من مصدر الانبعاثات التي تم إرجاعها (source) للتأكّد من أنّ النتائج هي كما هو متوقّع.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل الترميز إلى gRPC.

نص الطلب

يتضمن نص الطلب بيانات بالبنية التالية:

تمثيل 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

مَعلمات الرحلة الجوية التي يتم جلب انبعاثات النطاق 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

اختيارية: رمز شركة النقل الجوي التابعة للاتحاد الدولي للنقل الجوي (IATA)، مثل KE هذه السمة مطلوبة إذا كنت تريد مطابقة رحلات جوية معيّنة. وفي ما عدا ذلك، لا يتم استخدام هذه السمة في نماذج الانبعاثات النموذجية المستندة إلى الرحلات الجوية والمسافة. يمكن أن يكون هذا الرمز هو رمز شركة النقل التشغيلية والتسويقية (أي أنّ المشاركة في الرمز مشمولة).
flightNumber

integer

اختيارية: رقم الرحلة الجوية، مثل 71 يُستخدَم هذا الحقل أولاً لمطابقة رحلة جوية معيّنة في حال تحديد رقم الرحلة مع نقطة الانطلاق والوجهة وشركة الطيران. في حال عدم تحديد رقم الرحلة، سنحاول أولاً مطابقة الرحلة مع رحلة نموذجية بين مطارَي المغادرة والوصول المحدَّدَين. إذا لم ينجح ذلك و/أو لم يتم تقديم المصدر والوجهة، سنستخدم نموذج الانبعاثات المستند إلى المسافة استنادًا إلى مسافة الرحلة الجوية المقدَّمة.
distanceKm

string (int64 format)

اختيارية: المسافة بالكيلومتر، مثل 2423 يُستخدَم هذا المعرّف لمطابقة رحلة جوية مع الانبعاثات المستندة إلى المسافة عندما لا يتم تقديم معلومات عن نقطة المغادرة والوجهة أو عندما لا تتوفّر رحلات جوية عادية مطابقة. يقبل هذا الحقل قيمًا تتراوح بين 0 و2.5e16 كيلومتر.

CabinClass

درجة السفر على متن الرحلة الجوية

عمليات التعداد
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)

اختيارية: إجمالي انبعاثات الرحلة الجوية (مجموع الانبعاثات من المصدر إلى الخزان ومن الخزان إلى العادم) لكل مسافر استنادًا إلى المعلومات المطلوبة. هذا هو إجمالي الانبعاثات، وما لم يكن لديك أسباب محددة لاستخدام انبعاثات "من الخزان إلى العادم" أو "من المصدر إلى الخزان"، عليك استخدام هذا الرقم.
ttwEmissionsGramsPerPax

string (int64 format)

اختيارية: انبعاثات الرحلة الجوية من الوقود إلى العجلات لكل مسافر استنادًا إلى المعلومات المطلوبة
wttEmissionsGramsPerPax

string (int64 format)

اختيارية: انبعاثات الرحلة الجوية من المصدر إلى الخزان لكل مسافر استنادًا إلى المعلومات المطلوبة
source

enum (Scope3DataType)

اختيارية: مصدر بيانات الانبعاثات

Scope3DataType

نوع المطابقة المُستخدَم لاحتساب انبعاثات النطاق 3 يُستخدَم هذا الحقل في استجابة Scope 3 لتحديد الطريقة المستخدَمة في احتساب الانبعاثات.

عمليات التعداد
SCOPE3_DATA_TYPE_UNSPECIFIED نوع البيانات غير محدَّد.
TIM_EMISSIONS الانبعاثات المستندة إلى TIM مع تحديد نقطة الانطلاق والوجهة وشركة النقل ورقم الرحلة وتاريخ المغادرة والسنة
TYPICAL_FLIGHT_EMISSIONS مستوى الانبعاثات العادي للرحلات الجوية حسب نقطة الانطلاق والوجهة والسنة
DISTANCE_BASED_EMISSIONS الانبعاثات المستندة إلى المسافة استنادًا إلى المسافة المقطوعة والسنة