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

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

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

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

การแสดง 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 (พร้อมใช้งานตั้งแต่ปี 2024 เป็นต้นไป)
  • {departure_airport}: รหัสสนามบิน IATA 3 ตัวอักษร (เช่น "JFK", "LHR")
flightDetails

object (FlightDetails)

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

object (ContrailAttributes)

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

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

  • หากมี: มีการวิเคราะห์คอนเทรล ฟิลด์ภายใน ContrailAttributes จะระบุผลลัพธ์ (เช่น lengthMeters > 0 หมายความว่ามีการระบุแหล่งที่มาของคอนเทรล) หากมี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

วันที่ออกเดินทางในเขตเวลาของสนามบินต้นทางในรูปแบบ ปปปปดดวว
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)

แอตทริบิวต์ Contrail สำหรับกลุ่มเฉพาะนี้
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แต่ละรายการใช้ขอบเขตที่แตกต่างกันในการประมวลผลการดูตามการสังเกต ดังนี้

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

ใบอนุญาต

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