기여 분석

특정 항공편 목록에 대한 기여운항적운 세그먼트입니다.

데이터 형식

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

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 형식의 항공편 출발일입니다.
  • {departure_airport}: 3자리 IATA 공항 코드입니다 (예: "JFK", "LHR").
flightDetails

object (FlightDetails)

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

object (ContrailAttributes)

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

상태 해석 (찾은 항공편 내):

  • 있는 경우: 비행운 분석이 수행되었습니다. 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

출발 날짜(출발 공항의 시간대)입니다. int: 유닉스 에포크 또는 str: ISO 8601
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)

총 유효한 비행운 에너지 강제력(단위: 줄)입니다. 현재 기후학적 평균을 기준으로 계산되며 변경될 수 있습니다.

SegmentAttribution

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

JSON 표현 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ]
}
필드
startTime

string (Timestamp format)

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

string (Timestamp format)

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

object (ContrailAttributes)

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

object (ContrailDetectionEvidence)

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

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 및 MTG를 위성 데이터 출력으로 사용할 수 있습니다. GOES East 기반 속성은 프로덕션 수준의 품질을 갖는 반면 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 전체 디스크 스캔의 데이터입니다.