Contrails API 개요

Contrails API로 빌드할 수 있는 항목을 살펴보고 엔드포인트가 작동하는 방식을 이해합니다.

개요

비행운 API는 대규모 날씨 데이터, 항공편 데이터, 위성 이미지를 최첨단 컴퓨터 비전 모델과 결합하여 AI 기반 비행운 예측을 생성합니다. 이러한 예측은 향후 48시간 동안의 비행운 발생 가능 지역과 잠재적인 비행운 영향을 예측합니다.

이러한 예측을 비행 계획 워크플로에 통합하면 조종사가 이러한 지역을 통과하는 것을 방지하여 온난화 비행운이 생성되는 것을 막을 수 있습니다.

운항로가 형성되는 위치와 온난화 정도를 파악하기 위해 Contrails API는 그리드 및 지역으로 예측을 제공합니다.

Contrails API는 다음과 같은 예측을 제공합니다.

그리드: NetCDF 형식으로 위도, 경도, 고도, 시간 축에 운항로 강제 지수 값을 나타내는 고품질 4D 데이터입니다. 이러한 그리드는 위도와 경도 단계가 0.25도인 4분의 1도 그리드로 전체 지구를 나타냅니다. 각 그리드는 1시간(UTC) 동안의 예측입니다.

비행운 강제 색인 값의 범위는 심각한 온난화가 없는 위치를 나타내는 0부터 심각한 비행운 온난화가 있는 위치를 나타내는 4까지입니다.

그리드는 특히 항공편 경로 변경과 같은 프로그래매틱 항공편 계획에 권장됩니다.
지역: GeoJSON multipolygon 형식으로 비행운 회피 지역을 나타내는 단순화된 다각형 버전의 예측입니다.

비행운 회피 지역은 동일한 심각도 수준으로 평가되지만 0이 생략되고 1 (경미한 영향)부터 시작됩니다.

지역은 심각도 수준에 따라 정책을 설정하고 일반적으로 수직 편차 (즉, 비행 고도 조정)를 통해 비행 경로를 수동으로 변경할 수 있는 인적 항공 계획 담당자에게 권장됩니다.

Contrails API를 사용하려면 API 키가 필요하며 Contrails API를 사용 설정해야 합니다.

자세한 내용은 환경 설정 가이드를 참고하세요.

Contrails API를 사용할 때 다음과 같은 오류가 발생할 수 있습니다.

코드	원인	오류 처리
400 (잘못된 요청)	잘못된 데이터가 포함된 요청	자동으로 다시 시도하지 마세요. 이 오류는 코드의 문제로 인해 발생합니다. 올바른 매개변수 형식을 사용하고 있는지 확인하세요.
404	아직 계산되지 않은 예측 시간을 요청합니다.	지수 백오프 전략으로 다시 시도합니다.
429	요청이 너무 많음 (사용량 한도 참고)	지수 백오프로 다시 시도합니다.
5XX	서버 오류	지수 백오프로 다시 시도합니다.

v2 출시와 같은 주 버전 출시에는 이전 버전과 호환되지 않는 동작이 도입될 수 있으며 코드 변경이 필요할 수 있습니다.

주 버전 출시 간의 정기 업데이트는 하위 호환될 것으로 예상됩니다.

Contrails API 출시 노트에서 주요 업데이트에 관해 자세히 알아볼 수 있습니다.