Package google.travel.sustainability.travelimpactmodel.v1

الفهرس

• TravelImpactModelService (واجهة)
• ComputeFlightEmissionsRequest (رسالة)
• ComputeFlightEmissionsResponse (رسالة)
• ComputeScope3FlightEmissionsRequest (رسالة)
• ComputeScope3FlightEmissionsResponse (رسالة)
• ComputeTypicalFlightEmissionsRequest (رسالة)
• ComputeTypicalFlightEmissionsResponse (رسالة)
• ContrailsImpactBucket (تعداد)
• EasaLabelMetadata (رسالة)
• EmissionsGramsPerPax (رسالة)
• Flight (رسالة)
• FlightWithEmissions (رسالة)
• Market (رسالة)
• ModelVersion (رسالة)
• Scope3FlightEmissions (رسالة)
• Scope3FlightEmissions.Scope3DataType (تعداد)
• Scope3FlightSegment (رسالة)
• Scope3FlightSegment.CabinClass (تعداد)
• Source (تعداد)
• TypicalFlightEmissions (رسالة)

TravelImpactModelService

واجهة برمجة تطبيقات لتقديم تقديرات انبعاثات الكربون

ComputeFlightEmissions

rpc ComputeFlightEmissions(ComputeFlightEmissionsRequest) returns (ComputeFlightEmissionsResponse) طريقة غير مرتبطة بحالة لاسترداد تقديرات الانبعاثات. يمكنك الاطّلاع على تفاصيل حول كيفية احتساب تقديرات الانبعاثات في GitHub. سيتضمّن الردّ جميع الإدخالات التي تتطابق مع رحلات الطيران المحدّدة، وبالترتيب نفسه. إذا لم تتوفّر تقديرات لجزء معيّن من الرحلة الجوية، سيعرض الردّ عنصر جزء الرحلة الجوية مع حقول انبعاثات فارغة. وسيظل الطلب يُعدّ ناجحًا. تشمل أسباب عدم توفّر تقديرات الانبعاثات ما يلي: الرحلة غير معروفة للخادم. لا يتضمّن جزء رحلة الطيران الذي تم إدخاله معرّفًا واحدًا أو أكثر. تاريخ الرحلة في الماضي لا يتوافق نوع الطائرة مع الطراز. لم يتم ضبط إعدادات المقاعد. يمكن أن يتضمّن الطلب ما يصل إلى 1,000 جزء من رحلة جوية. إذا كان الطلب يتضمّن أكثر من 1, 000 رحلة جوية مباشرة، سيتعذّر تنفيذه وسيظهر الخطأ INVALID_ARGUMENT.

ComputeScope3FlightEmissions

