เรียกข้อมูลเมตริกการระบุแหล่งที่มาของคอนเทรล

GET https://contrails.googleapis.com/v2/attributions:GetAttributionMetrics: รับเมตริกการระบุแหล่งที่มาของคอนเทรลที่รวบรวมตามขอบเขต การประทับเวลา และวิธีการระบุแหล่งที่มา

หากทำสำเร็จ การตอบกลับจะแสดงออบเจ็กต์ AttributionMetrics ซึ่งมีข้อมูลต่อไปนี้

  • ฟิลด์ flight_attributed_length_metres ซึ่งแสดงความยาวเป็นเมตรของเส้นทางการบินบางส่วนภายในขอบเขตที่ระบุซึ่งมีการระบุแหล่งที่มาของคอนเทรล
  • ฟิลด์ effective_energy_forcing_joules ซึ่งแสดงการบังคับพลังงานที่มีประสิทธิภาพเป็นจูลของคอนเทรลทั้งหมดภายในขอบเขตที่ระบุ การบังคับพลังงานที่มีประสิทธิภาพได้มาจากการดึงการบังคับการแผ่รังสีที่มีประสิทธิภาพจากเอาต์พุตการคาดการณ์ CoCiP แบบกริดและประมาณค่าเชิงเส้น
  • ฟิลด์ rf_erf_conversion_factor ซึ่งแสดงค่าคงที่ของการแปลงที่ใช้เพื่อให้ได้การบังคับการแผ่รังสีที่มีประสิทธิภาพ (ERF) จากการบังคับการแผ่รังสี (RF)

พารามิเตอร์การค้นหา

พารามิเตอร์
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