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

الحقل مطلوب. رمز الاتحاد الدولي للنقل الجوي لمطار نقطة انطلاق الرحلة الجوية، مثل "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)

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

المصدر

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

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

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

ContrailsImpactBucket

تشير هذه السمة إلى أهمية تأثير مسارات التكاثف على الاحتباس الحراري مقارنةً بإجمالي تأثير انبعاثات مكافئ ثاني أكسيد الكربون (CO2e).

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