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

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

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

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

अगर तय की गई समयसीमा से बाहर के समय के लिए, कॉन्ट्रेल का पता लगाने की जानकारी के लिए क्वेरी की जाती है, तो जवाब में खाली FeatureCollection मिलता है. जैसे, अगर आने वाले समय के लिए क्वेरी की जाती है.

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

पैरामीटर
start_time

string

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

फ़ॉर्मैट: ISO 8601 datetime string

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

string

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

फ़ॉर्मैट: ISO 8601 datetime string

उदाहरण: 2026-01-20T22:00:00Z
satellite_origins[]

string

ज़रूरी नहीं. मान्य वैल्यू GOES-WEST-FULL-DISK, GOES-EAST-FULL-DISK, HIMAWARI-FULL-DISK, और MTG-000-FULL-DISK हैं. ये वैल्यू, क्रमशः GOES_EAST, Himawari, और MTG सैटलाइट को दिखाती हैं.

अगर यह पैरामीटर मौजूद है, तो यह एंडपॉइंट, satellite_origins में तय की गई सैटलाइट से पता लगाए गए कॉन्ट्रेल की जानकारी सिर्फ़ तब दिखाएगा.

अगर यह पैरामीटर मौजूद नहीं है, तो यह एंडपॉइंट, सभी मान्य सैटलाइट डेटा देने वाली कंपनियों से पता लगाए गए कॉन्ट्रेल की जानकारी दिखाएगा.

फ़ॉर्मैट: string array

उदाहरण: ["GOES-EAST-FULL-DISK", "HIMAWARI-FULL-DISK"]
bounds[]

string

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

अगर यह पैरामीटर मौजूद है, तो कम से कम तीन bounds तय किए जाने चाहिए. बाउंडिंग पॉलीगॉन, मान्य होना चाहिए. जैसे, इसमें डुप्लीकेट वर्टिकल नहीं होने चाहिए और यह एक-दूसरे को नहीं काटना चाहिए

अगर यह पैरामीटर मौजूद है, तो यह एंडपॉइंट, बाउंडिंग पॉलीगॉन के किसी भी हिस्से से इंटरसेक्ट करने वाले कॉन्ट्रेल की जानकारी सिर्फ़ तब दिखाएगा.

अगर यह पैरामीटर मौजूद नहीं है, तो यह एंडपॉइंट, जगह की परवाह किए बिना, पता लगाए गए कॉन्ट्रेल की जानकारी दिखाएगा.

फ़ॉर्मैट: string array

उदाहरण: ["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"
      }
    }
  ]
}