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

‫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 Ensemble, שמשתמש ב-10 תחזיות Ensemble ממזג האוויר של HRES. לא נעשה שימוש בתצפיות לווייניות. אופטימיזציה לשיפור יכולת השליפה.
ATTRIBUTION_VIEW_OBSERVATION_ENHANCED_COCIP גישה היברידית שמשלבת CoCiP ומסלולי תצפית. המודל הפיזיקלי מותאם או מוזל על סמך זיהויים תואמים של לוויינים.
ATTRIBUTION_VIEW_UNSPECIFIED תצוגת שיוך לא מוגדרת. ברירת המחדל היא ATTRIBUTION_VIEW_OBSERVATION.