पूर्वानुमान ग्रिड वापस पाना

GET https://contrails.googleapis.com/v2/grids: कॉन्ट्रेल के पूर्वानुमानों की ग्रिड पाएं.

अगर अनुरोध पूरा हो जाता है, तो जवाब में कॉन्ट्रेल फ़ोर्सिंग वैल्यू का NetCDF होगा.

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

पैरामीटर
`time`	`string` ज़रूरी है. अनुरोध का समय. फ़ॉर्मैट: ISO 8601 datetime स्ट्रिंग या Unix epoch integer उदाहरण: `2026-01-20T21:00:00Z`
`bbox[]`	`number` ज़रूरी नहीं. लौटाए जाने वाले क्षेत्र की सीमाएं. फ़ॉर्मैट: [lng_min, lat_min, lng_max, lat_max] उदाहरण: `[-40, 20, 20, 60]`
`aircraftType`	`string` ज़रूरी नहीं. हवाई जहाज़ का कोड. फ़ॉर्मैट: चार वर्णों वाला आईसीएओ एयरक्राफ़्ट टाइप कोड उदाहरण: `A320`
`flightLevel[]`	`integer` ज़रूरी नहीं. फ़्लाइट के लेवल की जानकारी. अगर फ़्लाइट का लेवल नहीं बताया गया है, तो सभी फ़्लाइट लेवल शामिल किए जाते हैं. फ़ॉर्मैट: फ़्लाइट लेवल, हेक्टोफ़ीट में; [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440] उदाहरण: `[270, 280, 290, 300]`
`format`	`string` ज़रूरी नहीं. अनुरोध किया गया फ़ॉर्मैट. 'netcdf4' के अलावा कोई दूसरी वैल्यू डालने पर, UNIMPLEMENTED गड़बड़ी दिखेगी. इसकी वजह यह है कि पॉलीगॉन काम नहीं करते.
`aircraftClass`	`string` ज़रूरी नहीं. एयरक्राफ़्ट क्लास. फ़िलहाल, सिर्फ़ `default` को इस्तेमाल किया जा सकता है.
`data[]`	`string` ज़रूरी नहीं. इस फ़ील्ड से यह तय होता है कि जवाब में कौनसे डेटा वैरिएबल शामिल करने हैं. यह एक या उससे ज़्यादा डेटा वैरिएबल को हैंडल कर सकता है. अगर यह फ़ील्ड खाली है या इसकी वैल्यू नहीं दी गई है, तो डिफ़ॉल्ट रूप से `["contrails"]` लागू हो जाता है. उदाहरण: `["contrails", "expected_effective_energy_forcing", "persistent_formation_probability", "nominal_cocip_effective_energy_forcing"]`

उदाहरण

किसी खास समय के लिए, डिफ़ॉल्ट ग्लोबल कॉन्ट्रेल ग्रिड को वापस पाने के लिए:

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

xarray के साथ लोड करने पर, यह अनुरोध नीचे दिया गया डेटासेट दिखाता है:

डाइमेंशन: (longitude: 1441, latitude: 721, flight_level: 18, time: 1)
निर्देशांक
नाम	आयाम	डेटा टाइप	वैल्यू
longitude	(देशांतर)	float32	-180.0 -179.8 ... 179.8 1...
latitude	(अक्षांश)	float32	-90.0 -89.75 -89.5 ... 8...
flight_level	(flight_level)	int16	270 280 290 300 ... 41...
समय	(समय)	datetime64[ns]	2026-01-28T20:00:00
forecast_reference_time	(समय)	datetime64[ns]	2026-01-27T08:00:00
डेटा वैरिएबल
कॉन्ट्रेल	(longitude, latitude, flight_level, time)	float32	0.0 0.0 0.0 0.0 ... 0.0 ...
विशेषताएं
inference_pipeli...		contrails.forecast-pipeline_20260115.02_p0
api_version :		contrails.api-service_20260125.00_p0
aircraft_class :		डिफ़ॉल्ट

किसी खास भौगोलिक सीमा के हिसाब से सीमित की गई और किसी खास तरह के एयरक्राफ्ट के हिसाब से फ़िल्टर की गई ग्रिड को वापस पाने के लिए, समय को यूनिक्स इपॉक पूर्णांक के तौर पर सेट करें:
```
response = requests.get(
  url="https://contrails.googleapis.com/v2/grids",
  params={"time": 1769508160,
          "bbox": [-40, 20, 20, 60],
          "aircraftType": "A320"
          },
  headers={"x-goog-api-key": API_KEY},
)
```

फ़्लाइट लेवल के सबसेट और किसी खास इलाके तक सीमित ग्रिड को वापस पाने के लिए, contrails और expected_effective_energy_forcing लेयर का इस्तेमाल करें:

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

अगर आपको contrails, persistent_formation_probability, और nominal_cocip_effective_energy_forcing डेटा वैरिएबल वाला ग्रिड वापस पाना है, तो:

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