เรียกข้อมูลตารางกริดพยากรณ์

GET https://contrails.googleapis.com/v2/grids: ดูตารางกริดของ การพยากรณ์คอนเทรล

หากสำเร็จ การตอบกลับจะเป็น NetCDF ของค่าการบังคับให้เกิดคอนเทรล

พารามิเตอร์การค้นหา

พารามิเตอร์
`time`	`string` ต้องระบุ เวลาที่ส่งคำขอ รูปแบบ: สตริงวันที่และเวลา ISO 8601 หรือจำนวนเต็มของ Epoch ของ Unix ตัวอย่าง: `2026-01-20T21:00:00Z`
`bbox[]`	`number` ไม่บังคับ ขอบเขตของภูมิภาคที่จะแสดงผล รูปแบบ: [lng_min, lat_min, lng_max, lat_max] ตัวอย่าง: `[-40, 20, 20, 60]`
`aircraftType`	`string` ไม่บังคับ รหัสเครื่องบิน รูปแบบ: รหัสประเภทเครื่องบิน ICAO 4 อักขระ ตัวอย่าง: `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` ไม่บังคับ ฟิลด์นี้ระบุตัวแปรข้อมูลที่จะรวมไว้ใน การตอบกลับ โดยสามารถจัดการตัวแปรข้อมูลได้ 1 ตัวหรือหลายตัว หากไม่ได้ระบุหรือเว้นว่างไว้ ค่าเริ่มต้นของช่องนี้จะเป็น `["contrails"]` ตัวอย่าง: `["contrails", "expected_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 ...
Attributes
inference_pipeli...		contrails.forecast-pipeline_20260115.02_p0
api_version :		contrails.api-service_20260125.00_p0
aircraft_class :		ค่าเริ่มต้น

หากต้องการดึงข้อมูลตารางกริดที่จำกัดไว้เฉพาะขอบเขตทางภูมิศาสตร์ที่เฉพาะเจาะจงและกรองสำหรับ เครื่องบินประเภทหนึ่งๆ โดยมีเวลาที่ระบุเป็นจำนวนเต็มของ Unix Epoch ให้ทำดังนี้
```
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},
)