पहचान करने वाले मास्क वापस पाना

GET https://contrails.googleapis.com/v2/detections/masks: NetCDF4 फ़ॉर्मैट में कॉन्ट्रेल का पता लगाने वाले मास्क पाएं.

अगर अनुरोध पूरा हो जाता है, तो जवाब में कॉन्ट्रेल का पता लगाने वाले मास्क का NetCDF होगा. इसके अलावा, स्कैनटाइम ऑफ़सेट को भी जवाब में शामिल किया जा सकता है.

क्वेरी पैरामीटर

पैरामीटर
start_time

string

ज़रूरी है. अनुरोध शुरू होने का समय.

फ़ॉर्मैट: ISO 8601 datetime स्ट्रिंग

उदाहरण: 2026-01-20T21:00:00Z

end_time

string

ज़रूरी है. अनुरोध पूरा होने का समय (शामिल है). ध्यान दें कि end_time, start_time से एक घंटे से ज़्यादा नहीं हो सकता.

फ़ॉर्मैट: ISO 8601 datetime स्ट्रिंग

उदाहरण: 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

उदाहरण

  • किसी खास समय के लिए, सैटलाइट से डिटेक्शन मास्क पाने के लिए, scantime ऑफ़सेट का इस्तेमाल करें:

    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 के साथ लोड करने पर, यह अनुरोध नीचे दिया गया डेटासेट दिखाता है:

    डाइमेंशन: (time: 6, y: 5568, x: 5568)
    निर्देशांक
    नाम आयाम डेटा टाइप वैल्यू
    समय (समय) 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

इससे, पहचान करने वाले मास्क के लिए जानकारी का लेवल तय होता है.

Enums
DETECTION_MASK_VIEW_UNSPECIFIED व्यू के बारे में कोई जानकारी नहीं दी गई है. हालांकि, इसे बुनियादी सुविधा के तौर पर माना जाता है.
DETECTION_MASK_VIEW_BASIC इसमें डिटेक्शन मास्क की वैल्यू और सैटलाइट प्रोजेक्शन का डेटा होता है.
DETECTION_MASK_VIEW_FULL इसमें डिटेक्शन मास्क वैल्यू, सैटलाइट प्रोजेक्शन डेटा, और फ़ुल डिस्क स्कैनटाइम ऑफ़सेट शामिल होते हैं.