استرداد مقاييس تحديد المصدر الخاصة بالرحلات الجوية المتعارضة

GET https://contrails.googleapis.com/v2/attributions:GetAttributionMetrics: يمكنك الحصول على مقاييس تحديد مصدر التكاثف المتراكِمة حسب الحدود والطابع الزمني وطريقة تحديد المصدر.

في حال نجاح الطلب، ستعرض الاستجابة عنصر AttributionMetrics الذي يحتوي على ما يلي:

  • حقل flight_attributed_length_metres يمثّل طول مسارات الرحلات الجوية التي تم تحديد مصدر التكاثف لها، بالمتر، ضِمن الحدود المحدّدة.
  • حقل effective_energy_forcing_joules يمثّل "التأثير الفعّال للطاقة" لجميع التكاثف ضمن الحدود المحدّدة، بالجول. يتم استخلاص "التأثير الفعّال للطاقة" من خلال استخراج "التأثير الإشعاعي الفعّال" من نتائج التوقّعات المستندة إلى شبكة CoCiP، ثم إجراء عملية استيفاء خطي لها.
  • حقل rf_erf_conversion_factor يمثّل ثابت التحويل المستخدَم للحصول على "التأثير الإشعاعي الفعّال" (ERF) من "التأثير الإشعاعي" (RF).

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

المعلمات
bounds[]

string

الحقل مطلوب. قائمة بأزواج من السلاسل النصية، يجب أن يكون كل منها بتنسيق "خط العرض، خط الطول"، لتحديد رؤوس مضلّع يمثّل المنطقة الجغرافية.

يجب تحديد ثلاثة حدود على الأقل. يجب أن تشكّل الحدود مضلّع S2Polygon صالحًا (على سبيل المثال، بدون رؤوس مكرّرة أو تقاطع ذاتي). لمزيد من المعلومات عن S2Polygon، يُرجى الرجوع إلى مستندات S2Geometry.

مثلاً: ["37.7,-122.41", "37.78,-122.42", "37.79,-122.43"]

startTime

string

الحقل مطلوب. وقت بدء عمليات رصد التكاثف التي تم تحديد مصدرها والمطلوبة.

التنسيق: سلسلة نصية بالتاريخ والوقت بتنسيق ISO 8601

مثلاً: 2026-01-20T21:00:00Z

endTime

string

الحقل مطلوب. وقت انتهاء عمليات رصد التكاثف التي تم تحديد مصدرها والمطلوبة (يشمل هذا الوقت).

يُرجى العِلم أنّه لا يمكن أن يتجاوز endTime قيمة startTime بأكثر من 14 يومًا.

التنسيق: سلسلة نصية بالتاريخ والوقت بتنسيق ISO 8601

مثلاً: 2026-01-12T21:00:00Z

view

enum (AttributionView)

الحقل مطلوب. العرض المستخدَم لتحديد مصدر التكاثف في أجزاء الرحلات الجوية.

التنسيق: يجب أن تكون القيمة ATTRIBUTION_VIEW_OBSERVATION أو ATTRIBUTION_VIEW_COCIP أو ATTRIBUTION_VIEW_OBSERVATION_ENHANCED_COCIP.