Method: flights.computeFlightEmissions

วิธีการแบบไม่เก็บสถานะเพื่อดึงข้อมูลการประมาณการปล่อยก๊าซ ดูรายละเอียดเกี่ยวกับวิธีคำนวณปริมาณการปล่อยก๊าซโดยประมาณได้ใน GitHub

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

  • เซิร์ฟเวอร์ไม่รู้จักเที่ยวบิน
  • ขาเที่ยวที่ป้อนไม่มีตัวระบุอย่างน้อย 1 รายการ
  • วันที่ของเที่ยวบินเป็นวันที่ที่ผ่านมาแล้ว
  • โมเดลไม่รองรับเครื่องบินประเภทนี้
  • ไม่มีการกำหนดค่าที่นั่ง

คำขอมีขาเที่ยวบินได้สูงสุด 1,000 ขา หากคำขอมีเที่ยวบินตรงมากกว่า 1, 000 เที่ยว ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT

คำขอ HTTP

POST https://travelimpactmodel.googleapis.com/v1/flights:computeFlightEmissions

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

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

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

การแสดง JSON 
{
  "flights": [
    {
      object (Flight)
    }
  ]
}
ฟิลด์
flights[]

object (Flight)

ต้องระบุ เที่ยวบินตรงเพื่อดูปริมาณการปล่อยก๊าซโดยประมาณของเที่ยวบินไปกลับ

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

คำจำกัดความเอาต์พุตสำหรับการตอบกลับ flights.computeFlightEmissions

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

การแสดง JSON 
{
  "flightEmissions": [
    {
      object (FlightWithEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
ช่อง
flightEmissions[]

object (FlightWithEmissions)

รายการช่วงเที่ยวบินที่มีปริมาณการปล่อยก๊าซโดยประมาณ
modelVersion

object (ModelVersion)

เวอร์ชันโมเดลที่ใช้ในการคำนวณปริมาณการปล่อยก๊าซโดยประมาณของเที่ยวบินทั้งหมดในคำตอบนี้

Flights

รายละเอียดทั้งหมดที่เกี่ยวข้องกับรายการคำขอเดียวสำหรับปริมาณการปล่อยก๊าซโดยประมาณของเที่ยวบินตรง

การแสดง JSON 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
ฟิลด์
origin

string

ต้องระบุ รหัสสนามบิน IATA สำหรับต้นทางของเที่ยวบิน เช่น "LHR"
destination

string

ต้องระบุ รหัสสนามบิน IATA สำหรับจุดหมายปลายทางของเที่ยวบิน เช่น "JFK"
operatingCarrierCode

string

ต้องระบุ รหัสสายการบิน IATA เช่น "AA"
flightNumber

integer

ต้องระบุ หมายเลขเที่ยวบิน เช่น 324
departureDate

object (Date)

ต้องระบุ วันที่ของเที่ยวบินในเขตเวลาของสนามบินต้นทาง ต้องเป็นวันที่ในปัจจุบันหรืออนาคต

FlightWithEmissions

เที่ยวบินตรงที่มีปริมาณการปล่อยก๊าซโดยประมาณ

การแสดง JSON 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
ฟิลด์
flight

object (Flight)

ต้องระบุ ตรงกับตัวระบุเที่ยวบินในคำขอ หมายเหตุ: รหัส IATA ทั้งหมดจะเป็นตัวพิมพ์ใหญ่
source

enum (Source)

ไม่บังคับ แหล่งที่มาของข้อมูลการปล่อยก๊าซ
emissionsGramsPerPax

object (EmissionsGramsPerPax)

ไม่บังคับ ตัวเลขปริมาณการปล่อยก๊าซโดยประมาณต่อผู้โดยสาร จะไม่มีค่าหากคำนวณการปล่อยก๊าซคาร์บอนไม่ได้ ดูรายการเหตุผลที่คำนวณการปล่อยก๊าซคาร์บอนไม่ได้ที่ flights.computeFlightEmissions
easaLabelMetadata

object (EasaLabelMetadata)

ไม่บังคับ ข้อมูลเมตาเกี่ยวกับป้ายกำกับการปล่อยก๊าซของเที่ยวบินจาก EASA ตั้งค่าเมื่อแหล่งข้อมูลการปล่อยก๊าซเรือนกระจกเป็น EASA เท่านั้น
contrailsImpactBucket

enum (ContrailsImpactBucket)

ไม่บังคับ ความสำคัญของผลกระทบต่อภาวะโลกร้อนจากคอนเทรลเมื่อเทียบกับผลกระทบจากการปล่อยก๊าซ CO2e ทั้งหมด

แหล่งที่มา

แหล่งที่มาของข้อมูลการปล่อยก๊าซ

Enum
SOURCE_UNSPECIFIED ไม่ได้ระบุแหล่งที่มาของข้อมูลการปล่อยก๊าซคาร์บอน
TIM ข้อมูลการปล่อยก๊าซมาจาก Travel Impact Model
EASA ข้อมูลการปล่อยก๊าซมาจากฉลากสิ่งแวดล้อมของ EASA

EasaLabelMetadata

ข้อมูลเมตาเกี่ยวกับป้ายกำกับการปล่อยก๊าซของเที่ยวบินจาก EASA

การแสดง JSON 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
ช่อง
labelIssueDate

object (Date)

วันที่ออกป้ายกำกับ
labelExpiryDate

object (Date)

วันที่ป้ายกำกับหมดอายุ ป้ายกำกับจะแสดงได้จนถึงวันที่สิ้นสุด
labelVersion

string

เวอร์ชันของป้ายกำกับ
safDiscountPercentage

number

เปอร์เซ็นต์ส่วนลดการปล่อยก๊าซจากเชื้อเพลิงอากาศยานยั่งยืน (SAF) ที่ใช้กับป้ายกำกับ โดยเป็นเปอร์เซ็นต์ในรูปแบบทศนิยม ค่าจะอยู่ในช่วง [0,1] เช่น 0.0021 หมายถึง 0.21%

ส่วนลดและการลดการปล่อยก๊าซนี้รายงานโดยป้ายกำกับ EASA แต่ไม่ได้รวมอยู่ในค่าประมาณ CO2e ที่ API นี้เผยแพร่

ContrailsImpactBucket

ความสำคัญของผลกระทบต่อภาวะโลกร้อนจากคอนเทรลเมื่อเทียบกับผลกระทบจากการปล่อยก๊าซ CO2e ทั้งหมด

Enum
CONTRAILS_IMPACT_UNSPECIFIED ไม่ได้ระบุผลกระทบของคอนเทรล
CONTRAILS_IMPACT_NEGLIGIBLE ผลกระทบจากคอนเทรลนั้นน้อยมากเมื่อเทียบกับการปล่อยก๊าซ CO2e ทั้งหมด
CONTRAILS_IMPACT_MODERATE ผลกระทบจากคอนเทรลเทียบเท่ากับการปล่อยก๊าซ CO2e ทั้งหมด
CONTRAILS_IMPACT_SEVERE ผลกระทบจากคอนเทรลสูงกว่าผลกระทบจากการปล่อยก๊าซ CO2e ทั้งหมด