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}: รหัสสายการบิน IATA 2 อักขระ (เช่น "AA", "UA")
  • {flightNumber}: หมายเลขเที่ยวบิน 1-4 หลัก (เช่น "123")
  • {departure_date}: วันที่ออกเดินทางของเที่ยวบินในรูปแบบ YYYY-MM-DD
  • {departure_airport}: รหัสสนามบิน IATA 3 ตัวอักษร (เช่น "JFK", "LHR")

เนื้อความของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

การตอบกลับที่มีเส้นทาง Conversion ที่ระบุแหล่งที่มาสำหรับ attributions.batchGet

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

การแสดง JSON 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
ช่อง
attributions[]

object (Attribution)

รายการการระบุแหล่งที่มา 1 รายการสำหรับชื่อทรัพยากรแต่ละรายการที่ระบุใน 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}: รหัสสายการบิน IATA 2 อักขระ (เช่น "AA", "UA")
  • {flightNumber}: หมายเลขเที่ยวบิน 1-4 หลัก (เช่น "123")
  • {departure_date}: วันที่ออกเดินทางของเที่ยวบินในรูปแบบ YYYY-MM-DD
  • {departure_airport}: รหัสสนามบิน IATA 3 ตัวอักษร (เช่น "JFK", "LHR")
flightDetails

object (FlightDetails)

ข้อมูลโดยละเอียดของเที่ยวบินนี้
contrail

object (ContrailAttributes)

รายละเอียดเกี่ยวกับคอนเทรลที่ระบุแหล่งที่มาของเที่ยวบิน

การตีความสถานะ (ภายในเที่ยวบินที่พบ):

  • หากมี: มีการวิเคราะห์คอนเทรล ฟิลด์ภายใน ContrailAttributes จะระบุผลลัพธ์ (เช่น lengthMeters > 0 หมายความว่ามีการระบุแหล่งที่มาของคอนเทรล)
  • หากไม่มี: ไม่สามารถทำการวิเคราะห์ Contrail สำหรับเที่ยวบินนี้ได้
    • โดยปกติแล้ว ปัญหานี้เกิดจากข้อมูลอินพุตไม่เพียงพอ (เช่น ไม่มีข้อมูลสภาพอากาศหรือเส้นทางการบินไม่แน่นอน)
    • ซึ่งไม่ได้หมายความว่าไม่มีคอนเทรลเกิดขึ้น เพียงแต่ไม่สามารถระบุได้

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

ที่อยู่เครื่องบิน 24 บิตของ ICAO
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)

การแผ่รังสีสุทธิทั้งหมดที่เกิดจากเที่ยวบินนี้ในหน่วยจูล