الفهرس
TravelImpactModelService(واجهة)ComputeFlightEmissionsRequest(رسالة)ComputeFlightEmissionsResponse(رسالة)ComputeScope3FlightEmissionsRequest(رسالة)ComputeScope3FlightEmissionsResponse(رسالة)ComputeTypicalFlightEmissionsRequest(رسالة)ComputeTypicalFlightEmissionsResponse(رسالة)ContrailsImpactBucket(تعداد)EasaLabelMetadata(رسالة)EmissionsGramsPerPax(رسالة)Flight(رسالة)FlightWithEmissions(رسالة)Market(رسالة)ModelVersion(رسالة)Scope3FlightEmissions(رسالة)Scope3FlightEmissions.Scope3DataType(تعداد)Scope3FlightSegment(رسالة)Scope3FlightSegment.CabinClass(تعداد)Source(تعداد)TypicalFlightEmissions(رسالة)
TravelImpactModelService
واجهة برمجة تطبيقات لتقديم تقديرات انبعاثات الكربون
| ComputeFlightEmissions |
|---|
|
طريقة غير مرتبطة بحالة لاسترداد تقديرات الانبعاثات. يمكنك الاطّلاع على تفاصيل حول كيفية احتساب تقديرات الانبعاثات في GitHub. سيتضمّن الردّ جميع الإدخالات التي تتطابق مع رحلات الطيران المحدّدة، وبالترتيب نفسه. إذا لم تتوفّر تقديرات لجزء معيّن من الرحلة الجوية، سيعرض الردّ عنصر جزء الرحلة الجوية مع حقول فارغة للانبعاثات. وسيظل الطلب ناجحًا. تشمل أسباب عدم توفّر تقديرات الانبعاثات ما يلي:
يمكن أن يتضمّن الطلب ما يصل إلى 1,000 جزء من رحلة جوية. إذا كان الطلب يتضمّن أكثر من 1, 000 رحلة جوية مباشرة، سيتعذّر تنفيذه وسيظهر الخطأ INVALID_ARGUMENT. |
| ComputeScope3FlightEmissions |
|---|
|
طريقة غير مرتبطة بحالة معيّنة لاسترداد تقديرات انبعاثات الغازات الدفيئة لمجموعة من أقسام الرحلات الجوية لإعداد تقارير النطاق 3 سيتضمّن الردّ جميع الإدخالات التي تتطابق مع شرائح الرحلات الجوية
إذا كان هناك رحلة جوية مستقبلية مطلوبة في هذه السنة التقويمية، لا نتيح بيانات الانبعاثات من المستوى 1 وسنستخدم بيانات الانبعاثات من المستوى 2 أو 3. إذا كانت الرحلة المستقبلية المطلوبة لا تقع في سنة التقويم الحالية، سنعرض ردًا فارغًا. ننصح باستخدام واجهة برمجة التطبيقات إذا لم تتوفّر تقديرات لرحلة جوية معيّنة باستخدام أيّ من الطرق الثلاث، سيعرض الردّ عنصر سيتعذّر تنفيذ الطلب مع ظهور الخطأ
بما أنّ الطلب تتم معالجته باستخدام منطق احتياطي، من المحتمل أن تعرض الطلبات التي تم إعدادها بشكل غير صحيح تقديرات صحيحة للانبعاثات باستخدام طرق احتياطية. على سبيل المثال، إذا كان الطلب يتضمّن رقم رحلة جوية غير صحيح ولكن يحدّد نقطة المغادرة والوجهة، سيظل الطلب ناجحًا، ولكن ستستند الانبعاثات التي يتم عرضها إلى الانبعاثات النموذجية للرحلة الجوية فقط. وبالمثل، إذا كان طلب ما لا يتضمّن مصدرًا لطلب عادي بشأن انبعاثات الرحلات الجوية، ولكنّه يحدّد مسافة صالحة، يمكن أن ينجح الطلب استنادًا إلى الانبعاثات المستندة إلى المسافة فقط. نتيجةً لذلك، يجب التحقّق من مصدر الانبعاثات التي تم إرجاعها ( |
| ComputeTypicalFlightEmissions |
|---|
|
تعرض هذه الطريقة تقديرات لمستوى الانبعاثات العادي للرحلات الجوية بين مطارَين، ويُعرف ذلك أيضًا باسم السوق. إذا لم تتوفّر تقديرات لسوق معيّنة، سيعرض الردّ عنصر السوق مع حقول انبعاثات فارغة. وسيظل الطلب ناجحًا. يمكنك الاطّلاع على تفاصيل حول كيفية احتساب تقديرات مستوى الانبعاثات العادي في GitHub. يمكن أن يتضمّن الطلب ما يصل إلى 1,000 سوق. إذا كان الطلب يتضمّن أكثر من 1, 000 سوق، سيتعذّر تنفيذه وسيظهر الخطأ INVALID_ARGUMENT. |
ComputeFlightEmissionsRequest
تعريف الإدخال لطلب ComputeFlightEmissions
| الحقول | |
|---|---|
flights[] |
الحقل مطلوب. رحلات جوية مباشرة يتم عرض تقديرات الانبعاثات لرحلات العودة فيها |
ComputeFlightEmissionsResponse
تعريف الإخراج لردّ ComputeFlightEmissions
| الحقول | |
|---|---|
flight_emissions[] |
قائمة بأجزاء الرحلة الجوية مع تقديرات الانبعاثات |
model_version |
تم احتساب تقديرات الانبعاثات لجميع الرحلات الجوية في هذا الردّ باستخدام إصدار النموذج التالي. |
ComputeScope3FlightEmissionsRequest
تمثّل هذه السمة قائمة بمقاطع الرحلات الجوية التي يجب طلب بيانات انبعاثات النطاق 3 لها.
| الحقول | |
|---|---|
flights[] |
الحقل مطلوب. الرحلات الجوية التي سيتم عرض تقديرات الانبعاثات لها. |
model_version |
اختياريّ. تم احتساب تقديرات الانبعاثات لجميع الرحلات الجوية في هذا الطلب باستخدام إصدار النموذج هذا. |
ComputeScope3FlightEmissionsResponse
قائمة بالرحلات الجوية مع تقديرات انبعاثات النطاق 3
| الحقول | |
|---|---|
flight_emissions[] |
قائمة بشرائح الرحلات الجوية مع تقديرات الانبعاثات |
model_version |
تم احتساب تقديرات الانبعاثات لجميع الرحلات الجوية في هذا الردّ باستخدام إصدار النموذج التالي. |
ComputeTypicalFlightEmissionsRequest
قائمة بمجموعات من المطارات (الأسواق) لطلب بيانات الانبعاثات النموذجية الخاصة بها.
| الحقول | |
|---|---|
markets[] |
الحقل مطلوب. اطلب تقديرات مستوى الانبعاثات العادي للرحلات الجوية في هذا السوق. يمكن طلب 1,000 سوق كحدّ أقصى. |
ComputeTypicalFlightEmissionsResponse
تتضمّن الاستجابة الانبعاثات وإصدار النموذج أيضًا.
| الحقول | |
|---|---|
typical_flight_emissions[] |
تم طلب مستوى الانبعاثات العادي في الرحلات الجوية في السوق. |
model_version |
إصدار النموذج الذي تم بموجبه احتساب تقديرات مستوى الانبعاثات العادي للرحلات الجوية في هذه الاستجابة |
ContrailsImpactBucket
تشير هذه السمة إلى أهمية تأثير مسارات التكاثف على الاحتباس الحراري مقارنةً بإجمالي تأثير انبعاثات مكافئ ثاني أكسيد الكربون (CO2e).
| عمليات التعداد | |
|---|---|
CONTRAILS_IMPACT_UNSPECIFIED |
لم يتم تحديد تأثيرات الطائرات النفاثة. |
CONTRAILS_IMPACT_NEGLIGIBLE |
تأثير مسارات التكاثف ضئيل مقارنةً بإجمالي انبعاثات مكافئ ثاني أكسيد الكربون (CO2e). |
CONTRAILS_IMPACT_MODERATE |
ويكون تأثير مسارات التكاثف مماثلاً لإجمالي انبعاثات مكافئ ثاني أكسيد الكربون (CO2e). |
CONTRAILS_IMPACT_SEVERE |
ويكون تأثير مسارات التكاثف أعلى من إجمالي تأثير انبعاثات ثاني أكسيد الكربون المكافئ. |
EasaLabelMetadata
بيانات وصفية حول تصنيف انبعاثات الرحلات الجوية الصادر عن وكالة سلامة الطيران الأوروبية (EASA)
| الحقول | |
|---|---|
label_issue_date |
تمثّل هذه السمة تاريخ إصدار التصنيف. |
label_expiry_date |
يشير إلى تاريخ انتهاء صلاحية التصنيف. يمكن عرض التصنيف حتى نهاية هذا التاريخ. |
label_version |
إصدار التصنيف |
saf_discount_percentage |
النسبة المئوية للخصم على الانبعاثات الناتجة عن استخدام وقود الطيران المستدام (SAF) والمطبَّقة على التذكرة وهي نسبة مئوية كقيمة عشرية. تندرج القيم ضمن الفاصل [0,1]. على سبيل المثال، يعني 0.0021 أنّ النسبة المئوية هي 0.21%. يتم الإبلاغ عن هذا الخصم والانخفاض في الانبعاثات من خلال تصنيف "وكالة سلامة الطيران الأوروبية"، ولكنّهما غير مضمّنين في تقديرات مكافئ ثاني أكسيد الكربون التي توفّرها واجهة برمجة التطبيقات هذه. |
EmissionsGramsPerPax
نتائج الانبعاثات المجمّعة لكل درجة من درجات المقاعد
| الحقول | |
|---|---|
first |
الانبعاثات لراكب واحد في الدرجة الأولى بالغرام يتم دائمًا احتساب هذا الحقل وملؤه، بغض النظر عمّا إذا كانت الطائرة تتضمّن مقاعد درجة أولى أم لا. |
business |
مستوى الانبعاثات لراكب واحد في درجة رجال الأعمال بالغرام يتم دائمًا احتساب هذا الحقل وتعبئته، بغض النظر عمّا إذا كانت الطائرة تتضمّن مقاعد درجة رجال الأعمال أم لا. |
premium_economy |
الانبعاثات لراكب واحد في الدرجة الاقتصادية المميزة بالغرام يتم دائمًا احتساب هذا الحقل وملؤه، بغض النظر عمّا إذا كانت الطائرة تتضمّن مقاعد درجة اقتصادية مميّزة أم لا. |
economy |
مستوى الانبعاثات لراكب واحد في الدرجة الاقتصادية بالغرام يتم دائمًا احتساب هذا الحقل وملؤه، بغض النظر عمّا إذا كانت الطائرة تتضمّن مقاعد درجة اقتصادية أم لا. |
مدّة عرض الإعلانات
جميع التفاصيل المتعلّقة بطلب واحد لتقديرات انبعاثات الكربون في رحلة طيران مباشرة
| الحقول | |
|---|---|
origin |
الحقل مطلوب. رمز الاتحاد الدولي للنقل الجوي لمطار نقطة انطلاق الرحلة الجوية، مثل "LHR" |
destination |
الحقل مطلوب. رمز المطار التابع لاتحاد النقل الجوي الدولي لوجهة الرحلة الجوية، مثل "JFK". |
operating_carrier_code |
الحقل مطلوب. رمز شركة النقل التابعة للاتحاد الدولي للنقل الجوي (IATA)، مثل "AA". |
flight_number |
الحقل مطلوب. رقم الرحلة الجوية، مثل 324 |
departure_date |
الحقل مطلوب. تمثّل هذه السمة تاريخ الرحلة الجوية في المنطقة الزمنية لمطار نقطة الانطلاق. يجب أن يكون تاريخًا في الوقت الحاضر أو المستقبل. |
FlightWithEmissions
رحلة طيران مباشرة مع تقديرات الانبعاثات
| الحقول | |
|---|---|
flight |
المعرّف. تطابق هذه السمة معرّفات الرحلات الجوية في الطلب. ملاحظة: جميع رموز الاتحاد الدولي للنقل الجوي مكتوبة بأحرف كبيرة. |
source |
اختياريّ. مصدر بيانات الانبعاثات |
emissions_grams_per_pax |
اختياريّ. أرقام تقديرات الانبعاثات لكل راكب لن يظهر هذا الحقل إذا تعذّر احتساب الانبعاثات. للاطّلاع على قائمة بالأسباب التي أدّت إلى تعذّر احتساب الانبعاثات، يُرجى الانتقال إلى |
easa_label_metadata |
اختياريّ. بيانات وصفية حول تصنيف انبعاثات الرحلات الجوية الصادر عن وكالة سلامة الطيران الأوروبية (EASA) يجب ضبط هذه السمة فقط عندما يكون مصدر بيانات الانبعاثات هو EASA. |
contrails_impact_bucket |
اختياريّ. تشير هذه السمة إلى أهمية تأثير مسارات التكاثف على الاحتباس الحراري مقارنةً بإجمالي تأثير انبعاثات مكافئ ثاني أكسيد الكربون (CO2e). |
السوق
زوج من المطارات
| الحقول | |
|---|---|
origin |
الحقل مطلوب. رمز الاتحاد الدولي للنقل الجوي لمطار نقطة انطلاق الرحلة الجوية، مثل "LHR" |
destination |
الحقل مطلوب. رمز المطار التابع لاتحاد النقل الجوي الدولي لوجهة الرحلة الجوية، مثل "JFK". |
ModelVersion
إصدار "نموذج تأثير السفر" لمزيد من المعلومات عن تحديد إصدار النموذج، يُرجى الاطّلاع على GitHub.
| الحقول | |
|---|---|
major |
الإصدارات الرئيسية: تغييرات كبيرة في المنهجية (مثل إضافة مصادر بيانات جديدة إلى النموذج تؤدي إلى تغييرات كبيرة في النتائج). ولن تحدث هذه التغييرات إلا نادرًا، وسيتم الإعلان عنها قبل فترة طويلة. قد تتضمّن تغييرات في إصدار واجهة برمجة التطبيقات، والتي ستلتزم بإرشادات Google Cloud API |
minor |
الإصدارات الثانوية: تغييرات في النموذج، مع أنّها متّسقة في جميع إصدارات المخطط، إلا أنّها تغيّر مَعلمات النموذج أو تنفيذه. |
patch |
إصدارات التصحيح: تغييرات في التنفيذ تهدف إلى معالجة الأخطاء أو عدم الدقة في تنفيذ النموذج. |
dated |
الإصدارات المؤرَّخة: تتم إعادة إنشاء مجموعات بيانات النماذج باستخدام بيانات الإدخال التي تمّت إعادة تحميلها، ولكن لا يتمّ إجراء أي تغيير على الخوارزميات بانتظام. |
Scope3FlightEmissions
رحلة جوية ضمن النطاق 3 مع تقديرات الانبعاثات
| الحقول | |
|---|---|
flight |
المعرّف. تطابق هذه السمة معرّفات الرحلات الجوية في الطلب. |
wtw_emissions_grams_per_pax |
اختياريّ. إجمالي انبعاثات الرحلة الجوية (مجموع الانبعاثات من المصدر إلى الخزان ومن الخزان إلى العادم) لكل مسافر استنادًا إلى المعلومات المطلوبة. هذا هو إجمالي الانبعاثات، وما لم يكن لديك أسباب محددة لاستخدام انبعاثات "من الخزان إلى العادم" أو "من المصدر إلى الخزان"، عليك استخدام هذا الرقم. |
ttw_emissions_grams_per_pax |
اختياريّ. انبعاثات الرحلة الجوية من الوقود إلى العجلات لكل مسافر استنادًا إلى المعلومات المطلوبة |
wtt_emissions_grams_per_pax |
اختياريّ. انبعاثات الرحلة الجوية من المصدر إلى الخزان لكل مسافر استنادًا إلى المعلومات المطلوبة |
source |
اختياريّ. مصدر بيانات الانبعاثات |
Scope3DataType
نوع المطابقة المُستخدَم لاحتساب انبعاثات النطاق 3 يُستخدَم هذا الحقل في استجابة النطاق 3 لتحديد الطريقة المستخدَمة لاحتساب الانبعاثات.
| عمليات التعداد | |
|---|---|
SCOPE3_DATA_TYPE_UNSPECIFIED |
نوع البيانات غير محدَّد. |
TIM_EMISSIONS |
الانبعاثات المستندة إلى TIM مع تحديد نقطة الانطلاق والوجهة وشركة النقل ورقم الرحلة الجوية وتاريخ المغادرة والسنة |
TYPICAL_FLIGHT_EMISSIONS |
مستوى الانبعاثات العادي للرحلات الجوية حسب نقطة الانطلاق والوجهة والسنة |
DISTANCE_BASED_EMISSIONS |
الانبعاثات المستندة إلى المسافة استنادًا إلى المسافة المقطوعة والسنة |
Scope3FlightSegment
مَعلمات الرحلة الجوية التي يتم من خلالها جلب انبعاثات النطاق 3
| الحقول | |
|---|---|
departure_date |
الحقل مطلوب. تمثّل هذه السمة تاريخ الرحلة الجوية في المنطقة الزمنية لمطار نقطة الانطلاق. يجب تحديد العام فقط لنماذج احتساب مستوى الانبعاثات العادي للرحلات الجوية ونماذج احتساب مستوى الانبعاثات استنادًا إلى المسافة (يتم تجاهل قيم الشهر واليوم، وبالتالي يمكن إغفالها أو ضبطها على 0 أو ضبطها على تاريخ صالح في هذه الحالات). وبناءً على ذلك، إذا لم يتم تقديم تاريخ محدّد لانبعاثات TIM، سنعود إلى الانبعاثات النموذجية للرحلة الجوية (أو الانبعاثات المستندة إلى المسافة). |
cabin_class |
الحقل مطلوب. تمثّل هذه السمة درجة السفر على متن الرحلة الجوية. |
origin |
اختياريّ. رمز مطار الاتحاد الدولي للنقل الجوي المكوّن من 3 أحرف لمطار نقطة انطلاق الرحلة، مثل |
destination |
اختياريّ. رمز مطار الاتحاد الدولي للنقل الجوي المكوّن من 3 أحرف لوجهة الرحلة الجوية، مثل |
carrier_code |
اختياريّ. رمز شركة النقل التابع للاتحاد الدولي للنقل الجوي (IATA) والمؤلف من حرفَين، مثل |
flight_number |
اختياريّ. رقم الرحلة الجوية المكوّن من 4 أرقام كحد أقصى، مثلاً |
distance_km |
اختياريّ. المسافة بالكيلومترات، مثلاً |
CabinClass
تمثّل هذه السمة درجة السفر على متن الرحلة الجوية.
| عمليات التعداد | |
|---|---|
CABIN_CLASS_UNSPECIFIED |
درجة سفر غير محدّدة |
ECONOMY |
الدرجة الاقتصادية |
PREMIUM_ECONOMY |
الدرجة الاقتصادية المميزة |
BUSINESS |
درجة رجال الأعمال |
FIRST |
الدرجة الأولى |
المصدر
مصدر بيانات الانبعاثات
| عمليات التعداد | |
|---|---|
SOURCE_UNSPECIFIED |
لم يتم تحديد مصدر بيانات الانبعاثات. |
TIM |
تستند بيانات الانبعاثات إلى "نموذج تأثير السفر". |
EASA |
تستند بيانات الانبعاثات إلى التصنيفات البيئية الصادرة عن وكالة سلامة الطيران الأوروبية. |
TypicalFlightEmissions
تقديرات مستوى الانبعاثات العادي للرحلات الجوية في سوق معيّن
| الحقول | |
|---|---|
market |
المعرّف. تطابق هذه السمة معرّفات الرحلات الجوية في الطلب. ملاحظة: جميع رموز الاتحاد الدولي للنقل الجوي مكتوبة بأحرف كبيرة. |
emissions_grams_per_pax |
اختياريّ. مستوى الانبعاثات العادي في الرحلات الجوية لكل راكب في السوق المطلوب لن تظهر هذه السمة إذا تعذّر احتساب الانبعاثات النموذجية. للاطّلاع على قائمة بأسباب عدم إمكانية احتساب الانبعاثات النموذجية للرحلة الجوية، يُرجى الانتقال إلى GitHub. |