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

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

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

בתצוגת ברירת המחדל OBSERVATION ובפלחים מותאמים לתצפיות בתצוגה ההיברידית (OBSERVATION_ENHANCED_COCIP), שיוכים זמינים רק באזורי משנה שמכוסים על ידי GOES-East (במיוחד בארה"ב), GOES-West,‏ MTG (אירופה) ו-Himawari (אזורי משנה במזרח אסיה ובאסיה-פסיפיק). השיוכים שמבוססים על GOES-East,‏ GOES-West ו-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 (זמין החל משנת 2024. הנתונים של 2024 מסופקים על בסיס 'המאמץ הטוב ביותר' ולא מתבצעת תחזוקה שלהם, בעוד שהנתונים של 2025 ואילך מתעדכנים באופן פעיל).
  • ‫{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.