Method: batchGetAttributions

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

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

طلب HTTP

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

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

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

المعلمات
parent

string

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

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

المعلمات
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}: رمز مطار الاتحاد الدولي للنقل الجوي المؤلف من 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)
  }
}
الحقول
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}: رمز مطار الاتحاد الدولي للنقل الجوي المؤلف من 3 أحرف (مثلاً "JFK", "LHR").
flightDetails

object (FlightDetails)

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

object (ContrailAttributes)

تفاصيل حول خطوط التكاثف المنسوبة إلى الرحلة الجوية

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

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

FlightDetails

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

تمثيل JSON 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": string
}
الحقول
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

الاسم اللاسلكي للطائرة المرتبطة بنقطة الطريق
analyzedFlightDistanceMeters

string (int64 format)

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

ContrailAttributes

تمثّل هذه السمة سمات مسار التكاثف لرحلة جوية.

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

string (int64 format)

الطول المقدَّر لتكوّن أثر الطائرة، بالمتر
effectiveEnergyForcingJoules

string (int64 format)

إجمالي قوة الطاقة الفعّالة الناتجة عن هذه الرحلة الجوية، بوحدة الجول