عمليات تحديد المصدر

تمثّل هذه السمة أجزاء مسارات التكثّف المنسوبة لقائمة محدّدة من الرحلات الجوية.

تنسيق البيانات

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

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

object (Attribution)

قائمة بمصادر البيانات، مصدر واحد لكل اسم مورد محدّد في BatchGetAttributionsRequest.names. سيتطابق ترتيب الإحالات في هذه القائمة مع ترتيب الأسماء في BatchGetAttributionsRequest. إذا لم يتم العثور على رحلة جوية، ستتم تعبئة الحقل name فقط في رسالة الإسناد المقابلة في الردّ، بينما سيظل الحقلان flightDetails وcontrail فارغَين.

تحديد المصدر

تمثّل حدثًا مجمّعًا لمسار التكثيف لرحلة جوية معيّنة تلخّص جميع أجزاء مسار التكثيف المنسوبة (مثل إجمالي الكيلومترات والطاقة).

تمثيل JSON 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ],
  "visualizationUrl": string
}
الحقول
name

string

المعرّف. اسم مورد الرحلة الجوية

التنسيق:

carriers/{carrier}/flightNumbers/{flightNumber}/departureDates/{departure_date}/departureAirports/{departure_airport}

المكوّنات:

  • ‫{carrier}: رمز شركة النقل الجوي المكوّن من حرفَين وفقًا لاتحاد النقل الجوي الدولي (IATA) (مثلاً: "AA" و"UA").
  • ‫{flightNumber}: رقم الرحلة الجوية المكوّن من رقم واحد إلى 4 أرقام (مثلاً، "123")
  • {departure_date}: تاريخ مغادرة الرحلة الجوية وفقًا للتوقيت المحلي لمطار المغادرة بتنسيق YYYY-MM-DD (متاح اعتبارًا من عام 2024 فصاعدًا).
  • ‫{departure_airport}: رمز المطار المكوّن من 3 أحرف وفقًا للاتحاد الدولي للنقل الجوي (IATA) (مثلاً: "JFK" و"LHR").
flightDetails

object (FlightDetails)

المعلومات التفصيلية لهذه الرحلة الجوية
contrail

object (ContrailAttributes)

سمات مسارات التكاثف المجمّعة للرحلة الجوية بأكملها يجمع هذا المقياس سمات مسارات التكاثف من جميع الأجزاء المنسوبة.

تفسير الحالة (ضمن رحلة جوية تم العثور عليها):

  • في حال توفّرها: تم إجراء تحليل لمسارات التكثّف. تشير الحقول داخل ContrailAttributes إلى النتائج (على سبيل المثال، يشير lengthMeters > 0 إلى أنّه تم تحديد مسارات التكاثف). إذا ظهرت رسالة ContrailAttributes فارغة، يعني ذلك أنّه تم إجراء التحليل ولكن تم تقييم كل من lengthMeters وتأثير الطاقة على أنّهما صفر.
  • في حال عدم توفّرها: لا يمكن إجراء تحليل لمسارات التكثّف لهذه الرحلة.
    • ويحدث ذلك عادةً بسبب عدم كفاية بيانات الإدخال (مثل عدم توفّر بيانات الطقس أو عدم اليقين بشأن مسار الرحلة).
    • هذا لا يعني أنّه لم يتم تشكيل أي مسارات تكثُّف، بل يعني فقط أنّه تعذّر تحديد ذلك.
segments[]

object (SegmentAttribution)

Per-segment contrail attributions. يمثّل كل إدخال فترة زمنية مختلفة للرحلة التي تم تحديد مسارات التكاثف فيها.
visualizationUrl

string

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

لا تتم تعبئة هذا الحقل إلا للرحلات الجوية التي تم العثور عليها عند استخدام طريقة العرض ATTRIBUTION_VIEW_OBSERVATION.

FlightDetails

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

تمثيل JSON 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": integer
}
الحقول
carrier

string

رمز شركة النقل الجوي التابعة لاتحاد النقل الجوي الدولي (IATA) للرحلة الجوية (مثل "AA")
flightNumber

integer

رقم الرحلة الجوية (مثلاً "123")
departureTime

string

تاريخ المغادرة حسب المنطقة الزمنية لمطار المغادرة بتنسيق YYYYMMDD
icao24

string

عنوان الطائرة المكوّن من 24 بت وفقًا لمنظمة الطيران المدني الدولي (ICAO)
originAirport

string

رمز مطار المغادرة وفقًا لاتحاد النقل الجوي الدولي (IATA)
destinationAirport

string

رمز الاتحاد الدولي للنقل الجوي لمطار الوجهة
callSign

string

إشارة النداء الخاصة بالطائرة يحتوي هذا الحقل بشكل تفضيلي على رمز النداء المستخدَم في اتصالات مراقبة الحركة الجوية (ATC). إذا لم يكن رمز النداء المحدّد لخدمات مراقبة الحركة الجوية متاحًا أو كان مطابقًا لرمز الرحلة الجوية العادي، يحتوي هذا الحقل على رمز الرحلة الجوية العادي (عادةً ما يكون مزيجًا من رمز شركة الطيران ورقم الرحلة الجوية للرحلات التجارية).
analyzedFlightDistanceMeters

integer

مسافة الرحلة التي تم تحليلها، بالأمتار

ContrailAttributes

تمثّل سمات مسارات التكثّف لرحلة جوية أو جزء من رحلة جوية.

تمثيل JSON 
{
  "lengthMeters": integer,
  "effectiveEnergyForcingJoules": string
}
الحقول
lengthMeters

integer

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

string (int64 format)

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

