पूर्वानुमान के लिए उपलब्ध क्षेत्रों की जानकारी पाना

GET https://contrails.googleapis.com/v2/regions: GeoJSON मल्टीपॉलीगॉन फ़ॉर्मैट में, कॉन्ट्रेल से बचने के लिए क्षेत्रों की जानकारी पाएं.

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

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

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

पैरामीटर
time

string

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

फ़ॉर्मैट: ISO 8601 datetime स्ट्रिंग या Unix epoch integer

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

flightLevel[]

integer

ज़रूरी नहीं. फ़्लाइट के लेवल की जानकारी. अगर फ़्लाइट का लेवल नहीं बताया गया है, तो सभी फ़्लाइट लेवल शामिल किए जाते हैं.

फ़ॉर्मैट: फ़्लाइट लेवल, हेक्टोफ़ीट में; [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440]

उदाहरण: [270, 280, 290, 300]

threshold

integer

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

फ़ॉर्मैट: मान्य वैल्यू 1 से 4 (दोनों शामिल) के बीच होती हैं.

aircraftClass

string

ज़रूरी नहीं. हवाई जहाज़ की क्लास. फ़िलहाल, सिर्फ़ default को इस्तेमाल किया जा सकता है.

उदाहरण

  • किसी खास समय के लिए, विमानों के टकराने से बचने के लिए तय किए गए सभी इलाकों की जानकारी पाने के लिए:

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

    GeoJSON रिस्पॉन्स में, पॉलीगॉन फ़ॉर्मैट में कॉन्ट्रेल से बचने के लिए सभी इलाकों की सूची दी गई है:

    ज्यामिति flight_level थ्रेशोल्ड समय forecast_reference_time aircraft_class
    0 MULTIPOLYGON Z (((166.25 81.12 8229.6, 168.37 ... 270 1 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 डिफ़ॉल्ट
    1 MULTIPOLYGON Z (((92.38 45.5 8229.6, 93 46.62 ... 270 2 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 डिफ़ॉल्ट
    2 MULTIPOLYGON Z (((83.38 65 8229.6, 84 66.12 82... 270 3 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 डिफ़ॉल्ट
    3 MULTIPOLYGON Z (((57.38 76 8229.6, 57.75 76.88... 270 4 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 डिफ़ॉल्ट
    4 MULTIPOLYGON Z (((162.38 79 8534.4, 162.75 79.... 280 1 2026-01-28T20:00:00+00:00 2026-01-27T08:00:00+00:00 डिफ़ॉल्ट
  • किसी खास फ़्लाइट लेवल के लिए, कॉन्ट्रेल से बचने के लिए तय की गई जगहों की जानकारी पाने के लिए, समय को यूनिक्स इपोक पूर्णांक के तौर पर तय करें:

    response = requests.get(
      url="https://contrails.googleapis.com/v2/regions",
      params={
        "time": 1768942800,
        "flightLevel": [300,310,320,330]
      },
      headers={"x-goog-api-key": API_KEY},
    )
    
  • किसी खास फ़्लाइट लेवल तक सीमित, कॉन्ट्रेल से बचने वाले क्षेत्रों को वापस पाने के लिए और गंभीरता के लेवल का थ्रेशोल्ड 3 के बराबर या उससे ज़्यादा होने पर:

    response = requests.get(
      url="https://contrails.googleapis.com/v2/regions",
      params={
        "time": 2026-01-27T12:00:00Z,
        "flightLevel": [300,310,320,330],
        "threshold": 3
      },
      headers={"x-goog-api-key": API_KEY},
    )