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 (Scope3FlightSegment.CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
الحقول
departureDate

object (Date)

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

enum (Scope3FlightSegment.CabinClass)

الحقل مطلوب. درجة السفر على الرحلة الجوية
origin

string

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

string

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

string

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

integer

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

string (int64 format)

اختيارية: المسافة بالكيلومتر، مثلاً 2423، من [1، 1e12) كيلومتر. تُستخدَم هذه السمة لمطابقة رحلة جوية مع الانبعاثات المستندة إلى المسافة عندما لا يتم تقديم نقطة الانطلاق والوجهة أو عندما لا تكون هناك رحلات جوية نموذجية مطابقة.

Scope3FlightSegment.CabinClass

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

عمليات التعداد
CABIN_CLASS_UNSPECIFIED درجة السفر غير محدّدة.
ECONOMY الدرجة الاقتصادية
PREMIUM_ECONOMY الدرجة الاقتصادية المميزة
BUSINESS درجة رجال الأعمال
FIRST الدرجة الأولى

Scope3FlightEmissions

رحلة جوية من النطاق 3 مع تقديرات الانبعاثات

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

نوع المطابقة المستخدَم لحساب انبعاثات النطاق 3 يُستخدَم هذا الحقل في الردّ على النطاق 3، ويشير إلى الطريقة التي تم استخدامها لحساب الانبعاثات.

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