기여 분석

특정 항공편 목록에 기여도가 부여된 비행운 세그먼트입니다.

데이터 형식

속성이 부여된 비행운 요청에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
필드
attributions[]

object (Attribution)

BatchGetAttributionsRequest.names에 지정된 각 리소스 이름에 대한 저작자 표시 목록입니다. 이 목록의 저작자 표시 순서는 BatchGetAttributionsRequest의 이름 순서와 일치합니다. 항공편을 찾을 수 없는 경우 응답의 해당 기여 분석 메시지에는 name 필드만 채워지고 flightDetails 및 contrail는 비어 있습니다.

기여 분석

특정 항공편의 집계된 비행운 이벤트를 나타내며, 기여도가 부여된 모든 비행운 세그먼트 (예: 총 킬로미터 및 에너지)를 요약합니다.

JSON 표현 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ]
}
필드
name

string

식별자. 항공편의 리소스 이름입니다.

형식:

carriers/{carrier}/flightNumbers/{flightNumber}/departureDates/{departure_date}/departureAirports/{departure_airport}

구성요소:

  • {carrier}: 2자리 IATA 항공사 코드입니다 (예: "AA", "UA").
  • {flightNumber}: 1~4자리 항공편 번호 (예: "123")입니다.
  • {departure_date}: YYYY-MM-DD 형식의 출발 공항 현지 시간에 따른 항공편 출발 날짜입니다 (2024년부터 사용 가능).
  • {departure_airport}: 3자리 IATA 공항 코드입니다 (예: "JFK", "LHR").
flightDetails

object (FlightDetails)

이 항공편의 세부정보입니다.
contrail

object (ContrailAttributes)

전체 항공편의 집계된 비행운 속성입니다. 이는 기여도가 부여된 모든 세그먼트의 비행운 속성을 합산합니다.

상태 해석 (발견된 항공편 내):

  • 있는 경우: 비행운 분석이 수행되었습니다. ContrailAttributes 내부의 필드는 결과를 나타냅니다 (예: lengthMeters > 0은 비행운이 기여했음을 의미). 빈 ContrailAttributes 메시지가 있으면 분석이 실행되었지만 lengthMeters과 에너지 강제 설정이 모두 0으로 평가되었음을 의미합니다.
  • 없는 경우: 이 항공편에 대해 비행운 분석을 수행할 수 없습니다.
    • 이는 일반적으로 입력 데이터가 불충분하기 때문입니다 (예: 날씨 데이터 누락 또는 비행 경로 불확실성).
    • 이는 비행운이 형성되지 않았다는 의미가 아니라 판단할 수 없다는 의미입니다.
segments[]

object (SegmentAttribution)

세그먼트별 비행운 기여도입니다. 각 항목은 비행 중 비행운이 발생한 서로 다른 시간 간격을 나타냅니다.

FlightDetails

응답에 반환되는 전체 항공편 정보를 정의합니다.

JSON 표현 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": integer
}
필드
carrier

string

항공편의 IATA 항공사 코드입니다 (예: 'AA').
flightNumber

integer

항공편의 항공편 번호입니다 (예: '123').
departureTime

string

출발일(YYYYMMDD 형식, 출발 공항의 시간대)
icao24

string

ICAO 24비트 항공기 주소
originAirport

string

IATA 출발지 공항 코드입니다.
destinationAirport

string

IATA 목적지 공항 코드입니다.
callSign

string

항공기의 호출 부호입니다. 이 필드에는 항공 교통 관제 (ATC) 통신에 사용되는 호출 부호가 우선적으로 포함됩니다. 특정 ATC 호출 부호가 없거나 표준 항공편 지정자와 동일한 경우 이 필드에는 표준 항공편 지정자가 포함됩니다 (일반적으로 상업용 항공편의 경우 항공사 코드와 항공편 번호의 조합).
analyzedFlightDistanceMeters

integer

분석된 비행 거리(미터)입니다.

ContrailAttributes

항공편 또는 항공편 세그먼트의 비행운 속성을 나타냅니다.

JSON 표현 
{
  "lengthMeters": integer,
  "effectiveEnergyForcingJoules": string
}
필드
lengthMeters

integer

비행 경로 중 비행운이 발생한 부분의 길이(미터)입니다. 이는 비행 경로 지점 간의 대권 거리로 계산됩니다.
effectiveEnergyForcingJoules

string (int64 format)

총 유효한 비행운 에너지 강제력(단위: 줄)입니다. 이는 4D 그리드 CoCiP 예측 출력에서 유효한 복사 강제력을 추출하고 선형으로 보간하여 파생됩니다. 이 방법론은 변경될 수 있습니다.

SegmentAttribution

항공편의 특정 시간 세그먼트에 대한 비행운 기여도를 나타냅니다.

JSON 표현 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}
필드
startTime

string (Timestamp format)

