Method: flights.computeFlightEmissions

طريقة انعدام الحالة لاسترداد تقديرات الانبعاثات. تفاصيل حول طريقة احتساب تقديرات الانبعاثات: https://github.com/google/travel-impact-model

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

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

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

طلب HTTP

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

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

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

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

object (Flight)

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

نص الاستجابة

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

تعريف نتيجة استجابة [flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.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

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

string

مطلوبة. رمز شركة النقل للاتحاد الدولي للنقل الجوي، مثل "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)
  },
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
الحقول
flight

object (Flight)

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

object (EmissionsGramsPerPax)

اختياريّ. أرقام تقديرات الانبعاثات لكل راكب. لن يتوفَّر هذا إذا تعذّر حساب الانبعاثات. للاطّلاع على قائمة بأسباب عدم احتساب الانبعاثات، يُرجى الانتقال إلى [flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions].

EmissionsGramsPerPax

نتائج الانبعاثات المجمّعة لكل درجة جلوس

تمثيل JSON 
{
  "first": integer,
  "business": integer,
  "premiumEconomy": integer,
  "economy": integer
}
الحقول
first

integer

الانبعاثات بالغرام لراكب واحد في الدرجة الأولى. يتم حساب هذا الحقل وملئه دائمًا، بغض النظر عما إذا كانت الطائرة تحتوي على مقاعد من الدرجة الأولى أم لا.
business

integer

الانبعاثات بالغرام لراكب واحد في درجة رجال الأعمال. يتم دائمًا حساب هذا الحقل وتعبئته، بغض النظر عمّا إذا كانت الطائرة تحتوي على مقاعد في درجة رجال الأعمال أم لا.
premiumEconomy

integer

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

integer

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

ModelVersion

إصدار نموذج "تأثير السفر" لمزيد من المعلومات عن إصدارات النماذج، اطّلِع على الرابط https://github.com/google/travel-impact-model/#versioning.

تمثيل JSON 
{
  "major": integer,
  "minor": integer,
  "patch": integer,
  "dated": string
}
الحقول
major

integer

الإصدارات الرئيسية: التغييرات الرئيسية على المنهجية (مثل إضافة مصادر بيانات جديدة إلى النموذج تؤدي إلى تغييرات رئيسية في الإخراج). ستكون هذه التغييرات نادرة وسيتم الإعلان عنها مسبقًا. قد يتضمّن ذلك تغييرات في إصدار واجهة برمجة التطبيقات، بما يتوافق مع الإرشادات الواردة في https://cloud.google.com/endpoints/docs/openapi/versioning-an-api#backwards-incompatible.
minor

integer

الإصدارات الثانوية: التغييرات على النموذج التي تؤدي إلى تغيير معلَمات النموذج أو تنفيذه مع الاتساق في جميع إصدارات المخطط.
patch

integer

إصدارات التصحيح: تغييرات في التنفيذ تهدف إلى معالجة الأخطاء أو عدم الدقة في تنفيذ النموذج
dated

string

النُسخ ذات التاريخَين: تتم إعادة إنشاء مجموعات بيانات النماذج باستخدام بيانات إدخال مُعاد تحميلة ولكن بدون أي تغيير في الخوارزميات بانتظام.