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)

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

التاريخ

تمثّل هذه السمة تاريخ تقويم كاملاً أو جزئيًا، مثل تاريخ الميلاد. يتم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو لا أهمية لهما. التاريخ نسبي بالنسبة إلى التقويم الغريغوري. يمكن أن يمثّل ذلك أحد ما يلي:

  • تاريخ كامل، مع قيم غير صفرية للسنة والشهر واليوم
  • الشهر واليوم، مع سنة صفر (على سبيل المثال، ذكرى سنوية)
  • سنة بمفردها، مع شهر ويوم بقيمة صفر
  • سنة وشهر، مع يوم صفر (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة ائتمان).

الأنواع ذات الصلة:

تمثيل JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
الحقول
year

integer

سنة التاريخ يجب أن يكون الرقم بين 1 و9999، أو 0 لتحديد تاريخ بدون سنة.
month

integer

الشهر من السنة يجب أن يكون الرقم بين 1 و12، أو 0 لتحديد سنة بدون شهر ويوم.
day

integer

اليوم من الشهر يجب أن يكون الرقم بين 1 و31 وصالحًا للسنة والشهر، أو 0 لتحديد سنة بمفردها أو سنة وشهر لا يكون فيه اليوم مهمًا.

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.

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

ContrailsImpactBucket

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

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