비행운이 기여한 항공편 구간의 시작 시간입니다. 이 타임스탬프는 UTC 에포크 초 단위입니다.
endTime

string (Timestamp format)

비행운이 기여한 항공편 세그먼트의 종료 시간입니다. 이 타임스탬프는 UTC 에포크 초 단위입니다.
contrail

object (ContrailAttributes)

이 특정 세그먼트의 비행운 속성입니다.
detectionEvidences[]

object (ContrailDetectionEvidence)

이 비행 구간에 대한 기여도를 입증하는 개별 위성 비행운 감지입니다.
attributionMethod

enum (AttributionMethod)

출력 전용입니다. 이 세그먼트에 비행운을 기여 분석하는 데 사용된 방법입니다 (예: CoCiP 모델 또는 직접 관찰).
longGapInterpolation

boolean

출력 전용입니다. 세그먼트 비행 경로가 긴 ADS-B 데이터 격차 (>5분)에 걸쳐 보간하여 생성된 경우 True입니다.
waypointAttributions[]

object (WaypointAttribution)

출력 전용입니다. 이 구간에 매핑된 웨이포인트별 비행운 속성입니다.

ContrailDetectionEvidence

비행운의 단일 위성 관측 세부정보입니다.

JSON 표현 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
필드
observationTime

string (Timestamp format)

비행운이 감지된 위성 이미지가 촬영된 시간입니다. 일반적으로 스캔 시작 시간입니다. 이 타임스탬프는 UTC 에포크 초 단위입니다.
observedLengthMeters

integer

observationTime로 지정된 위성 이미지에서 감지된 선형 비행운 기능의 관측된 전체 길이(미터)입니다. 이 길이는 다음과 같은 이유로 SegmentAttribution.contrail의 lengthMeters와 다를 수 있습니다.

  • 비행운은 형성된 후 관찰될 때까지 대기 중에서 진화 (예: 확산, 연장 등)했을 수 있습니다.
  • 이 비행에 대한 기여도 분석 알고리즘은 이 비행운의 일부만 이 비행에 기여한 것으로 확실하게 판단할 수 있었습니다.
dataSource

enum (DataSource)

출력 전용입니다. 이 감지에 사용된 위성 데이터의 소스입니다.

DataSource

비행운 감지에 사용되는 위성 데이터의 소스입니다. 향후 값이 추가될 수 있습니다.

사용 가능한 위성 데이터 출력 중 GOES East 및 Himawari 기반 속성은 프로덕션 수준의 품질을 갖는 반면 MTG 기반 속성은 아직 베타 단계에 있으며 품질 개선이 적극적으로 진행되고 있습니다.

열거형
DATA_SOURCE_UNSPECIFIED 지정되지 않은 데이터 소스입니다.
GOES_EAST_FULL_DISK GOES-East 전체 디스크 스캔의 데이터입니다.
GOES_WEST_FULL_DISK GOES-West 전체 디스크 스캔의 데이터입니다.
MTG_000_FULL_DISK MTG-000 전체 디스크 검사에서 가져온 데이터입니다.
HIMAWARI_FULL_DISK Himawari 전체 디스크 스캔의 데이터입니다.

Contrails API 위성 이미지는 다음을 기반으로 합니다.

WaypointAttribution

항공편 세그먼트의 특정 경유지의 비행운 속성을 나타냅니다.

JSON 표현 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
필드
time

string (Timestamp format)

UTC 에포크 초 단위의 경유지 시간입니다.
contrailAttributes

object (ContrailAttributes)

이 특정 경유지에서 매핑된 비행운 속성입니다.

AttributionMethod

기여도를 부여하는 데 사용된 구체적인 절차 또는 방법론을 정의합니다.

열거형
ATTRIBUTION_METHOD_OBSERVATION 위성 비행운 감지와 일치하여 엄격하게 파생된 기여 분석입니다.
ATTRIBUTION_METHOD_COCIP 물리 기반 CoCiP 모델링에만 의존하는 속성입니다.
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

위성 감지로 조정된 CoCiP 모델 예측을 결합한 하이브리드 기여도 분석입니다.

  • 감지됨: detectionEvidences가 있으면 비행운이 예측되고 관찰을 통해 확인되어 경고 가중치가 강화됩니다.
  • 감지되지 않음: detectionEvidences이 누락된 경우 비행운이 예측되었지만 관찰되지 않았으므로 계산된 온난화가 할인됩니다.
ATTRIBUTION_METHOD_UNSPECIFIED 지정되지 않은 메서드입니다.

참고

각 DataSource는 관찰 기반 뷰를 처리하는 데 서로 다른 경계를 사용합니다.

위성 범위 경계 상자 (플랫 메르카토르 뷰)

라이선스

ContrailWatch Attributions API에 의해 노출되는 데이터는 CC BY-NC 4.0에 따라 라이선스가 부여됩니다.