예측 그리드 가져오기

GET https://contrails.googleapis.com/v2/grids: 비행운 예측 그리드를 가져옵니다.

성공하면 응답은 비행운 강제 값의 NetCDF가 됩니다.

쿼리 매개변수

매개변수
time

string

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

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

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

number

선택사항입니다. 반환할 지역의 경계입니다.

형식: [lng_min, lat_min, lng_max, lat_max]

예: [-40, 20, 20, 60]
aircraftType

string

선택사항입니다. 항공기 코드입니다.

형식: 4자리 ICAO 항공기 유형 코드

예: A320
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]
format

string

선택사항입니다. 요청된 형식입니다. 'netcdf4' 이외의 값을 전달하면 다각형이 지원되지 않으므로 UNIMPLEMENTED 오류가 발생합니다.
aircraftClass

string

선택사항입니다. 항공기 클래스입니다. 현재 default만 지원됩니다.
data[]

string

선택사항입니다. 이 필드는 응답에 포함할 데이터 변수를 지정합니다. 하나 또는 여러 개의 데이터 변수를 처리할 수 있습니다. 이 필드가 비어 있거나 제공되지 않으면 기본값은 ["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...
    time (시간) 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 : 기본값

  • 특정 지리적 경계로 제한되고 특정 항공기 유형에 대해 필터링된 그리드를 가져오려면 시간을 Unix 에포크 정수로 지정하세요.

    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},
)