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 أو ضبطها على تاريخ صالح في هذه الحالات). وبالمثل، إذا لم يتم تقديم تاريخ معيّن لانبعاثات "نموذج تأثير السفر"، سنرجع إلى انبعاثات الرحلات الجوية العادية (أو الانبعاثات المستندة إلى المسافة).
cabinClass

enum (Scope3FlightSegment.CabinClass)

الحقل مطلوب. درجة الرحلة الجوية.
origin

string

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

string

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

string

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

integer

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

string (int64 format)

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

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)
}
الحقول
flight

object (Scope3FlightSegment)

المعرّف. يتطابق مع معرّفات الرحلات الجوية في الطلب.
wtwEmissionsGramsPerPax

string (int64 format)

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

string (int64 format)

اختياريّ. انبعاثات الرحلة الجوية من الخزان إلى المحرك لكل راكب استنادًا إلى المعلومات المطلوبة.
wttEmissionsGramsPerPax

string (int64 format)

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

enum (Scope3FlightEmissions.Scope3DataType)

اختياريّ. مصدر بيانات الانبعاثات.

Scope3FlightEmissions.Scope3DataType

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

عمليات التعداد
SCOPE3_DATA_TYPE_UNSPECIFIED نوع بيانات غير محدّد
TIM_EMISSIONS الانبعاثات المستندة إلى "نموذج تأثير السفر" (TIM) استنادًا إلى نقطة الانطلاق والوجهة والناقل ورقم الرحلة الجوية وتاريخ المغادرة والسنة
TYPICAL_FLIGHT_EMISSIONS انبعاثات الرحلات الجوية العادية استنادًا إلى نقطة الانطلاق والوجهة والسنة
DISTANCE_BASED_EMISSIONS الانبعاثات المستندة إلى المسافة استنادًا إلى المسافة المقطوعة والسنة