אחזור של כמה שיוכים של שובלי התעבות

‫GET https://contrails.googleapis.com/v2/{parent=attributions}:batchGet: קבלת כמה שיוכים של שובלי התעבות לפי פרטי טיסה.

אם הפעולה בוצעה ללא שגיאות, התגובה תהיה רשימה של שיוכים של שובלי התעבות.

בתצוגת ברירת המחדל OBSERVATION ובפלחים מותאמים לתצפיות בתצוגה ההיברידית (OBSERVATION_ENHANCED_COCIP), השיוכים זמינים רק באזורי משנה שמכוסים על ידי GOES-East (בארה"ב), MTG (באירופה) ו-Himawari (באזורי משנה במזרח אסיה ובאזור אסיה-פסיפיק). השיוכים שמבוססים על GOES-East ועל Himawari הם באיכות של רמת ייצור, ואילו MTG נמצא בגרסת בטא. מחוץ לאזורי הכיסוי המוגדרים האלה או במהלך פערים ארוכים בנתוני המקור (>5 דקות), חישובי ההשפעה של הטיסה מבוססים על מודלים פיזיקליים (COCIP)

פרמטרים של נתיב

פרמטרים
parent

string

חובה. משאב האב שמשותף לכל השיוכים שאוחזרו. פורמט: attributions

פרמטרים של שאילתה

פרמטרים
names[]

string

חובה. שמות המשאבים של הטיסות לאחזור. אפשר לציין עד 100 שמות בבקשה אחת.

פורמט:

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

רכיבים:

  • ‫{carrier}: קוד IATA של חברת התעופה באורך 2 תווים (למשל "AA",‏ "UA").
  • ‫{flightNumber}: מספר טיסה בן 1-4 ספרות (לדוגמה, "123").
  • ‫{departure_date}: תאריך ההמראה בפורמט YYYY-MM-DD.
  • ‫{departure_airport}: קוד שדה תעופה IATA בן 3 אותיות (לדוגמה, "JFK", "LHR").
view

enum (AttributionView)

אופציונלי. המתודולוגיה שנבחרה לחישוב ההשפעה של הטיסה. ברירת המחדל היא ATTRIBUTION_VIEW_OBSERVATION.

AttributionView

ההגדרה הזו מגדירה את המתודולוגיה המבוקשת לחישוב ההשפעה של הטיסה.

טיפוסים בני מנייה (enum)
ATTRIBUTION_VIEW_OBSERVATION ההשפעה של המאפיינים מבוססת רק על זיהויים תואמים של שובלי מטוסים. לפלחים ללא תצפית תואמת לא תהיה השפעה. המטרה היא להשיג דיוק גבוה.
ATTRIBUTION_VIEW_COCIP ההשפעה של המאפיינים מבוססת רק על תחזיות של קבוצת מודלים של CoCiP, באמצעות 10 קבוצות מנתוני מזג האוויר של HRES. לא נעשה שימוש בתצפיות לווייניות. אופטימיזציה לשיפור יכולת הזכירה.
ATTRIBUTION_VIEW_OBSERVATION_ENHANCED_COCIP גישה היברידית שמשלבת בין CoCiP לבין נתוני מעקב. המודל הפיזיקלי מתרחב או מצטמצם בהתאם לזיהויים תואמים של לוויינים.
ATTRIBUTION_VIEW_UNSPECIFIED תצוגת שיוך לא מוגדרת. ברירת המחדל היא ATTRIBUTION_VIEW_OBSERVATION.