rpc ComputeScope3FlightEmissions(ComputeScope3FlightEmissionsRequest) returns (ComputeScope3FlightEmissionsResponse) طريقة غير مرتبطة بحالة معيّنة لاسترداد تقديرات انبعاثات الغازات الدفيئة لمجموعة من شرائح الرحلات الجوية لإعداد تقارير النطاق 3 سيتضمّن الردّ جميع الإدخالات التي تتطابق مع شرائح الرحلات الجوية Scope3FlightSegment، بالترتيب نفسه المقدَّم. سيتم احتساب التقديرات باستخدام المنطق المتتالي التالي (باستخدام أول تقدير متاح): الانبعاثات المستندة إلى "نموذج تأثير السفر" (TIM) مع الأخذ في الاعتبار origin وdestination وcarrier وflightNumber وdepartureDate وcabinClass مستوى الانبعاثات المعتاد للرحلة الجوية هو origin، وdestination، والسنة هي departureDate، وcabinClass. يتم احتساب الانبعاثات المستندة إلى المسافة باستخدام distanceKm وdepartureDate وcabinClass. إذا كان هناك رحلة جوية مستقبلية مطلوبة في هذه السنة التقويمية، لا نتيح حساب انبعاثات المستوى 1، وسنستخدم بدلاً من ذلك انبعاثات المستوى 2 أو 3. إذا كانت الرحلة المستقبلية المطلوبة لا تقع في سنة التقويم الحالية، سنعرض ردًا فارغًا. ننصحك باستخدام واجهة برمجة التطبيقات computeFlightEmissions بدلاً من ذلك للرحلات الجوية المستقبلية. إذا لم تتوفّر تقديرات لرحلة جوية معيّنة باستخدام أيّ من الطرق الثلاث، سيعرض الردّ عنصر Scope3FlightEmissions مع حقول انبعاثات فارغة. وسيظل الطلب يُعدّ ناجحًا. بشكل عام، يحدث عدم توفّر تقديرات الانبعاثات عندما لا يكون الخادم على علم بالرحلة الجوية (مثلاً، لا توجد رحلة جوية محدّدة، أو لا تتوفّر بيانات الانبعاثات العادية للرحلات الجوية للزوج المطلوب). سيتعذّر تنفيذ الطلب مع ظهور الخطأ INVALID_ARGUMENT في الحالات التالية: يحتوي الطلب على أكثر من 1,000 جزء من رحلة جوية. لا يتضمّن جزء رحلة الطيران الذي تم إدخاله معرّفًا واحدًا أو أكثر. على سبيل المثال، عدم توفّر نقطة الانطلاق/الوجهة بدون مسافة صالحة لتطابق النوع TIM_EMISSIONS أو TYPICAL_FLIGHT_EMISSIONS، أو عدم توفّر مسافة لتطابق النوع DISTANCE_BASED_EMISSIONS (إذا كنت تريد الرجوع إلى الانبعاثات المستندة إلى المسافة أو تريد تقدير الانبعاثات المستندة إلى المسافة، عليك تحديد مسافة). تاريخ الرحلة الجوية يسبق العام 2019 (لا تتوفّر بيانات النطاق 3 إلا للعام 2019 وما بعده). مسافة الرحلة الجوية هي 0 أو أقل. درجة السفر غير متوفّرة. بما أنّ الطلب تتم معالجته باستخدام منطق احتياطي، من المحتمل أن تعرض الطلبات التي تم إعدادها بشكل غير صحيح تقديرات صحيحة للانبعاثات باستخدام طرق احتياطية. على سبيل المثال، إذا كان الطلب يتضمّن رقم رحلة جوية غير صحيح ولكن يحدّد نقطة المغادرة والوجهة، سيظل الطلب ناجحًا، ولكن ستستند الانبعاثات التي يتم عرضها إلى الانبعاثات النموذجية للرحلة الجوية فقط. وبالمثل، إذا كان طلب عادي بشأن انبعاثات الرحلات الجوية لا يتضمّن نقطة الانطلاق، ولكنّه يحدّد مسافة صالحة، يمكن أن ينجح الطلب استنادًا إلى الانبعاثات المستندة إلى المسافة فقط. نتيجةً لذلك، يجب التحقّق من مصدر الانبعاثات التي تم إرجاعها (source) للتأكّد من أنّ النتائج هي كما هو متوقّع.

ComputeTypicalFlightEmissions

rpc ComputeTypicalFlightEmissions(ComputeTypicalFlightEmissionsRequest) returns (ComputeTypicalFlightEmissionsResponse) تعرض هذه الطريقة تقديرات لمستوى الانبعاثات العادي للرحلات الجوية بين مطارَين، ويُعرف ذلك أيضًا باسم السوق. إذا لم تتوفّر تقديرات لسوق معيّنة، سيعرض الردّ عنصر السوق مع حقول انبعاثات فارغة. وسيظل الطلب يُعدّ ناجحًا. يمكنك الاطّلاع على تفاصيل حول كيفية احتساب تقديرات مستوى الانبعاثات العادي على GitHub. يمكن أن يتضمّن الطلب ما يصل إلى 1,000 سوق. إذا كان الطلب يتضمّن أكثر من 1, 000 سوق، سيتعذّر تنفيذه وسيظهر الخطأ INVALID_ARGUMENT.

ComputeFlightEmissionsRequest

تعريف الإدخال لطلب ComputeFlightEmissions

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

ComputeFlightEmissionsResponse

تعريف الإخراج لردّ ComputeFlightEmissions

الحقول
flight_emissions[]	FlightWithEmissions قائمة برحلات جوية تتضمّن تقديرات الانبعاثات
model_version	ModelVersion تم احتساب تقديرات الانبعاثات لجميع الرحلات الجوية في هذا الردّ باستخدام إصدار النموذج التالي.

ComputeScope3FlightEmissionsRequest

تمثّل هذه السمة قائمة بمقاطع الرحلات الجوية التي يجب طلب بيانات انبعاثات النطاق 3 لها.

الحقول
flights[]	Scope3FlightSegment الحقل مطلوب. الرحلات الجوية التي سيتم عرض تقديرات الانبعاثات لها.
model_version	ModelVersion اختيارية: تم احتساب تقديرات الانبعاثات لجميع الرحلات الجوية في هذا الطلب باستخدام إصدار النموذج هذا.

ComputeScope3FlightEmissionsResponse

قائمة بالرحلات الجوية مع تقديرات الانبعاثات من النطاق 3

الحقول
flight_emissions[]	Scope3FlightEmissions قائمة بشرائح الرحلات الجوية مع تقديرات الانبعاثات
model_version	ModelVersion تم احتساب تقديرات الانبعاثات لجميع الرحلات الجوية في هذا الردّ باستخدام إصدار النموذج التالي.

ComputeTypicalFlightEmissionsRequest

قائمة بمجموعات من المطارات (الأسواق) لطلب بيانات الانبعاثات النموذجية الخاصة بها.

الحقول
markets[]	Market الحقل مطلوب. اطلب تقديرات مستوى الانبعاثات العادي للرحلات الجوية في هذا السوق. يمكن طلب 1,000 سوق كحدّ أقصى.

ComputeTypicalFlightEmissionsResponse

تتضمّن الاستجابة الانبعاثات وإصدار النموذج أيضًا.

الحقول
typical_flight_emissions[]	TypicalFlightEmissions تم طلب مستوى الانبعاثات العادي في الرحلات الجوية في السوق.
model_version	ModelVersion إصدار النموذج الذي تم بموجبه احتساب تقديرات مستوى الانبعاثات العادي للرحلات الجوية في هذه الاستجابة

ContrailsImpactBucket

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

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

EasaLabelMetadata

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

الحقول
label_issue_date	Date تمثّل هذه السمة تاريخ إصدار التصنيف.
label_expiry_date	Date يشير إلى تاريخ انتهاء صلاحية التصنيف. يمكن عرض التصنيف حتى نهاية هذا التاريخ.
label_version	string إصدار التصنيف
saf_discount_percentage	double النسبة المئوية للخصم على انبعاثات وقود الطيران المستدام (SAF) المطبَّقة على التصنيف وهي نسبة مئوية كقيمة عشرية. تندرج القيم ضمن الفاصل [0,1]. على سبيل المثال، 0.0021 تعني %0.21. يتم الإبلاغ عن هذا الخصم والانخفاض في الانبعاثات من خلال تصنيف وكالة EASA، ولكنّهما غير مضمّنين في تقديرات مكافئ ثاني أكسيد الكربون التي توفّرها واجهة برمجة التطبيقات هذه.

EmissionsGramsPerPax

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

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

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

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

الحقول
origin	string الحقل مطلوب. رمز IATA لمطار نقطة انطلاق الرحلة الجوية، مثل "LHR".
destination	string الحقل مطلوب. رمز اتحاد النقل الجوي الدولي لمطار وجهة الرحلة الجوية، مثل "JFK".
operating_carrier_code	string الحقل مطلوب. رمز شركة النقل التابعة للاتحاد الدولي للنقل الجوي (IATA)، مثل "AA".
flight_number	int32 الحقل مطلوب. رقم الرحلة الجوية، مثل 324
departure_date	Date الحقل مطلوب. تاريخ الرحلة الجوية في المنطقة الزمنية لمطار نقطة الانطلاق يجب أن يكون تاريخًا في الوقت الحاضر أو المستقبل.

FlightWithEmissions

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

الحقول
flight	Flight الحقل مطلوب. تطابق هذه السمة معرّفات الرحلات الجوية في الطلب. ملاحظة: جميع رموز الاتحاد الدولي للنقل الجوي مكتوبة بأحرف كبيرة.
source	Source اختيارية: مصدر بيانات الانبعاثات
emissions_grams_per_pax	EmissionsGramsPerPax اختيارية: أرقام تقديرات الانبعاثات لكل راكب لن يظهر هذا الحقل إذا تعذّر احتساب الانبعاثات. للاطّلاع على قائمة بالأسباب التي أدّت إلى تعذّر احتساب الانبعاثات، يُرجى الانتقال إلى ComputeFlightEmissions.
easa_label_metadata	EasaLabelMetadata اختيارية: بيانات وصفية حول تصنيف انبعاثات الرحلات الجوية الصادر عن وكالة سلامة الطيران الأوروبية (EASA) يجب ضبط هذه السمة فقط عندما يكون مصدر بيانات الانبعاثات هو EASA.
contrails_impact_bucket	ContrailsImpactBucket اختيارية: أهمية تأثير الاحتباس الحراري الناتج عن مسارات التكاثف مقارنةً بإجمالي تأثير انبعاثات ثاني أكسيد الكربون المكافئ

