डिटेक्शन वापस पाना

GET https://contrails.googleapis.com/v2/detections: Get contrail detections in GeoJSON LineString format.

अनुरोध पूरा होने पर, जवाब GeoJSON फ़ॉर्मैट में FeatureCollection होगा. ध्यान दें कि अगर समयसीमा तय नहीं की गई है, तो FeatureCollection खाली दिख सकता है. उदाहरण के लिए, आने वाले समय में पता लगाए गए कॉन्ट्रेल को खोजना. इसके अलावा, यह ज़रूरी नहीं है कि पहचान करने वाले मॉडल अपडेट होने और डेटा फिर से भरने के बाद, पहचान करने की प्रोसेस एक जैसी हो.

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

पैरामीटर
start_time

string

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

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

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

end_time

string

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

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

उदाहरण: 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},
    )
    
  • किसी खास समय के लिए, कॉन्ट्रेल का पता लगाने की जानकारी पाने के लिए. यह जानकारी सिर्फ़ Himawari से पता लगाए गए कॉन्ट्रेल के लिए उपलब्ध है:

    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"
      }
    }
  ]
}