Truy xuất các khu vực dự báo

GET https://contrails.googleapis.com/v2/regions: Lấy các khu vực tránh vết phản lực ở định dạng GeoJSON multipolygon.

Nếu thành công, phản hồi sẽ là FeatureCollection ở định dạng GeoJSON.

Các khu vực tránh vệt ngưng tụ được trả về ở định dạng đa giác được đánh giá theo các mức độ nghiêm trọng, từ 1 đến 4 cho mỗi độ cao bay. Giá trị càng cao thì vết phản lực càng nghiêm trọng.

Tham số truy vấn

Tham số
time

string

Bắt buộc. Thời gian yêu cầu.

Định dạng: Chuỗi ngày giờ ISO 8601 HOẶC số nguyên thời gian bắt đầu của Unix

Ví dụ: 2026-01-20T21:00:00Z
flightLevel[]

integer

Không bắt buộc. Các cấp độ bay sẽ trả về. Nếu bạn không chỉ định cấp độ chuyến bay, thì tất cả cấp độ chuyến bay đều được đưa vào.

Định dạng: Độ cao bay tính bằng hectofeet; [270, 280, 290, 300, 310, 320, 330, 340, 350, 360, 370, 380, 390, 400, 410, 420, 430, 440]

Ví dụ: [270, 280, 290, 300]
threshold

integer

Không bắt buộc. Ngưỡng mức độ nghiêm trọng tối thiểu. Việc đặt trường này chỉ trả về những khu vực có mức độ nghiêm trọng lớn hơn hoặc bằng ngưỡng.

Định dạng: Giá trị hợp lệ nằm trong khoảng từ 1 đến 4 (bao gồm cả 1 và 4).
aircraftClass

string

Không bắt buộc. Loại máy bay. Hiện tại, chúng tôi chỉ hỗ trợ default.

Ví dụ

  • Cách truy xuất tất cả các khu vực tránh vết phản lực cho một thời điểm cụ thể:

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

    Phản hồi GeoJSON liệt kê tất cả các khu vực tránh vết khói ở định dạng đa giác:

    hình học flight_level ngưỡng giải lao 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 mặc định
    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 mặc định
    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 mặc định
    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 mặc định
    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 mặc định

  • Để truy xuất các khu vực tránh vết phản lực bị giới hạn ở các độ cao bay cụ thể, với thời gian được chỉ định là một số nguyên theo kỷ nguyên 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},
)

  • Để truy xuất các khu vực tránh vết ngưng tụ bị giới hạn ở các độ cao bay cụ thể và bằng hoặc trên ngưỡng mức độ nghiêm trọng là 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},
)