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

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

    ابعاد: (زمان: ۶، طول: ۵۵۶۸، عرض: ۵۵۶۸)
    مختصات
    نام ابعاد نوع داده ارزش‌ها
    زمان (زمان) تاریخ و زمان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 ۰.۰ ۰.۰ ۰.۰ ۰.۰ ۰.۰ ... ۰.۰ ...
    زمان_افست_پوینت (زمان، y، x) شناور64 نان نان نان نان ... 564. 568. ...
    طرح ریزی () آرایه داده +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 نقشه به مختصات طول و عرض جغرافیایی استفاده کرد.

نمای ماسک تشخیص

سطح جزئیاتی را که باید برای ماسک‌های تشخیص برگردانده شود، تعریف می‌کند.

انوم‌ها
DETECTION_MASK_VIEW_UNSPECIFIED نمای نامشخص. در عمل، این به عنوان BASIC در نظر گرفته می‌شود.
DETECTION_MASK_VIEW_BASIC شامل مقادیر ماسک تشخیص و داده‌های تصویر ماهواره‌ای است.
DETECTION_MASK_VIEW_FULL شامل مقادیر ماسک تشخیص، داده‌های تصویر ماهواره‌ای و آفست‌های زمان اسکن کامل دیسک است.