معیارهای انتساب پسدمه را بازیابی کنید

GET https://contrails.googleapis.com/v2/attributions:GetAttributionMetrics : دریافت معیارهای انتساب پسدمه به صورت تجمیعی بر اساس محدوده‌ها، مهر زمانی و روش انتساب.

در صورت موفقیت، پاسخ یک شیء AttributionMetrics را برمی‌گرداند که شامل موارد زیر است:

  • فیلد flight_attributed_length_metres که طول زیرمجموعه(هایی) از مسیرهای پروازی را در محدوده‌های مشخص‌شده‌ای که ردپاها به آنها نسبت داده شده‌اند، بر حسب متر نشان می‌دهد.
  • یک فیلد effective_energy_forcing_joules که نشان دهنده effective energy forcing، بر حسب ژول، برای تمام پسدمه‌ها در مرز مشخص شده است. effective energy forcing با استخراج effective radiation forcing از خروجی‌های پیش‌بینی 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 بیشتر باشد.

قالب: رشته تاریخ و زمان ISO 8601

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

attributionMethod

enum ( AttributionMethod )

الزامی. روشی که برای نسبت دادن ردپاها به بخش‌های پروازی استفاده می‌شود.

قالب: باید یا ATTRIBUTION_METHOD_OBSERVATION ، ATTRIBUTION_METHOD_COCIP یا ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP باشد.