Method: batchGetAttributions

يحصل على سمات متعددة لمسارات التكاثف من خلال معلومات الرحلة الجوية.

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

طلب HTTP

GET https://contrails.googleapis.com/v2/{parent=attributions}:batchGet

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

مَعلمات المسار

المعلمات
parent

string

الحقل مطلوب. تمثّل هذه السمة المرجع الرئيسي الذي تتم مشاركته من خلال جميع عمليات تحديد المصدر التي يتم استردادها. التنسيق: attributions

مَعلمات طلب البحث

المعلمات
names[]

string

الحقل مطلوب. أسماء الموارد للرحلات الجوية المطلوب استردادها. يمكن تقديم 100 اسم كحد أقصى في طلب واحد.

التنسيق:

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

المكوّنات:

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

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

استجابة تتضمّن آثار الطائرات المنسوبة إلى attributions.batchGet

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

تمثيل 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}: رقم الرحلة الجوية المكوّن من 1 إلى 4 أرقام (مثلاً "123").
  • {departure_date}: تاريخ مغادرة رحلة الطيران بالتنسيق YYYY-MM-DD
  • {departure_airport}: رمز مطار IATA المؤلف من 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

تمثّل هذه السمة تاريخ المغادرة في المنطقة الزمنية لمطار المغادرة int: unix epoch; str: 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

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

عمليات التعداد
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