SegmentAttribution

تمثّل هذه السمة نسبة مساهمة مسارات التكاثف في جزء زمني معيّن من الرحلة الجوية.

تمثيل JSON 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}
الحقول
startTime

string (Timestamp format)

وقت بدء جزء الرحلة الذي تُنسب إليه مسارات التكثّف يكون هذا الطابع الزمني بالثواني حسب التوقيت العالمي المنسَّق (UTC).
endTime

string (Timestamp format)

وقت انتهاء جزء الرحلة الذي يُنسب إليه مسار التكثّف يكون هذا الطابع الزمني بالثواني حسب التوقيت العالمي المنسَّق (UTC).
contrail

object (ContrailAttributes)

سمات مسارات التكاثف لهذه الشريحة المحدّدة
detectionEvidences[]

object (ContrailDetectionEvidence)

عمليات رصد فردية لمسارات التكثّف عبر الأقمار الصناعية تقدّم دليلاً على نسبها إلى هذا الجزء من الرحلة
attributionMethod

enum (AttributionMethod)

النتائج فقط. الطريقة المستخدَمة لتحديد مصدر مسارات التكثّف في هذا الجزء (مثل نموذج CoCiP أو الملاحظة المباشرة)
longGapInterpolation

boolean

النتائج فقط. تكون القيمة "صحيح" إذا تم إنشاء مسار رحلة الشريحة من خلال الاستكمال على فجوة طويلة في بيانات ADS-B (أكثر من 5 دقائق).
waypointAttributions[]

object (WaypointAttribution)

النتائج فقط. سمات مسارات التكاثف لكل نقطة على المسار تم ربطها على مستوى هذا الجزء.

ContrailDetectionEvidence

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

تمثيل JSON 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
الحقول
observationTime

string (Timestamp format)

الوقت الذي تم فيه التقاط صورة القمر الصناعي التي تم رصد مسار التكثّف فيها ويكون هذا عادةً وقت بدء الفحص. يكون هذا الطابع الزمني بالثواني حسب التوقيت العالمي المنسَّق (UTC).
observedLengthMeters

integer

الطول المرصود من البداية إلى النهاية لمسار التكاثف الخطي بالأمتار، كما تم رصده في صورة القمر الصناعي المحدّدة بواسطة observationTime. يمكن أن يختلف هذا الطول عن lengthMeters في SegmentAttribution.contrail للأسباب التالية:

  • قد يكون مسار التكثّف قد تطوّر (مثل انتشاره أو تمدّده وما إلى ذلك) في الغلاف الجوي بين وقت تشكّله ووقت رصده.
  • لم تتمكّن خوارزمية تحديد المصدر من تحديد مصدر جزء من مسار التكاثف هذا بدقة على أنّه هذه الرحلة الجوية.
dataSource

enum (DataSource)

النتائج فقط. مصدر بيانات القمر الصناعي المستخدَمة في عملية الرصد هذه

DataSource

مصدر بيانات الأقمار الصناعية المستخدَمة لرصد مسارات التكثّف قد تتم إضافة قيم أخرى في المستقبل.

من بين مخرجات بيانات الأقمار الصناعية المتاحة، تتميز عمليات تحديد المصدر المستندة إلى GOES East وHimawari بجودة على مستوى الإنتاج، في حين أنّ عمليات تحديد المصدر المستندة إلى MTG لا تزال في المرحلة التجريبية وتخضع حاليًا لتحسينات في الجودة.

عمليات التعداد
DATA_SOURCE_UNSPECIFIED مصدر البيانات غير محدّد.
GOES_EAST_FULL_DISK بيانات من عمليات فحص القرص الكامل للقمر الصناعي GOES-East
GOES_WEST_FULL_DISK بيانات من عمليات المسح الكامل للقرص في GOES-West
MTG_000_FULL_DISK بيانات من عمليات فحص القرص الكامل MTG-000.
HIMAWARI_FULL_DISK بيانات من عمليات فحص القرص الكامل في Himawari

تستند صور القمر الصناعي في Contrails API إلى ما يلي:

WaypointAttribution

تمثّل سمات مسارات التكثيف لنقطة معيّنة على المسار في جزء من الرحلة الجوية.

تمثيل JSON 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
الحقول
time

string (Timestamp format)

الوقت عند النقطة على المسار بالثواني حسب التوقيت العالمي المنسّق (UTC).
contrailAttributes

object (ContrailAttributes)

سمات مسارات التكاثف التي تم ربطها بهذه النقطة المحدّدة على المسار

AttributionMethod

يحدّد الإجراء أو المنهجية المحدّدة المستخدَمة لتحديد المصدر.

عمليات التعداد
ATTRIBUTION_METHOD_OBSERVATION يتم تحديد المصدر بدقة من خلال المطابقة مع عمليات رصد مسارات التكاثف عبر الأقمار الصناعية.
ATTRIBUTION_METHOD_COCIP تعتمد عمليات تحديد المصدر بشكل صارم على نموذج CoCiP المستند إلى الفيزياء.
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

تحديد المصدر المختلط الذي يجمع بين توقّعات نموذج CoCiP المعدَّلة من خلال عمليات الرصد عبر الأقمار الصناعية

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

ملاحظات

يستخدم كل DataSource حدودًا مختلفة لمعالجة المشاهدات المستندة إلى الملاحظة:

مربّعات الإحاطة لتغطية القمر الصناعي (عرض مركاتور المسطّح)

الترخيص

إنّ البيانات التي تعرضها واجهة ContrailWatch Attributions API مرخَّصة بموجب CC BY-NC 4.0.