Method: batchGetAttributions

항공편 정보를 기반으로 여러 비행운 기여도를 가져옵니다.

성공하면 응답은 비행운 기여 목록이 됩니다.

HTTP 요청

GET https://contrails.googleapis.com/v2/{parent=attributions}:batchGet

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

파라미터
parent

string

필수 항목입니다. 가져오는 모든 기여 분석에서 공유하는 상위 리소스입니다. 형식: 저작자 표시

쿼리 매개변수

매개변수
names[]

string

필수 항목입니다. 가져올 항공편의 리소스 이름입니다. 단일 요청에 최대 100개의 이름을 제공할 수 있습니다.

형식:

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").

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

attributions.batchGet의 기여도가 부여된 비행운을 포함하는 응답입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

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 epoch; 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

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

열거형
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 전체 디스크 스캔의 데이터입니다.