السوق

زوج من المطارات

الحقول
origin	string الحقل مطلوب. رمز IATA لمطار نقطة انطلاق الرحلة الجوية، مثل "LHR".
destination	string الحقل مطلوب. رمز اتحاد النقل الجوي الدولي لمطار وجهة الرحلة الجوية، مثل "JFK".

ModelVersion

إصدار "نموذج تأثير السفر" لمزيد من المعلومات عن تحديد إصدار النموذج، يُرجى الاطّلاع على GitHub.

الحقول
major	int32 الإصدارات الرئيسية: تغييرات كبيرة في المنهجية (مثل إضافة مصادر بيانات جديدة إلى النموذج تؤدي إلى تغييرات كبيرة في النتائج). ولن تحدث هذه التغييرات إلا نادرًا، وسيتم الإعلان عنها قبل فترة طويلة. قد يتضمّن تغييرات في إصدار واجهة برمجة التطبيقات، والتي ستلتزم بإرشادات Google Cloud API
minor	int32 الإصدارات الثانوية: تغييرات في النموذج، مع أنّها متسقة مع جميع إصدارات المخطط، إلا أنّها تغيّر مَعلمات النموذج أو تنفيذه.
patch	int32 إصدارات التصحيح: تغييرات في التنفيذ تهدف إلى معالجة الأخطاء أو عدم الدقة في تنفيذ النموذج.
dated	string الإصدارات القديمة: تتم إعادة إنشاء مجموعات بيانات النماذج باستخدام بيانات الإدخال المُعاد تحميلها، ولكن بدون تغيير الخوارزميات بانتظام.

Scope3FlightEmissions

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

الحقول
flight	Scope3FlightSegment الحقل مطلوب. تطابق هذه السمة معرّفات الرحلات الجوية في الطلب.
wtw_emissions_grams_per_pax	int64 اختيارية: إجمالي انبعاثات الرحلة الجوية (مجموع الانبعاثات من المصدر إلى الخزان ومن الخزان إلى العادم) لكل مسافر استنادًا إلى المعلومات المطلوبة. هذا هو إجمالي الانبعاثات، وما لم يكن لديك أسباب محددة لاستخدام انبعاثات "من الخزان إلى العادم" أو "من المصدر إلى الخزان"، عليك استخدام هذا الرقم.
ttw_emissions_grams_per_pax	int64 اختيارية: انبعاثات الرحلة الجوية من الوقود إلى العجلات لكل مسافر استنادًا إلى المعلومات المطلوبة
wtt_emissions_grams_per_pax	int64 اختيارية: انبعاثات الرحلة الجوية من المصدر إلى الخزان لكل مسافر استنادًا إلى المعلومات المطلوبة
source	Scope3DataType اختيارية: مصدر بيانات الانبعاثات

Scope3DataType

نوع المطابقة المُستخدَم لاحتساب انبعاثات النطاق 3 يُستخدَم هذا الحقل في استجابة Scope 3 لتحديد الطريقة المستخدَمة في احتساب الانبعاثات.

عمليات التعداد
SCOPE3_DATA_TYPE_UNSPECIFIED	نوع البيانات غير محدَّد.
TIM_EMISSIONS	الانبعاثات المستندة إلى TIM مع تحديد نقطة الانطلاق والوجهة وشركة النقل ورقم الرحلة وتاريخ المغادرة والسنة
TYPICAL_FLIGHT_EMISSIONS	مستوى الانبعاثات العادي للرحلات الجوية حسب نقطة الانطلاق والوجهة والسنة
DISTANCE_BASED_EMISSIONS	الانبعاثات المستندة إلى المسافة استنادًا إلى المسافة المقطوعة والسنة

Scope3FlightSegment

مَعلمات الرحلة الجوية التي يتم جلب انبعاثات النطاق 3 منها

