Method: flights.computeFlightEmissions

طريقة غير مرتبطة بحالة لاسترداد تقديرات الانبعاثات. يمكنك الاطّلاع على تفاصيل حول كيفية احتساب تقديرات الانبعاثات في GitHub.

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

  • الرحلة غير معروفة للخادم.
  • لا يتضمّن جزء رحلة الطيران الذي تم إدخاله معرّفًا واحدًا أو أكثر.
  • تاريخ الرحلة في الماضي
  • لا يتوافق نوع الطائرة مع الطراز.
  • لم يتم ضبط إعدادات المقاعد.

يمكن أن يتضمّن الطلب ما يصل إلى 1,000 جزء من رحلة جوية. إذا كان الطلب يتضمّن أكثر من 1, 000 رحلة جوية مباشرة، سيتعذّر تنفيذه وسيظهر الخطأ INVALID_ARGUMENT.

طلب HTTP

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

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

نص الطلب

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

تمثيل JSON 
{
  "flights": [
    {
      object (Flight)
    }
  ]
}
الحقول
flights[]

object (Flight)

الحقل مطلوب. رحلات جوية مباشرة يتم عرض تقديرات الانبعاثات لرحلات العودة فيها

نص الاستجابة

تعريف الإخراج لردّ flights.computeFlightEmissions

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "flightEmissions": [
    {
      object (FlightWithEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
الحقول
flightEmissions[]

object (FlightWithEmissions)

قائمة برحلات جوية تتضمّن تقديرات الانبعاثات
modelVersion

object (ModelVersion)

تم احتساب تقديرات الانبعاثات لجميع الرحلات الجوية في هذا الردّ باستخدام إصدار النموذج التالي.

مدّة عرض الإعلانات

جميع التفاصيل المتعلّقة بسلعة طلب واحدة لتقديرات انبعاثات الكربون في رحلة جوية مباشرة

تمثيل JSON 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
الحقول
origin

string

الحقل مطلوب. رمز IATA لمطار نقطة انطلاق الرحلة الجوية، مثل "LHR".
destination

string

الحقل مطلوب. رمز اتحاد النقل الجوي الدولي لمطار وجهة الرحلة الجوية، مثل "JFK".
operatingCarrierCode

string

الحقل مطلوب. رمز شركة النقل التابعة للاتحاد الدولي للنقل الجوي (IATA)، مثل "AA".
flightNumber

integer

الحقل مطلوب. رقم الرحلة الجوية، مثل 324
departureDate

object (Date)

الحقل مطلوب. تاريخ الرحلة الجوية في المنطقة الزمنية لمطار نقطة الانطلاق يجب أن يكون تاريخًا في الوقت الحاضر أو المستقبل.

FlightWithEmissions

رحلة طيران مباشرة مع تقديرات الانبعاثات

تمثيل JSON 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
الحقول
flight

object (Flight)

الحقل مطلوب. تطابق هذه السمة معرّفات الرحلات الجوية في الطلب. ملاحظة: جميع رموز الاتحاد الدولي للنقل الجوي مكتوبة بأحرف كبيرة.
source

enum (Source)

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

object (EmissionsGramsPerPax)

اختيارية: أرقام تقديرات الانبعاثات لكل راكب لن يظهر هذا الحقل إذا تعذّر احتساب الانبعاثات. للاطّلاع على قائمة بالأسباب التي أدّت إلى تعذّر احتساب الانبعاثات، يُرجى الانتقال إلى flights.computeFlightEmissions.
easaLabelMetadata

object (EasaLabelMetadata)

اختيارية: بيانات وصفية حول تصنيف انبعاثات الرحلات الجوية الصادر عن وكالة سلامة الطيران الأوروبية (EASA) يجب ضبط هذه السمة فقط عندما يكون مصدر بيانات الانبعاثات هو EASA.
contrailsImpactBucket

enum (ContrailsImpactBucket)

اختيارية: أهمية تأثير الاحتباس الحراري الناتج عن مسارات التكاثف مقارنةً بإجمالي تأثير انبعاثات ثاني أكسيد الكربون المكافئ

المصدر

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

عمليات التعداد
SOURCE_UNSPECIFIED لم يتم تحديد مصدر بيانات الانبعاثات.
TIM تستند بيانات الانبعاثات إلى "نموذج تأثير السفر".
EASA تستند بيانات الانبعاثات إلى التصنيفات البيئية الصادرة عن وكالة سلامة الطيران الأوروبية.

EasaLabelMetadata

بيانات وصفية حول تصنيف انبعاثات الرحلات الجوية الصادر عن وكالة سلامة الطيران الأوروبية (EASA)

تمثيل JSON 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
الحقول
labelIssueDate

object (Date)

تمثّل هذه السمة تاريخ إصدار التصنيف.
labelExpiryDate

object (Date)

يشير إلى تاريخ انتهاء صلاحية التصنيف. يمكن عرض التصنيف حتى نهاية هذا التاريخ.
labelVersion

string

إصدار التصنيف
safDiscountPercentage

number

النسبة المئوية للخصم على انبعاثات وقود الطيران المستدام (SAF) المطبَّقة على التصنيف وهي نسبة مئوية كقيمة عشرية. تندرج القيم ضمن الفاصل [0,1]. على سبيل المثال، 0.0021 تعني %0.21.

يتم الإبلاغ عن هذا الخصم والانخفاض في الانبعاثات من خلال تصنيف وكالة EASA، ولكنّهما غير مضمّنين في تقديرات مكافئ ثاني أكسيد الكربون التي توفّرها واجهة برمجة التطبيقات هذه.

ContrailsImpactBucket

أهمية تأثير الاحتباس الحراري الناتج عن مسارات التكاثف مقارنةً بإجمالي تأثير انبعاثات ثاني أكسيد الكربون المكافئ

عمليات التعداد
CONTRAILS_IMPACT_UNSPECIFIED لم يتم تحديد تأثيرات الطائرات النفاثة.
CONTRAILS_IMPACT_NEGLIGIBLE تأثير مسارات التكاثف ضئيل مقارنةً بإجمالي انبعاثات ثاني أكسيد الكربون المكافئ.
CONTRAILS_IMPACT_MODERATE ويكون تأثير مسارات التكاثف مماثلاً لإجمالي انبعاثات ثاني أكسيد الكربون المكافئ.
CONTRAILS_IMPACT_SEVERE ويكون تأثير مسارات التكاثف أعلى من إجمالي تأثير انبعاثات ثاني أكسيد الكربون المكافئ.