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

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

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

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

تمثيل 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)
    }
  ]
}
الحقول
name

string

المعرّف. اسم المورد الخاص برحلة الطيران

التنسيق:

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

المكوّنات:

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

object (FlightDetails)

تعرض هذه السمة المعلومات التفصيلية الخاصة بهذه الرحلة الجوية.
contrail

object (ContrailAttributes)

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

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

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

object (SegmentAttribution)

تحديد مصدر كلّ جزء من مسار الطائرة يمثّل كل إدخال فترة زمنية مميزة للرحلة الجوية التي تمّت إضافة مسارات التكاثف إليها.

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

تمثّل هذه السمة تاريخ المغادرة في المنطقة الزمنية لمطار المغادرة، ويتم عرضها كعدد صحيح (حقبة يونكس) أو سلسلة (ISO 8601).
icao24

string

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

string

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

string

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

string

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

integer

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

ContrailAttributes

تمثّل هذه السمة سمات الدخان المتكاثف لرحلة جوية أو شريحة من رحلة جوية.

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

integer

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

string (int64 format)

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

SegmentAttribution

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

تمثيل JSON 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ]
}
الحقول
startTime

string (Timestamp format)

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

string (Timestamp format)

وقت انتهاء مقطع رحلة الطيران الذي يتمّ تحديد مصدره على أنّه آثار تكثّف. هذا الطابع الزمني هو عدد ثواني حقبة التوقيت العالمي المنسَّق.
contrail

object (ContrailAttributes)

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

object (ContrailDetectionEvidence)

عمليات رصد فردية لآثار بخارية من الأقمار الصناعية تقدّم دليلًا على أنّها مرتبطة بجزء الرحلة الجوية هذا

ContrailDetectionEvidence

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

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

string (Timestamp format)

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

integer

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

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

enum (DataSource)

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

DataSource

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

تتوفّر حاليًا نواتج بيانات الأقمار الصناعية GOES East وMTG. تتوفّر بيانات تحديد المصدر المستندة إلى GOES East بجودة عالية، بينما لا تزال بيانات تحديد المصدر المستندة إلى 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.

الترخيص

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