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

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

সফল হলে, প্রতিক্রিয়াটি GeoJSON ফরম্যাটে একটি FeatureCollection হবে।

প্রত্যাবর্তিত স্থানাঙ্কগুলি হলো রৈখিক শনাক্তকরণের প্রান্তবিন্দুগুলির দ্রাঘিমাংশ এবং অক্ষাংশ, যা উপগ্রহের দৃষ্টিকোণ থেকে পৃথিবীর পৃষ্ঠে প্রক্ষেপিত হয়। GOES শনাক্তকরণের ক্ষেত্রে, প্রত্যাবর্তিত স্থানাঙ্কগুলিতে ঐচ্ছিকভাবে আনুমানিক উচ্চতার মানও অন্তর্ভুক্ত থাকে।

আওতার বাইরে থাকা কোনো সময়সীমা, যেমন ভবিষ্যতের কোনো নির্দিষ্ট সময়, দিয়ে ডিটেকশন কোয়েরি করলে একটি খালি 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"]

bounds[]

string

ঐচ্ছিক। স্ট্রিং জোড়ের একটি তালিকা, যার প্রতিটি অবশ্যই "অক্ষাংশ, দ্রাঘিমাংশ" বিন্যাসে থাকতে হবে এবং যা একটি পরিবেষ্টনকারী বহুভুজের শীর্ষবিন্দুগুলো নির্দিষ্ট করবে।

যদি থাকে, তবে কমপক্ষে তিনটি bounds নির্দিষ্ট করতে হবে। সীমানাগুলো অবশ্যই একটি বৈধ বহুভুজ গঠন করবে (যেমন, কোনো সদৃশ শীর্ষবিন্দু থাকবে না, কোনো স্ব-ছেদ থাকবে না)।

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

উপস্থিত না থাকলে, অবস্থান নির্বিশেষে শনাক্তকৃত কনট্রেইল ফেরত আসে।

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

উদাহরণ: ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]

উদাহরণ

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

    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",
          "bounds": ["37.7,-122.41", "37.78,-122.42", "37.79, -122.43"]},
  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.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"

    এই অনুরোধের GeoJSON প্রতিক্রিয়াটি অনুরোধকৃত সময়সীমার জন্য হিমাওয়ারি উপগ্রহ থেকে প্রাপ্ত কনট্রেইল সনাক্তকরণের ডেটা তালিকাভুক্ত করে:

    {
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            90.06765747070312,
            44.201324462890625
          ],
          [
            90.99974060058594,
            43.65225601196289
          ]
        ]
      },
      "properties": {
        "time": "2026-01-27T12: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-01-27T12:10:00+00:00",
        "satellite_origin": "HIMAWARI-FULL-DISK"
      }
    }
  ]
}