אחזור מסכות זיהוי

‫GET https://contrails.googleapis.com/v2/detections/masks: קבלת מסכות לזיהוי שובלי התעבות בפורמט NetCDF4.

אם הפעולה בוצעה ללא שגיאות, התגובה תהיה NetCDF של מסכות לזיהוי שובלי התעבות. אופציונלי: אפשר לכלול בתשובה גם היסטים של זמן הסריקה.

הערה: מסכות לזיהוי תנועה ממקורות לא מזוהים נמצאות בגרסת בטא ועשויות להשתנות.

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

פרמטרים
start_time	string חובה. שעת ההתחלה של הבקשה. פורמט: מחרוזת של תאריך ושעה בפורמט ISO 8601 לדוגמה: 2026-01-20T21:00:00Z
end_time	string חובה. שעת הסיום של הבקשה (כולל). חשוב לזכור שההפרש בין end_time לבין start_time לא יכול להיות גדול משעה. פורמט: מחרוזת של תאריך ושעה בפורמט ISO 8601 לדוגמה: 2026-01-20T22:00:00Z
satellite_origin	string חובה. הערכים התקינים הם GOES-WEST-FULL-DISK,‏ GOES-EAST-FULL-DISK,‏ HIMAWARI-FULL-DISK ו-MTG-000-FULL-DISK, שמייצגים את הלוויינים GOES_WEST,‏ GOES_EAST,‏ Himawari ו-MTG, בהתאמה. פורמט: מחרוזת לדוגמה: "GOES-EAST-FULL-DISK"
view	DetectionMaskView אופציונלי. ברירת המחדל היא DETECTION_MASK_VIEW_UNSPECIFIED. אם DETECTION_MASK_VIEW_FULL, התשובה תכלול את כל ההיסטים של הלוויין בדיסק (בשניות). פורמט: לצפייה במסמכי התיעוד לדוגמה: DETECTION_MASK_VIEW_BASIC

דוגמאות

• כדי לאחזר מסכות זיהוי מלוויין לנקודת זמן ספציפית עם היסטים של זמן הסריקה:

  response = requests.get(
    url="https://contrails.googleapis.com/v2/detections/masks",
    params={"start_time": "2026-04-10T00:00:00Z",
            "end_time": "2026-04-10T01:00:00Z",
            "satellite_origin": "MTG-000-FULL-DISK"
            "view": "DETECTION_MASK_VIEW_FULL"},
    headers={"x-goog-api-key": API_KEY},
  )
  

  או ב-CURL:

  curl "https://contrails.googleapis.com/v2/detections/masks?\
  key=API_KEY&\
  start_time=2026-04-10T00:00:00Z&\
  end_time=2026-04-10T01:00:00Z&\
  satellite_origin=MTG-000-FULL-DISK&\
  view=DETECTION_MASK_VIEW_FULL"
  

  כשמעמיסים את הבקשה הזו באמצעות xarray, מקבלים את מערך הנתונים הבא:

  מאפיינים: (זמן: 6, y: 5568, x: 5568)
  קואורדינטות
  שם	מידות	סוג הנתונים	ערכים
  time	(time)	datetime64[ns]	2026-04-10T00:00:07 ... 2026-04-10T00:50:07
  y	(y)	float32	‪5.569e+06 5.567e+06 ... -5.569e+06
  x	(x)	float32	‫‎-5.569e+06 -5.567e+06 ... 5.569e+06
  משתני נתונים
  מסכה	(time, y, x)	float32	0.0 0.0 0.0 0.0 ... 0.0 ...
  scantime_offset	(time, y, x)	float64	nan nan nan nan ... 564. ‫568. ...
  היטל	()	DataArray	‪+proj=geos +lon_0=0 +h=35786400 +x_0=0 +y_0=0 +a=6378137 +b=6356752.3 +units=m +no_defs

  שימו לב שהפורמט של projection הוא מחרוזת של אובייקט pyproj.Proj.

  אפשר להשתמש ב-projection כדי להמיר בין קואורדינטות x, y במפה לבין קואורדינטות של קו אורך וקו רוחב.

DetectionMaskView

הגדרת רמת הפירוט שתוחזר למסכות הזיהוי.

טיפוסים בני מנייה (enum)
DETECTION_MASK_VIEW_UNSPECIFIED	תצוגה לא מזוהה. בפועל, המערכת מתייחסת לזה כאל BASIC.
DETECTION_MASK_VIEW_BASIC	מכיל ערכים של מסכת זיהוי ונתוני הקרנה של לוויין.
DETECTION_MASK_VIEW_FULL	מכיל ערכים של מסכת זיהוי, נתוני הקרנה של לוויין והיסטים של זמן הסריקה של הדיסק המלא.