- คำขอ HTTP
- เนื้อหาคำขอ
- เนื้อหาการตอบกลับ
- FlightWithDetailedEmissions
- FlightEmissionsDetails
- EmissionsBreakdown
- EmissionsMetadata
- EmissionsProvenance
- EmissionsProvenance.EmissionsProvenanceEntry
- EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType
- EmissionsProvenance.EmissionsProvenanceEntry.DataSource
- EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy
- EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy
- EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy
- EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy
- EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy
- EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy
- EmissionsProvenance.EmissionsProvenanceEntry.DataCategory
- ลองใช้งาน
ดึงข้อมูลปริมาณการปล่อยก๊าซโดยประมาณแบบละเอียด
ปริมาณการปล่อยก๊าซของเที่ยวบินโดยละเอียดจะแสดงการประมาณการปล่อยก๊าซเรือนกระจกต่อผู้โดยสารอย่างโปร่งใส พร้อมด้วยข้อมูลเมตาที่ครอบคลุมซึ่งให้รายละเอียดเกี่ยวกับวิธีการคำนวณ การแบ่งย่อยการปล่อยก๊าซ ผลกระทบของคอนเทรล และแหล่งที่มาของข้อมูล
ดูรายละเอียดเกี่ยวกับวิธีคำนวณปริมาณการปล่อยก๊าซโดยประมาณได้ใน GitHub
การตอบกลับจะมีรายการทั้งหมดที่ตรงกับขาเที่ยวบินที่ป้อนตามลำดับเดียวกัน หากไม่มีการประมาณค่าสำหรับเที่ยวบินบางช่วง การตอบกลับจะแสดงออบเจ็กต์เที่ยวบินช่วงนั้นพร้อมช่องการปล่อยก๊าซเรือนกระจกที่ว่างเปล่า แต่ระบบจะยังถือว่าคำขอสำเร็จ สาเหตุที่ไม่มีการประมาณการปล่อยก๊าซ ได้แก่
- เซิร์ฟเวอร์ไม่รู้จักเที่ยวบิน
- ขาเที่ยวที่ป้อนไม่มีตัวระบุอย่างน้อย 1 รายการ
- วันที่ของเที่ยวบินเป็นวันที่ที่ผ่านมาแล้ว
- โมเดลไม่รองรับเครื่องบินประเภทนี้
- ไม่มีการกำหนดค่าที่นั่ง
คำขอมีขาเที่ยวบินได้สูงสุด 100 ขา หากคำขอมีเที่ยวบินมากกว่า 100 เที่ยว ระบบจะแสดงข้อผิดพลาด INVALID_ARGUMENT
คำขอ HTTP
POST https://travelimpactmodel.googleapis.com/v1/flights:computeDetailedFlightEmissions
URL ใช้ไวยากรณ์การแปลงรหัส gRPC
เนื้อความของคำขอ
เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
| การแสดง JSON |
|---|
{
"flights": [
{
object ( |
| ช่อง | |
|---|---|
flights[] |
ต้องระบุ เที่ยวบินตรงเพื่อแสดงปริมาณการปล่อยก๊าซโดยประมาณของเที่ยวบินขากลับ |
เนื้อหาการตอบกลับ
คำจำกัดความเอาต์พุตสำหรับคำตอบของ flights.computeDetailedFlightEmissions
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
| การแสดง JSON |
|---|
{ "flightsWithDetailedEmissions": [ { object ( |
| ช่อง | |
|---|---|
flightsWithDetailedEmissions[] |
รายการช่วงเที่ยวบินที่มีปริมาณการปล่อยก๊าซโดยประมาณ |
modelVersion |
เวอร์ชันโมเดลที่ใช้ในการคำนวณปริมาณการปล่อยก๊าซโดยประมาณของเที่ยวบินทั้งหมดในคำตอบนี้ |
FlightWithDetailedEmissions
เที่ยวบินตรงที่มีรายละเอียดปริมาณการปล่อยก๊าซคาร์บอนโดยประมาณ
| การแสดง JSON |
|---|
{ "flight": { object ( |
| ช่อง | |
|---|---|
flight |
เอาต์พุตเท่านั้น ตรงกับตัวระบุเที่ยวบินในคำขอ หมายเหตุ: รหัส IATA ทั้งหมดจะเป็นตัวพิมพ์ใหญ่ |
flightEmissionsDetails |
เอาต์พุตเท่านั้น ข้อมูลการปล่อยก๊าซของเที่ยวบินทั้งหมด |
emissionsMetadata |
เอาต์พุตเท่านั้น ข้อมูลเมตาเพิ่มเติมเกี่ยวกับการคำนวณการปล่อยก๊าซของเที่ยวบิน |
FlightEmissionsDetails
รายละเอียดเกี่ยวกับการปล่อยก๊าซของเที่ยวบินนั้นๆ
| การแสดง JSON |
|---|
{ "emissionsGramsPerPax": { object ( |
| ช่อง | |
|---|---|
emissionsGramsPerPax |
เอาต์พุตเท่านั้น ตัวเลขปริมาณการปล่อยก๊าซโดยประมาณต่อผู้โดยสาร จะไม่มีการแสดงหากคำนวณการปล่อยก๊าซคาร์บอนไม่ได้ ดูรายการสาเหตุที่คำนวณการปล่อยก๊าซคาร์บอนไม่ได้ที่ |
emissionsBreakdown |
เอาต์พุตเท่านั้น รายละเอียดเกี่ยวกับส่วนต่างๆ ของการปล่อยก๊าซในค่า GramsPerPax ของการปล่อยก๊าซทั้งหมด ค่าของการแจกแจงที่รวมกันควรเท่ากับ emissionsGramsPerPax เสมอ |
contrailsImpactBucket |
เอาต์พุตเท่านั้น ความสำคัญของผลกระทบจากภาวะโลกร้อนที่เกิดจากคอนเทรลเมื่อเทียบกับผลกระทบจากการปล่อยก๊าซ CO2e ทั้งหมด |
source |
เอาต์พุตเท่านั้น แหล่งที่มาของข้อมูลการปล่อยก๊าซ |
EmissionsBreakdown
รายละเอียดเกี่ยวกับส่วนต่างๆ ของการปล่อยก๊าซในค่า GramsPerPax ของการปล่อยก๊าซทั้งหมด ค่าของการแจกแจงที่รวมกันควรเท่ากับ emissionsGramsPerPax เสมอ
| การแสดง JSON |
|---|
{ "wttEmissionsGramsPerPax": { object ( |
| ช่อง | |
|---|---|
wttEmissionsGramsPerPax |
ตัวเลขประมาณการปล่อยก๊าซตั้งแต่ต้นจนถึงถังต่อผู้โดยสาร จะไม่มีการแสดงหากคำนวณการปล่อยก๊าซคาร์บอนไม่ได้ ดูรายการเหตุผลที่คำนวณการปล่อยก๊าซคาร์บอนไม่ได้ที่ |
ttwEmissionsGramsPerPax |
ตัวเลขปริมาณการปล่อยก๊าซตั้งแต่ถังจนถึงท้ายเรือต่อผู้โดยสาร 1 คน จะไม่มีการแสดงหากคำนวณการปล่อยก๊าซคาร์บอนไม่ได้ ดูรายการเหตุผลที่คำนวณการปล่อยก๊าซคาร์บอนไม่ได้ที่ |
EmissionsMetadata
ข้อมูลเมตาเพิ่มเติมทั้งหมด
| การแสดง JSON |
|---|
{ "emissionsProvenance": { object ( |
| ช่อง | |
|---|---|
emissionsProvenance |
เอาต์พุตเท่านั้น รายละเอียดเกี่ยวกับแหล่งที่มาของข้อมูลที่ใช้ในการคำนวณข้อมูลการปล่อยก๊าซ รวมถึงปัจจัยที่มีส่วนร่วมพร้อมแหล่งข้อมูล |
easaLabelMetadata |
เอาต์พุตเท่านั้น ข้อมูลเมตาเกี่ยวกับป้ายกำกับการปล่อยก๊าซของเที่ยวบินจาก EASA ตั้งค่าเมื่อแหล่งข้อมูลการปล่อยก๊าซเป็น EASA เท่านั้น |
timWebsiteEmissionsCalculatorUrl |
เอาต์พุตเท่านั้น ลิงก์ไปยังเว็บไซต์ |
EmissionsProvenance
ข้อมูลเกี่ยวกับแหล่งที่มาของข้อมูลที่ใช้ในการคำนวณค่าประมาณการปล่อยก๊าซเรือนกระจก รวมถึงปัจจัยที่เกี่ยวข้องและแหล่งข้อมูล
| การแสดง JSON |
|---|
{
"provenanceEntries": [
{
object ( |
| ช่อง | |
|---|---|
provenanceEntries[] |
เอาต์พุตเท่านั้น ปัจจัยทั้งหมดที่ใช้ในการคำนวณการปล่อยก๊าซ |
EmissionsProvenance.EmissionsProvenanceEntry
รายละเอียดเกี่ยวกับปัจจัยเดียวที่ส่งผลต่อการคำนวณการปล่อยก๊าซ
| การแสดง JSON |
|---|
{ "provenanceEntryType": enum ( |
| ช่อง | |
|---|---|
provenanceEntryType |
เอาต์พุตเท่านั้น ประเภทของรายการที่มา |
source |
เอาต์พุตเท่านั้น แหล่งที่มาของข้อมูล |
sourceVersion |
เอาต์พุตเท่านั้น เวอร์ชันของข้อมูลต้นทาง เช่น "2025/04" |
dataCategory |
เอาต์พุตเท่านั้น หมวดหมู่ข้อมูลของแหล่งข้อมูล |
ฟิลด์ Union data_strategy กลยุทธ์ที่ใช้ในการคำนวณการปล่อยก๊าซสำหรับแหล่งข้อมูลที่ระบุ ชุดฟิลด์จะสอดคล้องกับประเภท data_source data_strategy ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
fuelBurnEeaStrategy |
เอาต์พุตเท่านั้น กลยุทธ์สำหรับการเผาผลาญเชื้อเพลิงใน EEA |
loadFactorsT100Strategy |
เอาต์พุตเท่านั้น กลยุทธ์สำหรับปัจจัยเกี่ยวกับน้ำหนักบรรทุก T100 |
loadFactorsChAviationStrategy |
เอาต์พุตเท่านั้น กลยุทธ์สำหรับปัจจัยเกี่ยวกับน้ำหนักบรรทุกของ CH Aviation |
cargoMassFractionT100Strategy |
เอาต์พุตเท่านั้น กลยุทธ์สำหรับเศษส่วนมวลบรรทุกของ T100 |
seatAreaRatioIataStrategy |
เอาต์พุตเท่านั้น กลยุทธ์สำหรับอัตราส่วนพื้นที่ที่นั่งของ IATA |
distanceAdjustmentStrategy |
เอาต์พุตเท่านั้น กลยุทธ์สำหรับการปรับระยะทาง |
ฟิลด์ Union data_value ค่าข้อมูลสําหรับแหล่งข้อมูลที่ระบุ ชุดฟิลด์จะสอดคล้องกับ provenance_entry_type data_value ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
loadFactorsData |
เอาต์พุตเท่านั้น ค่าข้อมูลปัจจัยเกี่ยวกับน้ำหนักบรรทุก หากไม่ได้ตั้งค่าไว้ ค่าปัจจัยการโหลดจะไม่พร้อมใช้งาน |
cargoMassFractionData |
เอาต์พุตเท่านั้น ค่าเศษส่วนมวลของสินค้า หากไม่ได้ตั้งค่า จะไม่มีค่าเศษส่วนมวลของสินค้า |
seatAreaRatioData |
เอาต์พุตเท่านั้น ค่าอัตราส่วนพื้นที่ที่นั่งสำหรับชั้นโดยสารแต่ละชั้น หากไม่ได้ตั้งค่าไว้ ค่าอัตราส่วนพื้นที่ที่นั่งจะไม่พร้อมใช้งาน |
estimatedFlightDistanceKm |
เอาต์พุตเท่านั้น ระยะทางที่บินโดยประมาณในระยะการบิน CCD ในหน่วยกิโลเมตร ซึ่งคำนวณโดยใช้ปัจจัยการปรับระยะทาง (DAF) หากไม่ได้ตั้งค่าไว้ ค่าระยะทางเที่ยวบินโดยประมาณจะไม่พร้อมใช้งาน |
EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType
ประเภทของรายการที่มา ทั้งนี้ อาจมีการเพิ่มค่าใหม่ๆ ในอนาคต ไคลเอ็นต์ควรเตรียมพร้อมที่จะจัดการค่า Enum ที่ไม่รู้จักอย่างเหมาะสม
| Enum | |
|---|---|
EMISSIONS_PROVENANCE_ENTRY_TYPE_UNSPECIFIED |
ประเภทรายการที่มาที่ไม่ระบุ |
FUEL_BURN |
ประเภทรายการการเผาไหม้เชื้อเพลิง |
LOAD_FACTORS |
ประเภทรายการตัวประกอบโหลด |
CARGO_MASS_FRACTION |
ประเภทรายการเศษส่วนมวลของสินค้า |
SEATING_CONFIG |
ประเภทรายการการกำหนดค่าที่นั่ง |
SEAT_AREA_RATIOS |
ประเภทรายการอัตราส่วนพื้นที่ที่นั่ง |
DISTANCE_ADJUSTMENT |
ประเภทรายการการปรับระยะทาง |
EmissionsProvenance.EmissionsProvenanceEntry.DataSource
แหล่งข้อมูลสำหรับปัจจัยที่มาของการปล่อยก๊าซ ทั้งนี้ อาจมีการเพิ่มค่าใหม่ๆ ในอนาคต ไคลเอ็นต์ควรเตรียมพร้อมที่จะจัดการค่า Enum ที่ไม่รู้จักอย่างเหมาะสม
| Enum | |
|---|---|
DATA_SOURCE_UNSPECIFIED |
ไม่ได้ระบุแหล่งข้อมูล |
EEA |
ข้อมูลจากสำนักงานสิ่งแวดล้อมยุโรป (EEA) |
T100 |
ข้อมูลจากชุดข้อมูล T-100 ซึ่งจัดทำโดยสำนักงานสถิติการขนส่งของสหรัฐอเมริกา |
CH_AVIATION |
ข้อมูลจาก ch-aviation |
OAG |
ข้อมูลจาก Official Aviation Guide (OAG) |
OPERATING_CARRIER |
ข้อมูลจากผู้ให้บริการที่ดำเนินการ |
AIRCRAFT_MODEL_TYPICAL |
ข้อมูลทั่วไปตามรุ่นเครื่องบิน |
GLOBAL_DEFAULT |
ค่าเริ่มต้นส่วนกลางซึ่งใช้เมื่อไม่มีแหล่งข้อมูลอื่น |
IATA |
ข้อมูลที่ได้รับจากสมาคมขนส่งทางอากาศระหว่างประเทศ (International Air Transport Association หรือ IATA) |
ICL |
ข้อมูลจาก Imperial College London |
EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy
กลยุทธ์สำหรับการเผาผลาญเชื้อเพลิงใน EEA ทั้งนี้ อาจมีการเพิ่มค่าใหม่ๆ ในอนาคต ไคลเอ็นต์ควรเตรียมพร้อมที่จะจัดการค่า Enum ที่ไม่รู้จักอย่างเหมาะสม
| Enum | |
|---|---|
STRATEGY_UNSPECIFIED |
ไม่ได้ระบุกลยุทธ์ |
AIRCRAFT_MAPPING_FALLBACK_WITH_CORRECTION_FACTOR |
มีการใช้ปัจจัยการแก้ไขแบบคงที่ |
AIRCRAFT_MAPPING_EXACT |
ใช้การแมปเครื่องบินที่แน่นอน |
AIRCRAFT_MAPPING_FALLBACK |
มีการใช้การแมปเครื่องบินสำรอง |
EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy
กลยุทธ์สำหรับปัจจัยเกี่ยวกับน้ำหนักบรรทุก T100 ทั้งนี้ อาจมีการเพิ่มค่าใหม่ๆ ในอนาคต ไคลเอ็นต์ควรเตรียมพร้อมที่จะจัดการค่า Enum ที่ไม่รู้จักอย่างเหมาะสม
| Enum | |
|---|---|
STRATEGY_UNSPECIFIED |
ไม่ได้ระบุกลยุทธ์ |
CARRIER_ROUTE_MONTH |
ข้อมูลตามผู้ให้บริการ เส้นทาง และเดือนที่เดินทาง |
CARRIER_MONTH |
ข้อมูลตามผู้ให้บริการขนส่งและเดือนที่เดินทาง |
ACTUAL_CARRIER_ROUTE_YEAR_MONTH |
ข้อมูลย้อนหลังที่ตรงกับผู้ให้บริการ เส้นทาง ปี และเดือน |
EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy
กลยุทธ์สำหรับปัจจัยเกี่ยวกับน้ำหนักบรรทุกของ CH-Aviation ทั้งนี้ อาจมีการเพิ่มค่าใหม่ๆ ในอนาคต ไคลเอ็นต์ควรเตรียมพร้อมที่จะจัดการค่า Enum ที่ไม่รู้จักอย่างเหมาะสม
| Enum | |
|---|---|
STRATEGY_UNSPECIFIED |
ไม่ได้ระบุกลยุทธ์ |
CARRIER_MONTH |
ข้อมูลตามผู้ให้บริการขนส่งและเดือนที่เดินทาง |
ACTUAL_CARRIER_YEAR_MONTH |
ข้อมูลย้อนหลังที่ตรงกับผู้ให้บริการ ปี และเดือน |
EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy
กลยุทธ์สำหรับเศษส่วนมวลบรรทุกของ T100 ทั้งนี้ อาจมีการเพิ่มค่าใหม่ๆ ในอนาคต ไคลเอ็นต์ควรเตรียมพร้อมที่จะจัดการค่า Enum ที่ไม่รู้จักอย่างเหมาะสม
| Enum | |
|---|---|
STRATEGY_UNSPECIFIED |
ไม่ได้ระบุกลยุทธ์ |
CARRIER_ROUTE_AIRCRAFT_CLASS |
ข้อมูลตามผู้ให้บริการขนส่ง เส้นทาง และชั้นเครื่องบิน |
ROUTE_AIRCRAFT_CLASS |
ข้อมูลตามเส้นทางและชั้นโดยสารของเครื่องบิน |
DISTANCE_AIRCRAFT_CLASS |
ข้อมูลตามช่วงระยะทางและชั้นเครื่องบิน |
ACTUAL_CARRIER_ROUTE_YEAR_MONTH_AIRCRAFT_CLASS |
ข้อมูลย้อนหลังที่ตรงกับผู้ให้บริการ เส้นทาง ปี เดือน และชั้นโดยสารของเครื่องบิน |
EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy
กลยุทธ์สำหรับอัตราส่วนพื้นที่ที่นั่งของ IATA ทั้งนี้ อาจมีการเพิ่มค่าใหม่ๆ ในอนาคต ไคลเอ็นต์ควรเตรียมพร้อมที่จะจัดการค่า Enum ที่ไม่รู้จักอย่างเหมาะสม
| Enum | |
|---|---|
STRATEGY_UNSPECIFIED |
ไม่ได้ระบุกลยุทธ์ |
NARROW_AIRCRAFT_BODY |
ใช้อัตราส่วนพื้นที่ที่นั่งสำหรับเครื่องบินลำตัวแคบ |
WIDE_AIRCRAFT_BODY |
เราใช้สัดส่วนพื้นที่ที่นั่งสำหรับเครื่องบินลำตัวกว้าง |
EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy
กลยุทธ์สำหรับการปรับระยะทาง ทั้งนี้ อาจมีการเพิ่มค่าใหม่ๆ ในอนาคต ไคลเอ็นต์ควรเตรียมพร้อมที่จะจัดการค่า Enum ที่ไม่รู้จักอย่างเหมาะสม
| Enum | |
|---|---|
STRATEGY_UNSPECIFIED |
ไม่ได้ระบุกลยุทธ์ |
ORIGIN_DESTINATION |
ปัจจัยการปรับระยะทางที่กำหนดโดยคู่สนามบินต้นทางและปลายทาง |
COUNTRY_PAIR |
ปัจจัยการปรับระยะทางที่กำหนดโดยคู่ประเทศต้นทางและปลายทาง |
DEFAULT |
ปัจจัยการปรับระยะทางอิงตามค่าเริ่มต้นเนื่องจากเราไม่พบปัจจัยการปรับเฉพาะสนามบินหรือประเทศ |
EmissionsProvenance.EmissionsProvenanceEntry.DataCategory
หมวดหมู่ข้อมูลของแหล่งข้อมูล ทั้งนี้ อาจมีการเพิ่มค่าใหม่ๆ ในอนาคต ไคลเอ็นต์ควรเตรียมพร้อมที่จะจัดการค่า Enum ที่ไม่รู้จักอย่างเหมาะสม
| Enum | |
|---|---|
DATA_CATEGORY_UNSPECIFIED |
ไม่ได้ระบุหมวดหมู่ข้อมูล |
PRIMARY |
ข้อมูลหลักตามที่กำหนดไว้ใน ISO 14083 |
MODELED |
ข้อมูลที่สร้างโมเดลตามที่กำหนดไว้ใน ISO 14083 |
DEFAULT |
ข้อมูลค่าเริ่มต้นตามที่กำหนดไว้ใน ISO 14083 |