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)

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

วันที่

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

  • วันที่แบบเต็ม โดยมีค่าปี เดือน และวันที่ที่ไม่ใช่ 0
  • เดือนและวัน โดยมีปีเป็น 0 (เช่น วันครบรอบ)
  • ปีอย่างเดียว โดยมีเดือนและวันที่เป็น 0
  • ปีและเดือน โดยมีวันที่เป็น 0 (เช่น วันหมดอายุของบัตรเครดิต)

ประเภทที่เกี่ยวข้อง

การแสดง JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
ช่อง
year

integer

ปีของวันที่ ต้องอยู่ระหว่าง 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่โดยไม่มีปี
month

integer

เดือนของปี ต้องมีค่าระหว่าง 1 ถึง 12 หรือ 0 เพื่อระบุปีโดยไม่มีเดือนและวัน
day

integer

วันของเดือน ต้องมีค่าตั้งแต่ 1 ถึง 31 และใช้ได้กับปีและเดือน หรือ 0 เพื่อระบุปีอย่างเดียว หรือปีและเดือนที่ไม่มีวัน

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 ทั้งหมด