Method: flights.computeScope3FlightEmissions

ดึงข้อมูลค่าประมาณการปล่อยก๊าซเรือนกระจกสำหรับชุดเที่ยวบินเพื่อการรายงานขอบเขตที่ 3

การตอบกลับจะมีรายการทั้งหมดที่ตรงกับเที่ยวบิน Scope3FlightSegment ส่วนที่ป้อนเข้ามา โดยเรียงตามลำดับที่ระบุไว้ ระบบจะคำนวณค่าประมาณโดยใช้ตรรกะแบบเรียงซ้อนต่อไปนี้ (โดยใช้ค่าแรกที่ใช้ได้)

  1. การปล่อยก๊าซตาม TIM โดยพิจารณาจากorigin, destination, carrier, flightNumber, departureDate และcabinClass
  2. การปล่อยก๊าซตามปกติของเที่ยวบินเมื่อพิจารณาจากorigin destination ปีในdepartureDate และcabinClass
  3. การปล่อยก๊าซตามระยะทางที่คำนวณโดยใช้ distanceKm, ปีใน departureDate และ cabinClass

หากมีการขอเที่ยวบินในอนาคตในปีปฏิทินนี้ เราจะไม่รองรับการปล่อยก๊าซระดับที่ 1 และจะเปลี่ยนไปใช้การปล่อยก๊าซระดับที่ 2 หรือ 3 หากเที่ยวบินในอนาคตที่ขอไม่ได้อยู่ในปีปฏิทินนี้ เราจะแสดงการตอบกลับที่ว่างเปล่า เราขอแนะนำให้ใช้ computeFlightEmissions API แทนสำหรับเที่ยวบินในอนาคต

หากไม่มีค่าประมาณสำหรับเที่ยวบินหนึ่งๆ ด้วยวิธีใดวิธีหนึ่งจาก 3 วิธี การตอบกลับจะแสดงออบเจ็กต์ Scope3FlightEmissions ที่มีช่องการปล่อยก๊าซว่างเปล่า ระบบจะยังคงถือว่าคำขอดังกล่าวสำเร็จ โดยทั่วไปแล้ว การประมาณการปล่อยก๊าซที่ขาดหายไปจะเกิดขึ้นเมื่อเซิร์ฟเวอร์ไม่รู้จักเที่ยวบิน (เช่น ไม่มีเที่ยวบินที่เฉพาะเจาะจง หรือไม่มีข้อมูลการปล่อยก๊าซของเที่ยวบินปกติสำหรับคู่เที่ยวบินที่ขอ)

คำขอจะดำเนินการไม่สำเร็จและแสดงข้อผิดพลาด INVALID_ARGUMENT ในกรณีต่อไปนี้

  • คำขอมีเที่ยวบินมากกว่า 1,000 เที่ยว
  • เที่ยวบินที่ป้อนไม่มีตัวระบุอย่างน้อย 1 รายการ เช่น ไม่มีต้นทาง/ปลายทางที่ไม่มีระยะทางที่ถูกต้องสำหรับการจับคู่ประเภท TIM_EMISSIONS หรือ TYPICAL_FLIGHT_EMISSIONS หรือไม่มีระยะทางสำหรับการจับคู่ประเภท DISTANCE_BASED_EMISSIONS (หากต้องการใช้การปล่อยก๊าซตามระยะทางหรือต้องการค่าประมาณการปล่อยก๊าซตามระยะทาง คุณต้องระบุระยะทาง)
  • วันที่ของเที่ยวบินอยู่ก่อนปี 2019 (ข้อมูลขอบเขตที่ 3 มีเฉพาะสำหรับปี 2019 เป็นต้นไป)
  • ระยะทางของเที่ยวบินเป็น 0 หรือต่ำกว่า
  • ไม่มีชั้นที่นั่งโดยสาร

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

คำขอ HTTP

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

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

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

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

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

object (Scope3FlightSegment)

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

object (ModelVersion)

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

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

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

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

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

object (Scope3FlightEmissions)

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

