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")

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

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

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

การตอบกลับที่มีคอนเทรลที่ระบุแหล่งที่มาสำหรับ 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)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ]
}
ช่อง
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 สำหรับเที่ยวบินนี้ได้
    • โดยปกติแล้ว ปัญหานี้เกิดจากข้อมูลอินพุตไม่เพียงพอ (เช่น ไม่มีข้อมูลสภาพอากาศหรือเส้นทางการบินไม่แน่นอน)
    • ซึ่งไม่ได้หมายความว่าไม่มีคอนเทรลเกิดขึ้น เพียงแต่ไม่สามารถระบุได้
segments[]

object (SegmentAttribution)

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

FlightDetails

กำหนดชุดข้อมูลเที่ยวบินทั้งหมดที่แสดงในคำตอบ

การแสดง JSON 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": integer
}
ช่อง
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

สัญญาณเรียกขานของเครื่องบิน ฟิลด์นี้ควรมีสัญญาณเรียกขานที่ใช้ในการสื่อสารของหน่วยควบคุมการจราจรทางอากาศ (ATC) หากไม่มีสัญญาณเรียกขาน ATC ที่เฉพาะเจาะจงหรือสัญญาณเรียกขาน ATC เหมือนกับตัวระบุเที่ยวบินมาตรฐาน ฟิลด์นี้จะเก็บตัวระบุเที่ยวบินมาตรฐาน (โดยปกติจะเป็นการรวมกันของรหัสสายการบินและหมายเลขเที่ยวบินสำหรับเที่ยวบินเชิงพาณิชย์)
analyzedFlightDistanceMeters

integer

ระยะทางของเที่ยวบินที่วิเคราะห์เป็นเมตร

ContrailAttributes

แสดงแอตทริบิวต์ของคอนเทรลสำหรับเที่ยวบินหรือกลุ่มเที่ยวบิน

การแสดง JSON 
{
  "lengthMeters": integer,
  "effectiveEnergyForcingJoules": string
}
ช่อง
lengthMeters

integer

ความยาวในหน่วยเมตรของชุดย่อยของเส้นทางการบินที่มีการระบุว่าเกิดคอนเทรล โดยคำนวณเป็นระยะทางตามเส้นวงกลมใหญ่ระหว่างจุดอ้างอิงของเที่ยวบิน
effectiveEnergyForcingJoules

string (int64 format)

แรงบังคับจากพลังงานคอนเทรลที่มีประสิทธิภาพทั้งหมดในหน่วยจูล ปัจจุบันระบบจะคำนวณโดยอิงตามค่าเฉลี่ยทางภูมิอากาศและอาจมีการเปลี่ยนแปลง

SegmentAttribution

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

การแสดง JSON 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ]
}
ช่อง
startTime

string (Timestamp format)

เวลาเริ่มต้นของส่วนเที่ยวบินที่มีการระบุว่าเกิดจากคอนเทรล การประทับเวลานี้อยู่ในรูปแบบวินาทีตั้งแต่ Epoch ของ UTC
endTime

string (Timestamp format)

เวลาสิ้นสุดของส่วนเที่ยวบินที่มีการระบุแหล่งที่มาของคอนเทรล การประทับเวลานี้อยู่ในหน่วยวินาทีของ Epoch UTC
contrail

object (ContrailAttributes)

แอตทริบิวต์ Contrail สำหรับกลุ่มที่เฉพาะเจาะจงนี้
detectionEvidences[]

object (ContrailDetectionEvidence)

การตรวจจับคอนเทรลของดาวเทียมแต่ละดวงซึ่งเป็นหลักฐานที่แสดงให้เห็นว่าคอนเทรลนี้เกิดจากส่วนของเที่ยวบินนี้

ContrailDetectionEvidence

รายละเอียดของการสังเกตการณ์คอนเทรลจากดาวเทียมดวงเดียว

การแสดง JSON 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
ช่อง
observationTime

string (Timestamp format)

เวลาที่ถ่ายภาพจากดาวเทียมซึ่งตรวจพบคอนเทรล ซึ่งโดยปกติแล้วจะเป็นเวลาเริ่มต้นของการสแกน การประทับเวลานี้อยู่ในรูปแบบวินาทีตั้งแต่ Epoch ของ UTC
observedLengthMeters

integer

ความยาวจากต้นทางถึงปลายทางของฟีเจอร์คอนเทรลเชิงเส้นที่สังเกตได้ในหน่วยเมตร ตามที่ตรวจพบในภาพถ่ายจากดาวเทียมที่ระบุโดย observationTime ความยาวนี้อาจแตกต่างจาก lengthMeters ใน SegmentAttribution.contrail เนื่องจากสาเหตุต่อไปนี้

  • ร่องรอยของเครื่องบินอาจมีการเปลี่ยนแปลง (เช่น แผ่ขยาย ยาวขึ้น ฯลฯ) ในชั้นบรรยากาศระหว่างการก่อตัวและการสังเกต
  • อัลกอริทึมการระบุแหล่งที่มาสามารถระบุแหล่งที่มาของคอนเทรลบางส่วนนี้ให้กับเที่ยวบินนี้ได้อย่างมั่นใจเท่านั้น
dataSource

enum (DataSource)

เอาต์พุตเท่านั้น แหล่งที่มาของข้อมูลดาวเทียมที่ใช้ในการตรวจจับนี้

DataSource

แหล่งที่มาของข้อมูลดาวเทียมที่ใช้ในการตรวจจับคอนเทรล ทั้งนี้ อาจมีการเพิ่มค่าอื่นๆ ในอนาคต

Enum
DATA_SOURCE_UNSPECIFIED แหล่งข้อมูลที่ไม่ได้ระบุ
GOES_EAST_FULL_DISK ข้อมูลจากการสแกนดิสก์ทั้งหมดของ GOES-East
GOES_WEST_FULL_DISK ข้อมูลจากการสแกนดิสก์ทั้งหมดของ GOES-West
MTG_000_FULL_DISK ข้อมูลจากการสแกนดิสก์ทั้งหมดของ MTG-000
HIMAWARI_FULL_DISK ข้อมูลจากการสแกนดิสก์ทั้งหมดของ Himawari