Method: flights.computeScope3FlightEmissions

طريقة غير مرتبطة بحالة معيّنة لاسترداد تقديرات انبعاثات الغازات الدفيئة لمجموعة من أقسام الرحلات الجوية لإعداد تقارير النطاق 3

سيتضمّن الردّ جميع الإدخالات التي تتطابق مع شرائح الرحلات الجوية Scope3FlightSegment المُدخَلة، وبالترتيب نفسه. سيتم احتساب التقديرات باستخدام المنطق المتتالي التالي (باستخدام أول تقدير متاح):

  1. الانبعاثات المستندة إلى نموذج تأثير السفر (TIM) مع الأخذ في الاعتبار origin وdestination وcarrier وflightNumber وdepartureDate وcabinClass
  2. مستوى انبعاثات الرحلة الجوية المعتاد في departureDate، وorigin، وdestination، و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

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

string

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

string

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

integer

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

string (int64 format)

اختياريّ. المسافة بالكيلومترات، مثلاً 2423، من [1, 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 يُستخدَم هذا الحقل في استجابة النطاق 3 لتحديد الطريقة المستخدَمة لاحتساب الانبعاثات.

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