การระบุแหล่งที่มา

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

รูปแบบข้อมูล

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

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

object (Attribution)

รายการการระบุแหล่งที่มา 1 รายการสำหรับชื่อทรัพยากรแต่ละรายการที่ระบุใน BatchGetAttributionsRequest.names ลำดับการระบุแหล่งที่มาในรายการนี้จะตรงกับลำดับชื่อใน BatchGetAttributionsRequest หากไม่พบเที่ยวบิน ข้อความ Attribution ที่เกี่ยวข้องในการตอบกลับจะมีเฉพาะข้อมูลในช่อง name ส่วน flightDetails และ contrail จะว่างเปล่า

การระบุแหล่งที่มา

แสดงเหตุการณ์เมฆหางเครื่องบินแบบรวมสำหรับเที่ยวบินที่เจาะจงซึ่งสรุปส่วนเมฆหางเครื่องบินที่ระบุแหล่งที่มาทั้งหมด (เช่น กิโลเมตรและพลังงานทั้งหมด)

การแสดง JSON 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ],
  "visualizationUrl": string
}
ช่อง
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 (ใช้ได้ตั้งแต่ปี 2024 เป็นต้นไป)
  • {departure_airport}: รหัสสนามบิน IATA 3 ตัวอักษร (เช่น "JFK", "LHR")
flightDetails

object (FlightDetails)

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

object (ContrailAttributes)

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

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

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

object (SegmentAttribution)

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

string

เอาต์พุตเท่านั้น ลิงก์ไปยังการแสดงภาพแบบอินเทอร์แอกทีฟของการระบุแหล่งที่มาของคอนเทรลของเที่ยวบินนี้ในหน้า ContrailWatch ของ ContrailExplorer โดยจะแสดงเส้นทางการบินที่ตรงกับคอนเทรลที่ดาวเทียมตรวจพบ

จะป้อนข้อมูลสำหรับเที่ยวบินที่พบเมื่อใช้มุมมอง ATTRIBUTION_VIEW_OBSERVATION เท่านั้น

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

วันที่ออกเดินทางในเขตเวลาของสนามบินต้นทางในรูปแบบ YYYYMMDD
icao24

string

ที่อยู่เครื่องบินแบบ 24 บิตของ ICAO
originAirport

string

รหัสสนามบินต้นทางของ IATA
destinationAirport

string

รหัสสนามบินปลายทาง IATA
callSign

string

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

integer

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

ContrailAttributes

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

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

integer

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

string (int64 format)

พลังงานที่เกิดจากคอนเทรลที่มีประสิทธิภาพทั้งหมดในหน่วยจูล ค่านี้ได้มาจากการดึงข้อมูลการบังคับแผ่รังสีที่มีประสิทธิภาพจากเอาต์พุตการคาดการณ์ CoCiP แบบตารางกริด 4 มิติและทำการประมาณค่าในช่วงเชิงเส้น วิธีการนี้อาจมีการเปลี่ยนแปลง

SegmentAttribution

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

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

string (Timestamp format)

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

string (Timestamp format)

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

object (ContrailAttributes)

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

object (ContrailDetectionEvidence)

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

enum (AttributionMethod)

เอาต์พุตเท่านั้น วิธีการที่ใช้ในการระบุแหล่งที่มาของเมฆหางเครื่องบินในส่วนนี้ (เช่น โมเดล CoCiP หรือการสังเกตโดยตรง)
longGapInterpolation

boolean

เอาต์พุตเท่านั้น เป็นจริงหากเส้นทางการบินของเซ็กเมนต์สร้างขึ้นโดยการประมาณค่าในช่วงข้อมูล ADS-B ที่ขาดหายไปเป็นเวลานาน (>5 นาที)
waypointAttributions[]

object (WaypointAttribution)

เอาต์พุตเท่านั้น แอตทริบิวต์คอนเทรลต่อจุดอ้างอิงที่แมปในส่วนนี้

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

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

ในบรรดาเอาต์พุตข้อมูลดาวเทียมที่มีอยู่ การระบุแหล่งที่มาตาม GOES East และ Himawari มีคุณภาพระดับการผลิต ส่วนการระบุแหล่งที่มาตาม MTG ยังอยู่ในระยะเบต้าและอยู่ระหว่างการปรับปรุงคุณภาพอย่างต่อเนื่อง

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

ภาพถ่ายจากดาวเทียมของ Contrails API อิงตามข้อมูลต่อไปนี้

WaypointAttribution

แสดงแอตทริบิวต์คอนเทรลสำหรับจุดอ้างอิงที่เฉพาะเจาะจงในส่วนของเที่ยวบิน

การแสดง JSON 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
ช่อง
time

string (Timestamp format)

เวลาที่จุดอ้างอิงในหน่วยวินาที Epoch ของ UTC
contrailAttributes

object (ContrailAttributes)

แอตทริบิวต์คอนเทรลที่แมปที่จุดอ้างอิงที่เฉพาะเจาะจงนี้

AttributionMethod

กำหนดขั้นตอนหรือวิธีการเฉพาะที่ใช้ในการระบุแหล่งที่มา

Enum
ATTRIBUTION_METHOD_OBSERVATION การระบุแหล่งที่มาได้มาจากการจับคู่กับการตรวจจับคอนเทรลจากดาวเทียมอย่างเคร่งครัด
ATTRIBUTION_METHOD_COCIP การระบุแหล่งที่มาที่อาศัยโมเดล CoCiP ที่อิงตามหลักฟิสิกส์อย่างเคร่งครัด
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

การระบุแหล่งที่มาแบบผสมผสานที่รวมการคาดการณ์โมเดล CoCiP ที่ปรับตามการตรวจจับด้วยดาวเทียม

  • มีการตรวจจับ: หากมี detectionEvidences แสดงว่ามีการคาดการณ์เมฆหางเครื่องบินและยืนยันโดยการสังเกตการณ์ โดยได้รับน้ำหนักการอุ่นขึ้นที่เพิ่มขึ้น
  • ไม่มีการตรวจจับ: หากไม่มี detectionEvidences แสดงว่ามีการคาดการณ์เมฆหางเครื่องบินแต่ไม่พบ จึงมีการหักลบภาวะโลกร้อนที่คำนวณได้
ATTRIBUTION_METHOD_UNSPECIFIED วิธีการที่ไม่ได้ระบุ

หมายเหตุ

DataSource แต่ละรายการใช้ขอบเขตที่แตกต่างกันในการประมวลผลการดูตามการสังเกตการณ์ ดังนี้

กรอบล้อมรอบความครอบคลุมของดาวเทียม (มุมมอง Mercator แบบแบน)

ใบอนุญาต

ข้อมูลที่เปิดเผยโดย ContrailWatch Attributions API ได้รับอนุญาตภายใต้ CC BY-NC 4.0