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)
  }
}
필드
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은 비행운이 기여했음을 의미합니다.
  • 없는 경우: 이 항공편에 대해 비행운 분석을 수행할 수 없습니다.
    • 이는 일반적으로 입력 데이터가 부족하기 때문입니다 (예: 날씨 데이터 누락 또는 비행 경로 불확실성).
    • 이것은 비행운이 형성되지 않았다는 의미가 아니라 판단할 수 없다는 의미입니다.

FlightDetails

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

JSON 표현 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": string
}
필드
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

경로점과 연결된 항공기의 호출 부호입니다.
analyzedFlightDistanceMeters

string (int64 format)

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

ContrailAttributes

항공편의 비행운 속성을 나타냅니다.

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

string (int64 format)

예상되는 비행운 형성 길이(미터)입니다.
effectiveEnergyForcingJoules

string (int64 format)

이 항공편에 기여한 총 유효 에너지 강제력(단위: 줄)입니다.