Method: getRegions

पॉलीगॉन वाले इलाकों के तौर पर, कॉन्ट्रेल का अनुमान पाएं.

अगर अनुरोध पूरा हो जाता है, तो रिस्पॉन्स के तौर पर GeoJSON मिलेगा. इसमें FeatureCollection होगा, जिसका फ़ॉर्मैट नीचे दिया गया है:

{
  "type": "FeatureCollection",
  "features": [
      {
        "type": "Feature",
        "properties": {
            "time": "<ISO 8601 datetime>",
            "flightLevel": <int>,
            "threshold": <int>,
            "forecast_reference_time": "<ISO 8601 datetime>"
        },
        "geometry": {
          "type": "MultiPolygon",
          "coordinates": [...]
        }
      }
  ]
}

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

एचटीटीपी अनुरोध

GET https://contrails.googleapis.com/v2/regions

यूआरएल में gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल किया गया है.

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

पैरामीटर
time

string

ज़रूरी है. अनुरोध का समय [int: यूनिक्स युग; str: ISO 8601]
flightLevel[]

integer

ज़रूरी नहीं. हेक्टोफ़ीट में फ़्लाइट लेवल. वैल्यू की मान्य रेंज 270 से 440 (इनके बीच) है.
threshold

integer

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

string

ज़रूरी नहीं. एयरक्राफ़्ट क्लास. फ़िलहाल, सिर्फ़ 'डिफ़ॉल्ट' का इस्तेमाल किया जा सकता है.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

अगर अनुरोध पूरा हो जाता है, तो रिस्पॉन्स एक सामान्य एचटीटीपी रिस्पॉन्स होता है. इसका फ़ॉर्मैट, तरीके के हिसाब से तय होता है.