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

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

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

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

การแสดง 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 หมายถึงมีการระบุว่าเกิดจากคอนเทรล) หากมี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 ที่เฉพาะเจาะจงหรือสัญญาณเรียกขาน 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