기여 분석

특정 항공편 목록의 기여 비행운 세그먼트입니다.

데이터 형식

기여 분석된 비행운에 대한 요청에는 다음 구조의 데이터가 포함됩니다.

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

object (Attribution)

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

기여 분석

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

JSON 표현 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ],
  "visualizationUrl": string
}
필드
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)

세그먼트별 비행운 기여 분석 각 항목은 비행운이 발생한 비행의 개별 시간 간격을 나타냅니다.
visualizationUrl

string

출력 전용입니다. ContrailExplorer의 ContrailWatch 페이지에서 이 항공편의 비행운 기여 분석을 대화형 시각화로 보여주는 링크입니다. 위성에서 감지한 비행운과 일치하는 비행 경로를 보여줍니다.

ATTRIBUTION_VIEW_OBSERVATION 뷰를 사용할 때 찾은 항공편에만 채워집니다.

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 히마와리 전체 디스크 스캔의 데이터입니다.

비행운 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에 따라 라이선스가 부여됩니다.