object (ModelVersion)

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

Scope3FlightSegment

พารามิเตอร์เที่ยวบินที่ใช้ดึงข้อมูลการปล่อยก๊าซในขอบเขตที่ 3

การแสดง JSON 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (Scope3FlightSegment.CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
ช่อง
departureDate

object (Date)

ต้องระบุ วันที่ของเที่ยวบินในเขตเวลาของสนามบินต้นทาง ต้องระบุปีเท่านั้นสำหรับโมเดลการปล่อยก๊าซของเที่ยวบินปกติและโมเดลการปล่อยก๊าซตามระยะทาง (ระบบจะไม่สนใจค่าเดือนและวัน ดังนั้นจึงสามารถละเว้น ตั้งค่าเป็น 0 หรือตั้งค่าเป็นวันที่ที่ถูกต้องสำหรับกรณีเหล่านั้นได้) ในทำนองเดียวกัน หากไม่มีการระบุวันที่ที่เจาะจงสำหรับการปล่อยก๊าซตาม TIM เราจะเปลี่ยนไปใช้การปล่อยก๊าซของเที่ยวบินทั่วไป (หรือตามระยะทาง)
cabinClass

enum (Scope3FlightSegment.CabinClass)

ต้องระบุ ชั้นที่นั่งโดยสารของเที่ยวบิน
origin

string

ไม่บังคับ รหัสสนามบิน IATA 3 อักขระสำหรับต้นทางของเที่ยวบิน เช่น YVR ระบบจะใช้ข้อมูลนี้เพื่อจับคู่เที่ยวบินที่เฉพาะเจาะจงหากระบุไว้พร้อมกับปลายทาง ผู้ให้บริการ และหมายเลขเที่ยวบิน หากไม่มีเที่ยวบินที่ตรงกัน เราจะพยายามจับคู่เที่ยวบินกับเที่ยวบินทั่วไปที่เดินทางระหว่างสนามบินต้นทางและปลายทางที่ระบุก่อน ไม่เช่นนั้น เราจะใช้รูปแบบการปล่อยก๊าซตามระยะทางหากมีการระบุระยะทางของเที่ยวบิน
destination

string

ไม่บังคับ รหัสสนามบิน IATA 3 อักขระสำหรับจุดหมายปลายทางของเที่ยวบิน เช่น ICN ระบบจะใช้ข้อมูลนี้เพื่อจับคู่เที่ยวบินที่เฉพาะเจาะจงหากระบุไว้พร้อมกับต้นทาง ผู้ให้บริการ และหมายเลขเที่ยวบิน หากไม่มีเที่ยวบินที่ตรงกัน เราจะพยายามจับคู่เที่ยวบินกับเที่ยวบินทั่วไปที่เดินทางระหว่างสนามบินต้นทางและปลายทางที่ระบุก่อน ไม่เช่นนั้น เราจะใช้รูปแบบการปล่อยก๊าซตามระยะทางหากมีการระบุระยะทางของเที่ยวบิน
carrierCode

string

ไม่บังคับ รหัสผู้ให้บริการ IATA 2 อักขระ เช่น KE คุณต้องระบุข้อมูลนี้หากต้องการให้มีการจับคู่เที่ยวบินที่เฉพาะเจาะจง ไม่เช่นนั้น ระบบจะไม่ใช้ข้อมูลนี้สำหรับโมเดลการปล่อยก๊าซตามเที่ยวบินและระยะทางทั่วไป ซึ่งอาจเป็นทั้งรหัสผู้ให้บริการที่ดำเนินการและผู้ให้บริการด้านการตลาด (เช่น ครอบคลุมเที่ยวบินร่วม)
flightNumber

integer

ไม่บังคับ หมายเลขเที่ยวบินสูงสุด 4 หลัก เช่น 71 ตั้งแต่ [1, 9999] ระบบจะใช้ข้อมูลนี้ก่อนเพื่อจับคู่เที่ยวบินที่เฉพาะเจาะจง หากมีการระบุหมายเลขเที่ยวบินพร้อมกับต้นทาง ปลายทาง และผู้ให้บริการ หากไม่ได้ระบุหมายเลขเที่ยวบิน เราจะพยายามจับคู่เที่ยวบินกับเที่ยวบินทั่วไปที่เดินทางระหว่างสนามบินต้นทางและสนามบินปลายทางที่ระบุก่อน หากไม่สำเร็จและ/หรือไม่ได้ระบุต้นทางและปลายทาง เราจะใช้โมเดลการปล่อยก๊าซตามระยะทางโดยอิงตามระยะทางของเที่ยวบินที่ระบุ
distanceKm

string (int64 format)

ไม่บังคับ ระยะทางเป็นกิโลเมตร เช่น 2423 จาก [1, 1e12) กม. ใช้เพื่อจับคู่เที่ยวบินกับการปล่อยก๊าซตามระยะทางเมื่อไม่ได้ระบุต้นทางและปลายทาง หรือไม่มีเที่ยวบินทั่วไปที่ตรงกัน

Scope3FlightSegment.CabinClass

ชั้นที่นั่งโดยสารของเที่ยวบิน

Enum
CABIN_CLASS_UNSPECIFIED ไม่ได้ระบุชั้นที่นั่งโดยสาร
ECONOMY ชั้นประหยัด
PREMIUM_ECONOMY ชั้นประหยัดพรีเมียม
BUSINESS ชั้นธุรกิจ
FIRST ชั้นหนึ่ง

Scope3FlightEmissions

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

การแสดง JSON 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3FlightEmissions.Scope3DataType),
  "modelVersion": string
}
ช่อง
flight

