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

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

अनुरोध पूरा होने पर, जवाब GeoJSON फ़ॉर्मैट में FeatureCollection होगा.

दिए गए निर्देशांक, सैटलाइट के नज़रिए से धरती की सतह पर प्रोजेक्ट किए गए, लाइन में लगे ऑब्जेक्ट के दोनों सिरों के देशांतर और अक्षांश होते हैं. GOES से पता लगाई गई चीज़ों के लिए, लौटाए गए कोऑर्डिनेट में अनुमानित ऊंचाई की वैल्यू भी शामिल हो सकती हैं.

अगर समयसीमा से बाहर की किसी अवधि के लिए, गड़बड़ियों का पता लगाने से जुड़ी क्वेरी की जाती है, तो खाली 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"]
bounds[]

string

ज़रूरी नहीं. स्ट्रिंग पेयर की सूची. इनमें से हर एक "latitude,longitude" फ़ॉर्मैट में होना चाहिए. इससे बाउंडिंग पॉलीगॉन के वर्टेक्स तय होते हैं.

अगर यह मौजूद है, तो कम से कम तीन 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},
)

  • किसी खास समयावधि के लिए, कॉन्ट्रेल का पता लगाने की जानकारी पाने के लिए. यह जानकारी सिर्फ़ 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.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 जवाब में, अनुरोध की गई समयावधि के लिए, Himawari सैटलाइट से मिले कॉन्ट्रेल डिटेक्शन का डेटा दिया गया है:

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