Method: flights.computeDetailedFlightEmissions

تعرض هذه الطريقة تقديرات مفصّلة للانبعاثات.

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

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

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

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

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

طلب HTTP

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

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

نص الطلب

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

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

object (Flight)

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

نص الاستجابة

تعريف الإخراج الخاص باستجابة flights.computeDetailedFlightEmissions

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

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

object (FlightWithDetailedEmissions)

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

object (ModelVersion)

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

FlightWithDetailedEmissions

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

تمثيل JSON 
{
  "flight": {
    object (Flight)
  },
  "flightEmissionsDetails": {
    object (FlightEmissionsDetails)
  },
  "emissionsMetadata": {
    object (EmissionsMetadata)
  }
}
الحقول
flight

object (Flight)

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

object (FlightEmissionsDetails)

النتائج فقط. جميع بيانات الانبعاثات من الرحلات الجوية
emissionsMetadata

object (EmissionsMetadata)

النتائج فقط. بيانات وصفية إضافية حول عملية حساب الانبعاثات الناتجة عن الرحلة الجوية

FlightEmissionsDetails

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

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

object (EmissionsGramsPerPax)

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

object (EmissionsBreakdown)

النتائج فقط. تفاصيل حول الأجزاء المختلفة من الانبعاثات في قيمة إجمالي الانبعاثاتGramsPerPax. يجب أن تساوي قيمة التصنيفات المجتمعة دائمًا قيمة emissionsGramsPerPax.
contrailsImpactBucket

enum (ContrailsImpactBucket)

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

enum (Source)

النتائج فقط. مصدر بيانات الانبعاثات

EmissionsBreakdown

تفاصيل حول الأجزاء المختلفة من الانبعاثات في قيمة إجمالي الانبعاثاتGramsPerPax. يجب أن تساوي قيمة التصنيفات المجتمعة دائمًا قيمة emissionsGramsPerPax.

تمثيل JSON 
{
  "wttEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "ttwEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
الحقول
wttEmissionsGramsPerPax

object (EmissionsGramsPerPax)

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

object (EmissionsGramsPerPax)

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

EmissionsMetadata

جميع البيانات الوصفية الإضافية

تمثيل JSON 
{
  "emissionsProvenance": {
    object (EmissionsProvenance)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "timWebsiteEmissionsCalculatorUrl": string
}
الحقول
emissionsProvenance

object (EmissionsProvenance)

النتائج فقط. تفاصيل حول مصدر البيانات المستخدَمة لاحتساب بيانات الانبعاثات، بما في ذلك العوامل المساهمة ومصادر بياناتها
easaLabelMetadata

object (EasaLabelMetadata)

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

string

النتائج فقط. رابط إلى الموقع الإلكتروني travelimpactmodel.org لآلة حساب الانبعاثات مثال: https://travelimpactmodel.org/lookup/flight?itinerary=ZRH-BOS-LX-52-20261225

EmissionsProvenance

معلومات حول مصدر البيانات المستخدَمة لاحتساب تقديرات الانبعاثات، بما في ذلك العوامل المساهمة ومصادر بياناتها

في provenanceEntries، تعمل provenanceEntryType كـ "مفتاح" يحدّد العامل المساهم، ولا يوجد سوى إدخال واحد دائمًا لكل نوع إدخال. تصف الحقول المتبقية في كل إدخال نوع الإدخال المحدّد هذا، وقد يتم ملؤها أو لا يتم ذلك استنادًا إلى العامل المساهم والبيانات المتاحة.

تمثيل JSON 
{
  "provenanceEntries": [
    {
      object (EmissionsProvenance.EmissionsProvenanceEntry)
    }
  ]
}
الحقول
provenanceEntries[]

object (EmissionsProvenance.EmissionsProvenanceEntry)

النتائج فقط. جميع العوامل المساهمة المستخدَمة لاحتساب الانبعاثات يعمل كل نوع إدخال (provenanceEntryType) كـ "مفتاح" يحدّد العامل، مع إدخال واحد فقط دائمًا لكل نوع إدخال. تصف الحقول المتبقية هذا العامل المحدد وقد يتم ملؤها أو لا.

EmissionsProvenance.EmissionsProvenanceEntry

تفاصيل حول عامل مساهم واحد في حسابات الانبعاثات يمثّل كل إدخال عاملاً واحدًا، حيث يعمل provenanceEntryType كمفتاح يحدّد العامل، وتصف الحقول الأخرى هذا العامل وقد يتم ملؤها أو لا.

تمثيل JSON 
{
  "provenanceEntryType": enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType),
  "source": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource),
  "sourceVersion": string,
  "dataCategory": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory),

  // Union field data_strategy can be only one of the following:
  "fuelBurnEeaStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy),
  "loadFactorsT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy),
  "loadFactorsChAviationStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy),
  "cargoMassFractionT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy),
  "seatAreaRatioIataStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy),
  "distanceAdjustmentStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)
  // End of list of possible types for union field data_strategy.

  // Union field data_value can be only one of the following:
  "loadFactorsData": number,
  "cargoMassFractionData": number,
  "seatAreaRatioData": {
    object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)
  },
  "estimatedFlightDistanceKm": integer
  // End of list of possible types for union field data_value.
}
الحقول
provenanceEntryType

enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType)

النتائج فقط. نوع إدخال مستند المصدر يعمل هذا الحقل كـ "مفتاح" لتحديد العامل المساهم، وتصفه الحقول المتبقية في هذه الرسالة وقد يتم ملؤها أو لا يتم ذلك.
source

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource)

النتائج فقط. مصدر البيانات
sourceVersion

string

النتائج فقط. تمثّل هذه السمة إصدار بيانات المصدر. على سبيل المثال، "2025/04".
dataCategory

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory)

النتائج فقط. فئة بيانات مصدر البيانات
حقل الربط data_strategy الاستراتيجية المستخدَمة لاحتساب الانبعاثات لمصدر البيانات المحدّد ستتوافق مجموعة الحقول مع نوع data_source. يمكن أن يكون التعليق data_strategy إحدى القيم التالية فقط:
fuelBurnEeaStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy)

النتائج فقط. استراتيجية استهلاك الوقود في المنطقة الاقتصادية الأوروبية
loadFactorsT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy)

النتائج فقط. استراتيجية عوامل حمولة الركّاب في T100
loadFactorsChAviationStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy)

النتائج فقط. استراتيجية لعوامل حمولة الركّاب في CH Aviation
cargoMassFractionT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy)

النتائج فقط. استراتيجية الكسر الكتلي للحمولة في T100
seatAreaRatioIataStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy)

النتائج فقط. استراتيجية نسب مساحة المقاعد في الاتحاد الدولي للنقل الجوي
distanceAdjustmentStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)

النتائج فقط. استراتيجية تعديل المسافة
حقل الربط data_value قيمة البيانات لمصدر البيانات المحدّد سيتوافق مجموعة الحقول مع provenance_entry_type. يمكن أن يكون التعليق data_value إحدى القيم التالية فقط:
loadFactorsData

number

النتائج فقط. قيمة بيانات عوامل التحميل إذا لم يتم ضبطها، لن تتوفّر قيمة عوامل التحميل.
cargoMassFractionData

number

النتائج فقط. تمثّل هذه السمة قيمة الكسر الكتلي للشحنة. إذا لم يتم ضبط هذه السمة، لن تتوفّر قيمة كتلة الحمولة.
seatAreaRatioData

object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)

النتائج فقط. قيمة نسبة مساحة المقعد لكل درجة من درجات المقاعد إذا لم يتم ضبطها، لن تتوفّر قيمة نسبة مساحة المقعد.
estimatedFlightDistanceKm

integer

النتائج فقط. المسافة المقدَّرة التي قطعتها الطائرة في مرحلة رحلة CCD الجوية بالكيلومترات، ويتم احتسابها باستخدام عامل تعديل المسافة (DAF). في حال عدم ضبطها، لن تتوفّر قيمة مسافة الرحلة الجوية المقدّرة.

EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType

نوع إدخال مستند المصدر قد تتم إضافة قيم جديدة في المستقبل. يجب أن تكون التطبيقات جاهزة للتعامل مع قيم التعداد غير المعروفة بشكل سليم.

عمليات التعداد
EMISSIONS_PROVENANCE_ENTRY_TYPE_UNSPECIFIED نوع إدخال مصدر غير محدّد
FUEL_BURN نوع إدخال استهلاك الوقود
LOAD_FACTORS نوع إدخال عوامل التحميل
CARGO_MASS_FRACTION نوع إدخال الكسر الكتلي للشحنة
SEATING_CONFIG نوع إدخال إعدادات أماكن الجلوس
SEAT_AREA_RATIOS نوع إدخال نسب مساحة المقاعد
DISTANCE_ADJUSTMENT نوع إدخال تعديل المسافة

EmissionsProvenance.EmissionsProvenanceEntry.DataSource

مصدر البيانات لعوامل مصدر الانبعاثات قد تتم إضافة قيم جديدة في المستقبل. يجب أن تكون التطبيقات جاهزة للتعامل مع قيم التعداد غير المعروفة بشكل سليم.

عمليات التعداد
DATA_SOURCE_UNSPECIFIED لم يتم تحديد مصدر البيانات.
EEA البيانات مقدَّمة من وكالة البيئة الأوروبية (EEA).
T100 بيانات من مجموعة بيانات T-100، مقدَّمة من مكتب إحصاءات النقل التابع لوزارة النقل الأمريكية
CH_AVIATION البيانات مقدَّمة من ch-aviation.
OAG البيانات مقدَّمة من Official Aviation Guide (OAG).
OPERATING_CARRIER البيانات المقدَّمة من مشغّل شبكة الجوّال
AIRCRAFT_MODEL_TYPICAL بيانات نموذجية استنادًا إلى طراز الطائرة
GLOBAL_DEFAULT قيمة تلقائية عامة، تُستخدَم عندما لا يتوفّر أي مصدر بيانات آخر
IATA البيانات مقدَّمة من الاتحاد الدولي للنقل الجوي (IATA).
ICL البيانات مقدَّمة من كلية Imperial College London.

EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy

استراتيجية استهلاك الوقود في المنطقة الاقتصادية الأوروبية قد تتم إضافة قيم جديدة في المستقبل. يجب أن تكون التطبيقات جاهزة للتعامل مع قيم التعداد غير المعروفة بشكل سليم.

عمليات التعداد
STRATEGY_UNSPECIFIED لم يتم تحديد الاستراتيجية.
AIRCRAFT_MAPPING_FALLBACK_WITH_CORRECTION_FACTOR تم تطبيق عامل تصحيح ثابت.
AIRCRAFT_MAPPING_EXACT تم استخدام بيانات دقيقة لتحديد موقع الطائرة.
AIRCRAFT_MAPPING_FALLBACK تم استخدام عملية ربط احتياطية بين الطائرات.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy

استراتيجية عوامل حمولة الركّاب في T100 قد تتم إضافة قيم جديدة في المستقبل. يجب أن تكون التطبيقات جاهزة للتعامل مع قيم التعداد غير المعروفة بشكل سليم.

عمليات التعداد
STRATEGY_UNSPECIFIED لم يتم تحديد الاستراتيجية.
CARRIER_ROUTE_MONTH بيانات حسب شركة النقل والمسار وشهر السفر
CARRIER_MONTH البيانات حسب شركة النقل وشهر السفر
ACTUAL_CARRIER_ROUTE_YEAR_MONTH البيانات السابقة التي تتطابق مع شركة النقل والمسار والسنة والشهر

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy

استراتيجية عوامل الحمولة في CH-Aviation قد تتم إضافة قيم جديدة في المستقبل. يجب أن تكون التطبيقات جاهزة للتعامل مع قيم التعداد غير المعروفة بشكل سليم.

عمليات التعداد
STRATEGY_UNSPECIFIED لم يتم تحديد الاستراتيجية.
CARRIER_MONTH البيانات حسب شركة النقل وشهر السفر
ACTUAL_CARRIER_YEAR_MONTH البيانات السابقة التي تتطابق مع شركة النقل والسنة والشهر

EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy

استراتيجية الكسر الكتلي للحمولة في T100 قد تتم إضافة قيم جديدة في المستقبل. يجب أن تكون التطبيقات جاهزة للتعامل مع قيم التعداد غير المعروفة بشكل سليم.

عمليات التعداد
STRATEGY_UNSPECIFIED لم يتم تحديد الاستراتيجية.
CARRIER_ROUTE_AIRCRAFT_CLASS البيانات حسب شركة النقل والمسار ودرجة الطائرة
ROUTE_AIRCRAFT_CLASS البيانات حسب المسار ودرجة السفر على متن الطائرة
DISTANCE_AIRCRAFT_CLASS البيانات حسب نطاق المسافة وفئة الطائرة
ACTUAL_CARRIER_ROUTE_YEAR_MONTH_AIRCRAFT_CLASS البيانات السابقة التي تتطابق مع شركة النقل والمسار والسنة والشهر وفئة الطائرة

EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy

استراتيجية نسب مساحة المقاعد في الاتحاد الدولي للنقل الجوي قد تتم إضافة قيم جديدة في المستقبل. يجب أن تكون التطبيقات جاهزة للتعامل مع قيم التعداد غير المعروفة بشكل سليم.

عمليات التعداد
STRATEGY_UNSPECIFIED لم يتم تحديد الاستراتيجية.
NARROW_AIRCRAFT_BODY تم استخدام نِسَب مساحة المقاعد في الطائرات ذات الجسم النحيف.
WIDE_AIRCRAFT_BODY تم استخدام نسب مساحة المقاعد في الطائرات ذات الجسم العريض.

EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy

استراتيجية تعديل المسافة قد تتم إضافة قيم جديدة في المستقبل. يجب أن تكون التطبيقات جاهزة للتعامل مع قيم التعداد غير المعروفة بشكل سليم.

عمليات التعداد
STRATEGY_UNSPECIFIED لم يتم تحديد الاستراتيجية.
ORIGIN_DESTINATION عامل تعديل المسافة الذي يتم تحديده حسب زوج مطارَي المغادرة والوصول
COUNTRY_PAIR عامل تعديل المسافة الذي يتم تحديده حسب البلد المصدر وبلد الوجهة
DEFAULT يستند عامل تعديل المسافة إلى القيمة التلقائية لأنّنا لم نعثر على عامل تعديل خاص بالمطار أو البلد.

EmissionsProvenance.EmissionsProvenanceEntry.DataCategory

فئة البيانات لمصدر البيانات قد تتم إضافة قيم جديدة في المستقبل. يجب أن تكون التطبيقات جاهزة للتعامل مع قيم التعداد غير المعروفة بشكل سليم.

عمليات التعداد
DATA_CATEGORY_UNSPECIFIED فئة البيانات غير محدّدة.
PRIMARY البيانات الأساسية، كما هو محدّد في ISO 14083
MODELED البيانات المستنِدة إلى نماذج، كما هو محدّد في ISO 14083
DEFAULT تمثّل هذه السمة بيانات القيمة التلقائية، كما هو محدّد في معيار ISO 14083.