object (Scope3FlightSegment)

ตัวระบุ ตรงกับตัวระบุเที่ยวบินในคำขอ
wtwEmissionsGramsPerPax

string (int64 format)

ไม่บังคับ การปล่อยก๊าซทั้งหมดของเที่ยวบิน (ผลรวมของ Well-to-Tank และ Tank-to-Wake) ต่อผู้โดยสารตามข้อมูลที่ขอ ซึ่งเป็นการปล่อยก๊าซทั้งหมด และคุณควรใช้ตัวเลขนี้ เว้นแต่จะมีเหตุผลเฉพาะในการใช้การปล่อยก๊าซ TTW หรือ WTT
ttwEmissionsGramsPerPax

string (int64 format)

ไม่บังคับ การปล่อยก๊าซจากเที่ยวบินแบบ Tank-to-Wake ต่อผู้โดยสาร 1 คนตามข้อมูลที่ขอ
wttEmissionsGramsPerPax

string (int64 format)

ไม่บังคับ การปล่อยก๊าซจากเที่ยวบินแบบ Well-to-Tank ต่อผู้โดยสาร 1 คนตามข้อมูลที่ขอ
source

enum (Scope3FlightEmissions.Scope3DataType)

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

string

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

Scope3FlightEmissions.Scope3DataType

ประเภทการจับคู่ที่ใช้ในการคำนวณการปล่อยก๊าซในขอบเขตที่ 3 ซึ่งจะใช้สำหรับการตอบกลับขอบเขตที่ 3 โดยระบุวิธีการที่ใช้ในการคำนวณการปล่อยก๊าซ

Enum
SCOPE3_DATA_TYPE_UNSPECIFIED ประเภทข้อมูลที่ไม่ระบุ
TIM_EMISSIONS การปล่อยก๊าซตาม TIM โดยอิงตามต้นทาง ปลายทาง สายการบิน หมายเลขเที่ยวบิน วันที่ออกเดินทาง และปี
TYPICAL_FLIGHT_EMISSIONS ปริมาณการปล่อยก๊าซของเที่ยวบินปกติโดยพิจารณาจากต้นทาง จุดหมาย และปี
DISTANCE_BASED_EMISSIONS การปล่อยก๊าซตามระยะทางโดยอิงตามระยะทางที่เดินทางและปี