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 แทน หากเที่ยวบินในอนาคตที่ขอไม่ได้อยู่ในปีปฏิทินนี้ เราจะแสดงการตอบกลับที่ว่างเปล่า เราขอแนะนำให้ใช้ API computeFlightEmissions แทนสำหรับเที่ยวบินในอนาคต

หากไม่มีค่าประมาณสำหรับเที่ยวบินหนึ่งๆ ด้วยวิธีการทั้ง 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, 2.5e16) กม. ระบบจะใช้ระยะทางนี้เพื่อจับคู่เที่ยวบินกับปริมาณการปล่อยก๊าซตามระยะทางเมื่อไม่ได้ระบุต้นทางและปลายทาง หรือไม่มีเที่ยวบินปกติที่ตรงกัน

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)
}
ช่อง
flight

object (Scope3FlightSegment)

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

string (int64 format)

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

string (int64 format)

ไม่บังคับ ปริมาณการปล่อยก๊าซจากการเผาผลาญเชื้อเพลิงของเที่ยวบินต่อผู้โดยสาร 1 คนโดยอิงตามข้อมูลที่ขอ
wttEmissionsGramsPerPax

string (int64 format)

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

enum (Scope3FlightEmissions.Scope3DataType)

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

Scope3FlightEmissions.Scope3DataType

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

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