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

GET https://contrails.googleapis.com/v2/detections : GeoJSON LineString ফরম্যাটে কনট্রেইল ডিটেকশনগুলো সংগ্রহ করুন।

সফল হলে, প্রতিক্রিয়াটি GeoJSON ফরম্যাটে একটি FeatureCollection হবে। উল্লেখ্য যে, সময়সীমাটি আওতার বাইরে হলে (যেমন ভবিষ্যতে শনাক্তকৃত কনট্রেইল খোঁজার ক্ষেত্রে) একটি খালি FeatureCollection ফেরত আসতে পারে। এছাড়াও, ডিটেকশন মডেলগুলো আপডেট হওয়ার এবং ডেটা ব্যাকফিল হওয়ার কারণে ডিটেকশনগুলো সামঞ্জস্যপূর্ণ হবে এমন কোনো নিশ্চয়তা নেই।

কোয়েরি প্যারামিটার

প্যারামিটার
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_origins[]

string

ঐচ্ছিক। বৈধ মানগুলি হলো GOES-EAST-FULL-DISK , HIMAWARI-FULL-DISK এবং MTG-000-FULL-DISK , যা যথাক্রমে GOES_EAST, Himawari এবং MTG স্যাটেলাইটগুলিকে প্রতিনিধিত্ব করে।

সরবরাহ করা হলে, এই এন্ডপয়েন্টটি শুধুমাত্র satellite_origins মধ্যে নির্দিষ্ট করা স্যাটেলাইটগুলো থেকে শনাক্তকৃত কনট্রেইল ফেরত দেবে।

সরবরাহ করা না হলে, প্রযোজ্য সকল স্যাটেলাইট ডেটা সরবরাহকারীর কাছ থেকে শনাক্তকৃত কনট্রেইল ফেরত পাঠানো হয়।

ফর্ম্যাট: স্ট্রিং অ্যারে

উদাহরণ: ["GOES-EAST-FULL-DISK", "HIMAWARI-FULL-DISK"]

উদাহরণ

  • একটি নির্দিষ্ট সময়ে সমস্ত কনট্রেইল ডিটেকশন পুনরুদ্ধার করতে:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/detections",
  params={"start_time": "2026-01-27T12:00:00Z",
          "end_time": "2026-01-27T12:10:00Z"},
  headers={"x-goog-api-key": API_KEY},
)

  • একটি নির্দিষ্ট সময়ের জন্য কনট্রেইল ডিটেকশন পুনরুদ্ধার করতে, যা শুধুমাত্র হিমাওয়ারি ডিটেকশনের মধ্যে সীমাবদ্ধ:

    response = requests.get(
  url="https://contrails.googleapis.com/v2/detections",
  params={"start_time": "2026-01-27T12:00:00Z",
          "end_time": "2026-01-27T12:10:00Z",
          "satellite_origins": ["HIMAWARI-FULL-DISK"]}
  headers={"x-goog-api-key": API_KEY},
)

    অথবা CURL-এ:

    curl "https://contrails.sandbox.googleapis.com/v2/detections?\
key=API_KEY&\
start_time=2026-01-27T12:00:00Z&\
end_time=2026-01-27T12:10:00Z&\
satellite_origins=HIMAWARI-FULL-DISK"

শনাক্তকৃত কনট্রেইলসহ একটি সফল প্রতিক্রিয়া দেখতে অনেকটা এইরকম হবে:

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            90.06765747070312,
            44.201324462890625
          ],
          [
            90.99974060058594,
            43.65225601196289
          ]
        ]
      },
      "properties": {
        "time": "2026-03-10T00:00:00+00:00",
        "satellite_origin": "HIMAWARI-FULL-DISK"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            105.36386108398438,
            -1.7198446989059448
          ],
          [
            105.7318115234375,
            -2.5787696838378906
          ]
        ]
      },
      "properties": {
        "time": "2026-03-10T00:00:00+00:00",
        "satellite_origin": "HIMAWARI-FULL-DISK"
      }
    }
  ]
}