เรียกดูภูมิภาคที่พยากรณ์

GET https://contrails.googleapis.com/v2/regions: รับภูมิภาคที่ควรหลีกเลี่ยงการเกิดคอนเทรลในรูปแบบ GeoJSON Multipolygon

หากสำเร็จ การตอบกลับจะเป็น FeatureCollection ในรูปแบบ GeoJSON

ระบบจะจัดระดับความรุนแรงของภูมิภาคที่หลีกเลี่ยงคอนเทรลที่แสดงผลในรูปแบบรูปหลายเหลี่ยม โดยมีตั้งแต่ 1 ถึง 4 สำหรับระดับการบินแต่ละระดับ ยิ่งค่าสูงเท่าใด คอนเทรลก็จะยิ่งรุนแรงมากขึ้นเท่านั้น

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

พารามิเตอร์
`time`	`string` ต้องระบุ เวลาที่ส่งคำขอ รูปแบบ: สตริงวันที่และเวลา ISO 8601 หรือจำนวนเต็มของ Epoch ของ Unix ตัวอย่าง: `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	ค่าเริ่มต้น

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