الحقول
departure_date	Date الحقل مطلوب. تاريخ الرحلة الجوية في المنطقة الزمنية لمطار نقطة الانطلاق يُشترط تحديد العام فقط لنماذج احتساب مستوى الانبعاثات العادي للرحلات الجوية ونماذج احتساب مستوى الانبعاثات استنادًا إلى المسافة (يتم تجاهل قيم الشهر واليوم، وبالتالي يمكن إغفالها أو ضبطها على 0 أو ضبطها على تاريخ صالح في هذه الحالات). وبالمثل، إذا لم يتم تقديم تاريخ محدّد لانبعاثات TIM، سنعود إلى الانبعاثات العادية للرحلة الجوية (أو الانبعاثات المستندة إلى المسافة).
cabin_class	CabinClass الحقل مطلوب. درجة السفر على متن الرحلة الجوية
origin	string اختيارية: رمز الاتحاد الدولي للنقل الجوي لمطار نقطة انطلاق الرحلة الجوية، مثل YVR تُستخدَم هذه السمة لمطابقة رحلة جوية معيّنة إذا تم تقديمها مع الوجهة وشركة الطيران ورقم الرحلة. في حال عدم العثور على رحلة جوية مطابقة، سنحاول أولاً مطابقة الرحلة الجوية مع رحلة جوية نموذجية بين مطارَي المغادرة والوصول المحدَّدَين. بخلاف ذلك، سنستخدم نموذج الانبعاثات المستند إلى المسافة إذا تم توفير مسافة الرحلة.
destination	string اختيارية: رمز اتحاد النقل الجوي الدولي لمطار وجهة الرحلة الجوية، مثل ICN تُستخدَم هذه السمة لمطابقة رحلة جوية معيّنة إذا تم تقديمها مع نقطة الانطلاق وشركة النقل ورقم الرحلة. في حال عدم العثور على رحلة جوية مطابقة، سنحاول أولاً مطابقة الرحلة الجوية مع رحلة جوية نموذجية بين مطارَي المغادرة والوصول المحدَّدَين. بخلاف ذلك، سنستخدم نموذج الانبعاثات المستند إلى المسافة إذا تم توفير مسافة الرحلة.
carrier_code	string اختيارية: رمز شركة النقل الجوي التابعة للاتحاد الدولي للنقل الجوي (IATA)، مثل KE هذه السمة مطلوبة إذا كنت تريد مطابقة رحلات جوية معيّنة. وفي ما عدا ذلك، لا يتم استخدام هذه السمة في نماذج الانبعاثات النموذجية المستندة إلى الرحلات الجوية والمسافة. يمكن أن يكون هذا الرمز هو رمز شركة النقل التشغيلية والتسويقية (أي أنّ المشاركة في الرمز مشمولة).
flight_number	int32 اختيارية: رقم الرحلة الجوية، مثل 71 يُستخدَم هذا الحقل أولاً لمطابقة رحلة جوية معيّنة في حال تحديد رقم الرحلة مع نقطة الانطلاق والوجهة وشركة الطيران. في حال عدم تحديد رقم الرحلة، سنحاول أولاً مطابقة الرحلة مع رحلة نموذجية بين مطارَي المغادرة والوصول المحدَّدَين. إذا لم ينجح ذلك و/أو لم يتم تقديم المصدر والوجهة، سنستخدم نموذج الانبعاثات المستند إلى المسافة استنادًا إلى مسافة الرحلة الجوية المقدَّمة.
distance_km	int64 اختيارية: المسافة بالكيلومتر، مثل 2423 يُستخدَم هذا المعرّف لمطابقة رحلة جوية مع الانبعاثات المستندة إلى المسافة عندما لا يتم تقديم معلومات عن نقطة المغادرة والوجهة أو عندما لا تتوفّر رحلات جوية عادية مطابقة. يقبل هذا الحقل قيمًا تتراوح بين 0 و2.5e16 كيلومتر.

CabinClass

درجة السفر على متن الرحلة الجوية

عمليات التعداد
CABIN_CLASS_UNSPECIFIED	درجة سفر غير محدّدة
ECONOMY	الدرجة الاقتصادية
PREMIUM_ECONOMY	الدرجة الاقتصادية المميزة
BUSINESS	درجة رجال الأعمال
FIRST	الدرجة الأولى

المصدر

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

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

TypicalFlightEmissions

تقديرات مستوى الانبعاثات العادي للرحلات الجوية في سوق معيّن

الحقول
market	Market الحقل مطلوب. تطابق هذه السمة معرّفات الرحلات الجوية في الطلب. ملاحظة: جميع رموز الاتحاد الدولي للنقل الجوي مكتوبة بأحرف كبيرة.
emissions_grams_per_pax	EmissionsGramsPerPax اختيارية: مستوى الانبعاثات العادي في الرحلات الجوية لكل راكب في السوق المطلوب لن تظهر هذه السمة إذا تعذّر احتساب الانبعاثات النموذجية. للاطّلاع على قائمة بأسباب عدم إمكانية احتساب الانبعاثات النموذجية للرحلة الجوية، يُرجى الانتقال إلى GitHub.