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

‫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-EAST-FULL-DISK,‏ HIMAWARI-FULL-DISK ו-MTG-000-FULL-DISK, שמייצגים את הלוויינים GOES_EAST,‏ Himawari ו-MTG, בהתאמה.

פורמט: מחרוזת

לדוגמה: "GOES-EAST-FULL-DISK"

דוגמאות

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

    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"},
  headers={"x-goog-api-key": API_KEY},
)

    או ב-CURL:

    curl "https://contrails.sandbox.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"

    כשמעמיסים את הבקשה הזו באמצעות 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 ...
    היטל () 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 של מפה לבין קואורדינטות של קו אורך וקו רוחב.