সনাক্তকরণ মাস্ক পুনরুদ্ধার করুন

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)
    স্থানাঙ্ক
    নাম মাত্রা ডেটা টাইপ মূল্যবোধ
    সময় (সময়) তারিখসময়৬৪[ns] ২০২৬-০৪-১০T০০:০০:০৭ ... ২০২৬-০৪-১০T০০:৫০:০৭
    y (y) ফ্লোট৩২ 5.569e+06 5.567e+06 ... -5.569e+06
    x (x) ফ্লোট৩২ -5.569e+06 -5.567e+06 ... 5.569e+06
    ডেটা ভেরিয়েবল
    মাস্ক (সময়, y, x) ফ্লোট৩২ ০.০ ০.০ ০.০ ০.০ ... ০.০ ...
    স্ক্যানটাইম_অফসেট (সময়, y, x) ফ্লোট৬৪ নান নান নান নান ... 564. 568। ...
    প্রক্ষেপণ () ডেটা অ্যারে +প্রক্ষেপ=ভূগোল +দ্রাঘিমাংশ_0=0 +উচ্চতা=35786400 +এক্স_0=0 +ওয়াই_0=0 +এ=6378137 +বি=6356752.3 +একক=মিটার +কোনো_সংজ্ঞা নেই

    উল্লেখ্য যে, projection একটি pyproj.Proj অবজেক্টের স্ট্রিং ফর্ম হিসাবে ফরম্যাট করা হয়।

    মানচিত্রের x, y স্থানাঙ্ক এবং দ্রাঘিমাংশ, অক্ষাংশ স্থানাঙ্কের মধ্যে রূপান্তর করতে projection ব্যবহার করা যেতে পারে।

ডিটেকশনমাস্কভিউ

ডিটেকশন মাস্কের জন্য ফেরত দেওয়া বিশদ বিবরণের স্তর নির্ধারণ করে।

এনাম
DETECTION_MASK_VIEW_UNSPECIFIED অনির্দিষ্ট ভিউ। বাস্তবে এটিকে বেসিক (BASIC) হিসেবে গণ্য করা হয়।
DETECTION_MASK_VIEW_BASIC এতে ডিটেকশন মাস্ক ভ্যালু এবং স্যাটেলাইট প্রজেকশন ডেটা রয়েছে।
DETECTION_MASK_VIEW_FULL এতে ডিটেকশন মাস্ক ভ্যালু, স্যাটেলাইট প্রজেকশন ডেটা এবং ফুল ডিস্ক স্ক্যানটাইম অফসেট অন্তর্ভুক্ত রয়েছে।