비행운 기여 분석 측정항목 가져오기

GET https://contrails.googleapis.com/v2/attributions:GetAttributionMetrics: 경계, 타임스탬프, 기여 분석 방법별로 집계된 비행운 기여 분석 측정항목을 가져옵니다.

호출이 성공하면 응답에서 다음이 포함된 AttributionMetrics 객체를 반환합니다.

  • 비행운이 기여 분석된 지정된 경계 내 비행 경로의 하위 집합 길이(미터)를 나타내는 flight_attributed_length_metres 필드
  • 지정된 경계 내 모든 비행운의 유효 에너지 강제력(줄)을 나타내는 effective_energy_forcing_joules 필드 유효 에너지 강제력은 그리드화된 CoCiP 예측 출력에서 유효 복사 강제력을 추출하고 이를 선형으로 보간하여 파생됩니다.
  • 복사 강제력 (RF)에서 유효 복사 강제력 (ERF)을 가져오는 데 사용되는 변환 상수를 나타내는 rf_erf_conversion_factor 필드

쿼리 매개변수

매개변수
bounds[]

string

필수 항목입니다. 각각 '위도,경도' 형식이어야 하며 지리적 영역을 나타내는 경계 다각형의 꼭짓점을 지정하는 문자열 쌍 목록입니다.

경계를 3개 이상 지정해야 합니다. 경계는 유효한 S2Polygon 다각형을 형성해야 합니다 (예: 중복 꼭짓점 없음, 자체 교차 없음). S2Polygon에 관한 자세한 내용은 S2Geometry 문서를 참고하세요.

예: ["37.7,-122.41", "37.78,-122.42", "37.79,-122.43"]
startTime

string

필수 항목입니다. 요청된 기여 분석된 비행운 감지의 시작 시간입니다.

형식: ISO 8601 날짜/시간 문자열

예: 2026-01-20T21:00:00Z
endTime

string

필수 항목입니다. 요청된 기여 분석된 비행운 감지의 종료 시간 (포함)입니다.

endTime은 startTime보다 14일 이상 클 수 없습니다.

형식: ISO 8601 날짜/시간 문자열

예: 2026-01-12T21:00:00Z
attributionMethod

enum (AttributionMethod)

필수 항목입니다. 비행운을 비행 구간에 기여 분석하는 데 사용되는 방법입니다.

형식: ATTRIBUTION_METHOD_OBSERVATION, ATTRIBUTION_METHOD_COCIP, ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP 중 하나여야 합니다.