אחזור מדדי שיוך של שובל התעבות

GET https://contrails.googleapis.com/v2/attributions:GetAttributionMetrics: קבלת מדדי שיוך מצטברים של שובל התעבות לפי גבולות, חותמת זמן ושיטת שיוך.

אם הפעולה בוצעה ללא שגיאות, התגובה תחזיר אובייקט AttributionMetrics שמכיל:

  • שדה flight_attributed_length_metres שמייצג את האורך, במטרים, של קבוצות המשנה של נתיבי הטיסה בגבולות שצוינו, שיוחסו להם עקבות התעבות.
  • שדה effective_energy_forcing_joules שמייצג את האילוץ האפקטיבי של האנרגיה, בג'ול, של כל שובלי ההתעבות בתוך הגבול שצוין. הערך של Effective Energy Forcing מחושב על ידי חילוץ של Effective Radiative 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 לא יכול להיות גדול מ-14 ימים.

פורמט: מחרוזת של תאריך ושעה בפורמט ISO 8601

לדוגמה: 2026-01-12T21:00:00Z

attributionMethod

enum (AttributionMethod)

חובה. השיטה שבה משתמשים לשיוך של פסי התעבות לקטעי טיסה.

פורמט: הערך צריך להיות ATTRIBUTION_METHOD_OBSERVATION, ‏ATTRIBUTION_METHOD_COCIP או ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP.