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 (CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
ฟิลด์
departureDate

object (Date)

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

enum (CabinClass)

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

string

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

string

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

string

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

integer

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

string (int64 format)

ไม่บังคับ ระยะทางเป็นกิโลเมตร เช่น 2423 ซึ่งใช้เพื่อจับคู่เที่ยวบินกับการปล่อยก๊าซตามระยะทางเมื่อไม่ได้ระบุต้นทางและปลายทาง หรือไม่มีเที่ยวบินปกติที่ตรงกัน ฟิลด์นี้รองรับค่าระหว่าง 0 ถึง 2.5e16 กม.

CabinClass

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

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

Scope3FlightEmissions

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

การแสดง JSON 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3DataType)
}
ฟิลด์
flight

object (Scope3FlightSegment)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

enum (Scope3DataType)

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

Scope3DataType

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

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