기여 분석

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

데이터 형식

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

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: Unix 에포크 또는 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 전체 디스크 스캔의 데이터입니다.