예측 지역 가져오기

GET https://contrails.googleapis.com/v2/regions: GeoJSON multipolygon 형식으로 비행운 회피 지역을 가져옵니다.

성공하면 응답은 GeoJSON 형식의 FeatureCollection입니다.

다각형 형식으로 반환된 비행운 회피 지역은 각 비행 고도에 대해 1~4의 심각도 수준으로 평가됩니다. 값이 높을수록 비행운이 더 심합니다.

쿼리 매개변수

매개변수
time

string

필수 항목입니다. 요청 시간입니다.

형식: ISO 8601 datetime 문자열 또는 Unix epoch 정수

예: 2026-01-20T21:00:00Z
flightLevel[]

integer

선택사항입니다. 반환할 비행 수준입니다. 플라이트 수준을 지정하지 않으면 모든 플라이트 수준이 포함됩니다.

형식: 비행 고도(단위: 100피트); [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},
)