بازیابی ماسک‌های تشخیص

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 بارگذاری شود، مجموعه داده زیر را برمی‌گرداند:

    ابعاد: (زمان: ۶، طول: ۵۵۶۸، عرض: ۵۵۶۸)
    مختصات
    نام ابعاد نوع داده ارزش‌ها
    زمان (زمان) تاریخ و زمان64[ns] ‎۲۰۲۶-۰۴-۱۰T۰۰:۰۰:۰۷ ... ‎۲۰۲۶-۰۴-۱۰T۰۰:۵۰:۰۷
    ی (ی) شناور32 5.569e+06 5.567e+06 ... -5.569e+06
    ایکس (ایکس) شناور32 -5.569e+06 -5.567e+06 ... 5.569e+06
    متغیرهای داده
    ماسک (زمان، y، x) شناور32 ۰.۰ ۰.۰ ۰.۰ ۰.۰ ۰.۰ ... ۰.۰ ...
    طرح ریزی () آرایه داده +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 نقشه به مختصات طول و عرض جغرافیایی استفاده کرد.