Truy xuất các chỉ số phân bổ vết phản lực

GET https://contrails.googleapis.com/v2/attributions:GetAttributionMetrics: Nhận các chỉ số phân bổ đường bay tổng hợp theo ranh giới, dấu thời gian và phương pháp phân bổ.

Nếu thành công, phản hồi sẽ trả về một đối tượng AttributionMetrics chứa:

  • Một trường flight_attributed_length_metres biểu thị độ dài (tính bằng mét) của (các) tập hợp con của đường bay trong phạm vi đã chỉ định mà các vệt khói được gán.
  • Một trường effective_energy_forcing_joules biểu thị Lượng bức xạ cưỡng bức hiệu dụng (tính bằng joule) của tất cả các vệt phản lực trong phạm vi ranh giới được chỉ định. Lượng bức xạ cưỡng bức hiệu dụng được tính bằng cách trích xuất Lượng bức xạ cưỡng bức hiệu dụng từ đầu ra dự báo CoCiP dạng lưới và nội suy tuyến tính các đầu ra đó.
  • Trường rf_erf_conversion_factor biểu thị hằng số chuyển đổi được dùng để lấy Lực bức xạ hiệu dụng (ERF) từ Lực bức xạ (RF).

Tham số truy vấn

Tham số
bounds[]

string

Bắt buộc. Danh sách các cặp chuỗi, mỗi cặp phải ở định dạng "latitude,longitude", chỉ định các đỉnh cho một đa giác giới hạn đại diện cho khu vực địa lý.

Bạn phải chỉ định ít nhất 3 ranh giới. Ranh giới phải tạo thành một đa giác S2Polygon hợp lệ (ví dụ: không có đỉnh trùng lặp, không tự giao nhau); để biết thêm thông tin về S2Polygon, hãy tham khảo tài liệu S2Geometry.

Ví dụ: ["37.7,-122.41", "37.78,-122.42", "37.79,-122.43"]

startTime

string

Bắt buộc. Thời gian bắt đầu cho các lần phát hiện vệt khói được phân bổ theo yêu cầu.

Định dạng: Chuỗi ngày giờ theo tiêu chuẩn ISO 8601

Ví dụ: 2026-01-20T21:00:00Z

endTime

string

Bắt buộc. Thời gian kết thúc của các lần phát hiện vệt khói được phân bổ theo yêu cầu (bao gồm cả thời gian này).

Xin lưu ý rằng endTime không được vượt quá startTime quá 14 ngày.

Định dạng: Chuỗi ngày giờ theo tiêu chuẩn ISO 8601

Ví dụ: 2026-01-12T21:00:00Z

attributionMethod

enum (AttributionMethod)

Bắt buộc. Phương pháp được dùng để phân bổ vệt khói cho các chặng bay.

Định dạng: Phải là ATTRIBUTION_METHOD_OBSERVATION, ATTRIBUTION_METHOD_COCIP hoặc ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP.