ดัชนี
TravelImpactModelService
(อินเทอร์เฟซ)ComputeFlightEmissionsRequest
(ข้อความ)ComputeFlightEmissionsResponse
(ข้อความ)ComputeScope3FlightEmissionsRequest
(ข้อความ)ComputeScope3FlightEmissionsResponse
(ข้อความ)ComputeTypicalFlightEmissionsRequest
(ข้อความ)ComputeTypicalFlightEmissionsResponse
(ข้อความ)ContrailsImpactBucket
(enum)EasaLabelMetadata
(ข้อความ)EmissionsGramsPerPax
(ข้อความ)Flight
(ข้อความ)FlightWithEmissions
(ข้อความ)Market
(ข้อความ)ModelVersion
(ข้อความ)Scope3FlightEmissions
(ข้อความ)Scope3FlightEmissions.Scope3DataType
(enum)Scope3FlightSegment
(ข้อความ)Scope3FlightSegment.CabinClass
(enum)Source
(enum)TypicalFlightEmissions
(ข้อความ)
TravelImpactModelService
API สำหรับการประมาณปริมาณการปล่อยก๊าซคาร์บอน
ComputeFlightEmissions |
---|
วิธีการแบบไม่เก็บสถานะเพื่อดึงข้อมูลการประมาณการปล่อยก๊าซ ดูรายละเอียดเกี่ยวกับวิธีคำนวณปริมาณการปล่อยก๊าซโดยประมาณได้ใน GitHub การตอบกลับจะมีรายการทั้งหมดที่ตรงกับขาเที่ยวบินที่ป้อนตามลำดับเดียวกัน หากไม่มีการประมาณค่าสำหรับช่วงเที่ยวบินหนึ่งๆ การตอบกลับจะแสดงออบเจ็กต์ช่วงเที่ยวบินที่มีช่องการปล่อยก๊าซว่างเปล่า แต่ระบบจะยังถือว่าคำขอสำเร็จ สาเหตุที่ไม่มีการประมาณการปล่อยก๊าซ ได้แก่
คำขอมีขาเที่ยวบินได้สูงสุด 1,000 ขา หากคำขอมีเที่ยวบินตรงมากกว่า 1, 000 เที่ยว ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT |
ComputeScope3FlightEmissions |
---|
วิธีการแบบไม่เก็บสถานะเพื่อดึงข้อมูลประมาณการปล่อยก๊าซเรือนกระจกสำหรับชุดกลุ่มเที่ยวบินเพื่อการรายงานขอบเขตที่ 3 การตอบกลับจะมีรายการทั้งหมดที่ตรงกับ
หากมีการขอการแสดงโฆษณาในอนาคตในปีปฏิทินนี้ เราจะไม่รองรับการปล่อยก๊าซเรือนกระจกชั้นที่ 1 และจะเปลี่ยนไปใช้การปล่อยก๊าซเรือนกระจกชั้นที่ 2 หรือ 3 หากเที่ยวบินในอนาคตที่ขอไม่ได้อยู่ในปีปฏิทินนี้ เราจะแสดงการตอบกลับที่ว่างเปล่า เราขอแนะนำให้ใช้ หากไม่มีการประมาณการสำหรับเที่ยวบินหนึ่งๆ ด้วยวิธีการใดวิธีการหนึ่งใน 3 วิธี การตอบกลับจะแสดงออบเจ็กต์ คำขอจะล้มเหลวและแสดงข้อผิดพลาด
เนื่องจากคำขอได้รับการประมวลผลด้วยตรรกะสำรอง คำขอที่กำหนดค่าไม่ถูกต้องจึงอาจแสดงค่าประมาณการปล่อยก๊าซที่ถูกต้องโดยใช้วิธีสำรอง ตัวอย่างเช่น หากคำขอมีหมายเลขเที่ยวบินที่ไม่ถูกต้อง แต่ระบุต้นทางและปลายทาง คำขอจะยังคงสำเร็จ แต่การปล่อยก๊าซที่แสดงจะอิงตามการปล่อยก๊าซของเที่ยวบินทั่วไปเท่านั้น ในทำนองเดียวกัน หากคำขอไม่มีต้นทางสำหรับคำขอการปล่อยก๊าซเรือนกระจกของเที่ยวบินทั่วไป แต่ระบุระยะทางที่ถูกต้อง คำขออาจสำเร็จโดยอิงตามการปล่อยก๊าซเรือนกระจกตามระยะทางเท่านั้น ดังนั้น คุณควรตรวจสอบแหล่งที่มาของการปล่อยก๊าซที่แสดง ( |
ComputeTypicalFlightEmissions |
---|
ดึงข้อมูลการประมาณปริมาณการปล่อยก๊าซของเที่ยวบินปกติระหว่างสนามบิน 2 แห่ง หรือที่เรียกว่าตลาด หากไม่มีการประมาณการสำหรับตลาดหนึ่งๆ การตอบกลับจะแสดงออบเจ็กต์ตลาดที่มีฟิลด์การปล่อยก๊าซเรือนกระจกที่ว่างเปล่า แต่ระบบจะยังถือว่าคำขอสำเร็จ ดูรายละเอียดเกี่ยวกับวิธีคำนวณค่าประมาณปริมาณการปล่อยก๊าซปกติได้ที่ GitHub คำขอมีตลาดได้สูงสุด 1,000 แห่ง หากคำขอมีตลาดมากกว่า 1, 000 แห่ง คำขอจะล้มเหลวโดยมีข้อผิดพลาด INVALID_ARGUMENT |
ComputeFlightEmissionsRequest
คำจำกัดความของอินพุตสำหรับคำขอ ComputeFlightEmissions
ช่อง | |
---|---|
flights[] |
ต้องระบุ เที่ยวบินตรงเพื่อดูปริมาณการปล่อยก๊าซโดยประมาณของเที่ยวบินไปกลับ |
ComputeFlightEmissionsResponse
คำจำกัดความเอาต์พุตสำหรับการตอบกลับ ComputeFlightEmissions
ช่อง | |
---|---|
flight_emissions[] |
รายการช่วงเที่ยวบินที่มีปริมาณการปล่อยก๊าซโดยประมาณ |
model_version |
เวอร์ชันโมเดลที่ใช้ในการคำนวณปริมาณการปล่อยก๊าซโดยประมาณของเที่ยวบินทั้งหมดในคำตอบนี้ |
ComputeScope3FlightEmissionsRequest
รายการกลุ่มเที่ยวบินที่จะขอการปล่อยก๊าซเรือนกระจกขอบเขตที่ 3
ช่อง | |
---|---|
flights[] |
ต้องระบุ เที่ยวบินที่จะแสดงปริมาณการปล่อยก๊าซโดยประมาณ |
model_version |
ไม่บังคับ เวอร์ชันโมเดลที่ใช้ในการคำนวณปริมาณการปล่อยก๊าซโดยประมาณของเที่ยวบินทั้งหมดในคำขอนี้ |
ComputeScope3FlightEmissionsResponse
รายการเที่ยวบินที่มีการประมาณการปล่อยก๊าซเรือนกระจกขอบเขตที่ 3
ช่อง | |
---|---|
flight_emissions[] |
รายการช่วงเที่ยวบินที่มีปริมาณการปล่อยก๊าซโดยประมาณ |
model_version |
เวอร์ชันโมเดลที่ใช้ในการคำนวณปริมาณการปล่อยก๊าซโดยประมาณของเที่ยวบินทั้งหมดในคำตอบนี้ |
ComputeTypicalFlightEmissionsRequest
รายการคู่สนามบิน (ตลาด) ที่จะขอข้อมูลการปล่อยก๊าซเรือนกระจกโดยทั่วไป
ช่อง | |
---|---|
markets[] |
ต้องระบุ ขอปริมาณการปล่อยก๊าซโดยประมาณของเที่ยวบินปกติสำหรับคู่ตลาดนี้ ขอได้สูงสุด 1,000 ตลาด |
ComputeTypicalFlightEmissionsResponse
การตอบกลับจะรวมถึงการปล่อยก๊าซเรือนกระจกและเวอร์ชันโมเดลด้วย
ช่อง | |
---|---|
typical_flight_emissions[] |
ขอปริมาณการปล่อยก๊าซของเที่ยวบินปกติของตลาด |
model_version |
เวอร์ชันโมเดลที่ใช้ในการคำนวณค่าประมาณปริมาณการปล่อยก๊าซของเที่ยวบินปกติสำหรับเที่ยวบินทั้งหมดในคำตอบนี้ |
ContrailsImpactBucket
ความสำคัญของผลกระทบต่อภาวะโลกร้อนจากคอนเทรลเมื่อเทียบกับผลกระทบจากการปล่อยก๊าซ CO2e ทั้งหมด
Enum | |
---|---|
CONTRAILS_IMPACT_UNSPECIFIED |
ไม่ได้ระบุผลกระทบของคอนเทรล |
CONTRAILS_IMPACT_NEGLIGIBLE |
ผลกระทบจากคอนเทรลนั้นน้อยมากเมื่อเทียบกับการปล่อยก๊าซ CO2e ทั้งหมด |
CONTRAILS_IMPACT_MODERATE |
ผลกระทบจากคอนเทรลเทียบเท่ากับการปล่อยก๊าซ CO2e ทั้งหมด |
CONTRAILS_IMPACT_SEVERE |
ผลกระทบจากคอนเทรลสูงกว่าผลกระทบจากการปล่อยก๊าซ CO2e ทั้งหมด |
EasaLabelMetadata
ข้อมูลเมตาเกี่ยวกับป้ายกำกับการปล่อยก๊าซของเที่ยวบินจาก EASA
ช่อง | |
---|---|
label_issue_date |
วันที่ออกป้ายกำกับ |
label_expiry_date |
วันที่ป้ายกำกับหมดอายุ ป้ายกำกับจะแสดงได้จนถึงวันที่สิ้นสุด |
label_version |
เวอร์ชันของป้ายกำกับ |
saf_discount_percentage |
เปอร์เซ็นต์ส่วนลดการปล่อยก๊าซจากเชื้อเพลิงอากาศยานยั่งยืน (SAF) ที่ใช้กับป้ายกำกับ โดยเป็นเปอร์เซ็นต์ในรูปแบบทศนิยม ค่าจะอยู่ในช่วง [0,1] เช่น 0.0021 หมายถึง 0.21% ส่วนลดและการลดการปล่อยก๊าซนี้รายงานโดยป้ายกำกับ EASA แต่ไม่ได้รวมอยู่ในค่าประมาณ CO2e ที่ API นี้เผยแพร่ |
EmissionsGramsPerPax
ผลลัพธ์ของปริมาณการปล่อยก๊าซที่จัดกลุ่มตามชั้นโดยสาร
ช่อง | |
---|---|
first |
ปริมาณการปล่อยก๊าซต่อผู้โดยสาร 1 คนในชั้นหนึ่งเป็นกรัม ระบบจะคำนวณและระบุค่าในช่องนี้เสมอ ไม่ว่าเครื่องบินจะมีที่นั่งชั้นหนึ่งหรือไม่ก็ตาม |
business |
ปริมาณการปล่อยก๊าซต่อผู้โดยสาร 1 คนในชั้นธุรกิจเป็นกรัม ระบบจะคำนวณและป้อนข้อมูลในช่องนี้เสมอ ไม่ว่าเครื่องบินจะมีที่นั่งชั้นธุรกิจหรือไม่ก็ตาม |
premium_economy |
ปริมาณการปล่อยก๊าซต่อผู้โดยสาร 1 คนในชั้นประหยัดพรีเมียมเป็นกรัม ระบบจะคำนวณและระบุค่าในช่องนี้เสมอ ไม่ว่าเครื่องบินจะมีที่นั่งชั้นประหยัดพรีเมียมหรือไม่ก็ตาม |
economy |
ปริมาณการปล่อยก๊าซต่อผู้โดยสาร 1 คนในชั้นประหยัดเป็นกรัม ระบบจะคำนวณและระบุค่าในช่องนี้เสมอ ไม่ว่าเครื่องบินจะมีที่นั่งชั้นประหยัดหรือไม่ก็ตาม |
Flights
รายละเอียดทั้งหมดที่เกี่ยวข้องกับรายการคำขอเดียวสำหรับปริมาณการปล่อยก๊าซโดยประมาณของเที่ยวบินตรง
ช่อง | |
---|---|
origin |
ต้องระบุ รหัสสนามบิน IATA สำหรับต้นทางของเที่ยวบิน เช่น "LHR" |
destination |
ต้องระบุ รหัสสนามบิน IATA สำหรับจุดหมายปลายทางของเที่ยวบิน เช่น "JFK" |
operating_carrier_code |
ต้องระบุ รหัสสายการบิน IATA เช่น "AA" |
flight_number |
ต้องระบุ หมายเลขเที่ยวบิน เช่น 324 |
departure_date |
ต้องระบุ วันที่ของเที่ยวบินในเขตเวลาของสนามบินต้นทาง ต้องเป็นวันที่ในปัจจุบันหรืออนาคต |
FlightWithEmissions
เที่ยวบินตรงที่มีปริมาณการปล่อยก๊าซโดยประมาณ
ช่อง | |
---|---|
flight |
ต้องระบุ ตรงกับตัวระบุเที่ยวบินในคำขอ หมายเหตุ: รหัส IATA ทั้งหมดจะเป็นตัวพิมพ์ใหญ่ |
source |
ไม่บังคับ แหล่งที่มาของข้อมูลการปล่อยก๊าซ |
emissions_grams_per_pax |
ไม่บังคับ ตัวเลขปริมาณการปล่อยก๊าซโดยประมาณต่อผู้โดยสาร จะไม่มีค่าหากคำนวณการปล่อยก๊าซคาร์บอนไม่ได้ ดูรายการเหตุผลที่คำนวณการปล่อยก๊าซคาร์บอนไม่ได้ที่ |
easa_label_metadata |
ไม่บังคับ ข้อมูลเมตาเกี่ยวกับป้ายกำกับการปล่อยก๊าซของเที่ยวบินจาก EASA ตั้งค่าเมื่อแหล่งข้อมูลการปล่อยก๊าซเรือนกระจกเป็น EASA เท่านั้น |
contrails_impact_bucket |
ไม่บังคับ ความสำคัญของผลกระทบต่อภาวะโลกร้อนจากคอนเทรลเมื่อเทียบกับผลกระทบจากการปล่อยก๊าซ CO2e ทั้งหมด |
ตลาด
สนามบิน 2 แห่ง
ช่อง | |
---|---|
origin |
ต้องระบุ รหัสสนามบิน IATA สำหรับต้นทางของเที่ยวบิน เช่น "LHR" |
destination |
ต้องระบุ รหัสสนามบิน IATA สำหรับจุดหมายปลายทางของเที่ยวบิน เช่น "JFK" |
ModelVersion
เวอร์ชัน Travel Impact Model ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดเวอร์ชันโมเดลได้ที่ GitHub
ช่อง | |
---|---|
major |
เวอร์ชันหลัก: การเปลี่ยนแปลงที่สำคัญในวิธีการ (เช่น การเพิ่มแหล่งข้อมูลใหม่ลงในโมเดลซึ่งนำไปสู่การเปลี่ยนแปลงเอาต์พุตที่สำคัญ) การเปลี่ยนแปลงดังกล่าวจะเกิดขึ้นไม่บ่อยนักและเราจะประกาศให้ทราบล่วงหน้า อาจเกี่ยวข้องกับการเปลี่ยนแปลงเวอร์ชัน API ซึ่งจะเป็นไปตามหลักเกณฑ์ของ Google Cloud API |
minor |
เวอร์ชันย่อย: การเปลี่ยนแปลงโมเดลที่แม้จะสอดคล้องกันในเวอร์ชันของสคีมา แต่ก็เปลี่ยนพารามิเตอร์หรือการใช้งานของโมเดล |
patch |
เวอร์ชันแพตช์: การเปลี่ยนแปลงการใช้งานที่มีวัตถุประสงค์เพื่อแก้ไขข้อบกพร่องหรือความไม่ถูกต้องในการใช้งานโมเดล |
dated |
เวอร์ชันที่มีวันที่: ชุดข้อมูลโมเดลจะได้รับการสร้างขึ้นใหม่ด้วยข้อมูลอินพุตที่รีเฟรชแล้ว แต่จะไม่มีการเปลี่ยนแปลงอัลกอริทึมเป็นประจำ |
Scope3FlightEmissions
เที่ยวบิน Scope 3 ที่มีปริมาณการปล่อยก๊าซโดยประมาณ
ช่อง | |
---|---|
flight |
ต้องระบุ ตรงกับตัวระบุเที่ยวบินในคำขอ |
wtw_emissions_grams_per_pax |
ไม่บังคับ การปล่อยก๊าซทั้งหมดของเที่ยวบิน (ผลรวมของ Well-to-Tank และ Tank-to-Wake) ต่อผู้โดยสาร 1 คนตามข้อมูลที่ขอ นี่คือการปล่อยก๊าซทั้งหมด และคุณควรใช้ตัวเลขนี้ เว้นแต่จะมีเหตุผลเฉพาะในการใช้การปล่อยก๊าซ TTW หรือ WTT |
ttw_emissions_grams_per_pax |
ไม่บังคับ การปล่อยก๊าซเรือนกระจกจากการบินต่อผู้โดยสาร 1 คนตั้งแต่ต้นทางจนถึงปลายทางโดยอิงตามข้อมูลที่ขอ |
wtt_emissions_grams_per_pax |
ไม่บังคับ การปล่อยก๊าซเรือนกระจกจากการบินแบบ Well-to-Tank ต่อผู้โดยสาร 1 คนโดยอิงตามข้อมูลที่ขอ |
source |
ไม่บังคับ แหล่งที่มาของข้อมูลการปล่อยก๊าซ |
Scope3DataType
ประเภทการจับคู่ที่ใช้ในการคำนวณการปล่อยก๊าซเรือนกระจกขอบเขตที่ 3 ใช้สำหรับการตอบสนองขอบเขตที่ 3 โดยทำเครื่องหมายว่าใช้วิธีใดในการคำนวณการปล่อยก๊าซ
Enum | |
---|---|
SCOPE3_DATA_TYPE_UNSPECIFIED |
ประเภทข้อมูลที่ไม่ได้ระบุ |
TIM_EMISSIONS |
การปล่อยก๊าซตาม TIM เมื่อระบุต้นทาง ปลายทาง ผู้ให้บริการขนส่ง หมายเลขเที่ยวบิน วันที่ออกเดินทาง และปี |
TYPICAL_FLIGHT_EMISSIONS |
ปริมาณการปล่อยก๊าซของเที่ยวบินปกติเมื่อระบุต้นทาง ปลายทาง และปี |
DISTANCE_BASED_EMISSIONS |
การปล่อยก๊าซตามระยะทางโดยอิงตามระยะทางที่เดินทางและปี |
Scope3FlightSegment
พารามิเตอร์เที่ยวบินที่ใช้ดึงข้อมูลการปล่อยก๊าซเรือนกระจกขอบเขตที่ 3
ช่อง | |
---|---|
departure_date |
ต้องระบุ วันที่ของเที่ยวบินในเขตเวลาของสนามบินต้นทาง คุณต้องระบุเฉพาะปีสำหรับรูปแบบการปล่อยก๊าซของเที่ยวบินปกติและรูปแบบการปล่อยก๊าซตามระยะทาง (ระบบจะละเว้นค่าเดือนและวัน ดังนั้นคุณจะละเว้นค่าดังกล่าว ตั้งค่าเป็น 0 หรือตั้งค่าเป็นวันที่ที่ถูกต้องสำหรับกรณีเหล่านั้นก็ได้) ดังนั้น หากไม่มีวันที่เฉพาะเจาะจงสำหรับปริมาณการปล่อยก๊าซของ TIM เราจะใช้ปริมาณการปล่อยก๊าซของเที่ยวบินปกติ (หรือตามระยะทาง) แทน |
cabin_class |
ต้องระบุ ชั้นที่นั่งโดยสารของเที่ยวบิน |
origin |
ไม่บังคับ รหัสสนามบิน IATA สำหรับต้นทางของเที่ยวบิน เช่น |
destination |
ไม่บังคับ รหัสสนามบิน IATA สำหรับจุดหมายปลายทางของเที่ยวบิน เช่น |
carrier_code |
ไม่บังคับ รหัสสายการบิน IATA เช่น |
flight_number |
ไม่บังคับ หมายเลขเที่ยวบิน เช่น |
distance_km |
ไม่บังคับ ระยะทางเป็นกิโลเมตร เช่น |
CabinClass
ชั้นที่นั่งโดยสารของเที่ยวบิน
Enum | |
---|---|
CABIN_CLASS_UNSPECIFIED |
ชั้นที่นั่งโดยสารที่ไม่ได้ระบุ |
ECONOMY |
ชั้นประหยัด |
PREMIUM_ECONOMY |
ชั้นประหยัดพรีเมียม |
BUSINESS |
ชั้นธุรกิจ |
FIRST |
ชั้นหนึ่ง |
แหล่งที่มา
แหล่งที่มาของข้อมูลการปล่อยก๊าซ
Enum | |
---|---|
SOURCE_UNSPECIFIED |
ไม่ได้ระบุแหล่งที่มาของข้อมูลการปล่อยก๊าซคาร์บอน |
TIM |
ข้อมูลการปล่อยก๊าซมาจาก Travel Impact Model |
EASA |
ข้อมูลการปล่อยก๊าซมาจากฉลากสิ่งแวดล้อมของ EASA |
TypicalFlightEmissions
ปริมาณการปล่อยก๊าซโดยประมาณของเที่ยวบินปกติสำหรับตลาดหนึ่งๆ
ช่อง | |
---|---|
market |
ต้องระบุ ตรงกับตัวระบุเที่ยวบินในคำขอ หมายเหตุ: รหัส IATA ทั้งหมดจะเป็นตัวพิมพ์ใหญ่ |
emissions_grams_per_pax |
ไม่บังคับ ปริมาณการปล่อยก๊าซของเที่ยวบินปกติต่อผู้โดยสาร 1 คนสำหรับตลาดที่ขอ จะไม่แสดงหากคำนวณการปล่อยก๊าซคาร์บอนตามปกติไม่ได้ ดูรายการสาเหตุที่คำนวณการปล่อยก๊าซคาร์บอนของเที่ยวบินทั่วไปไม่ได้ได้ที่ GitHub |