Method: flights.computeFlightEmissions

วิธีการแบบไม่เก็บสถานะเพื่อเรียกข้อมูลปริมาณการปล่อยก๊าซโดยประมาณ ดูรายละเอียดวิธีคำนวณปริมาณการปล่อยก๊าซโดยประมาณได้ที่ https://github.com/google/travel-impact-model

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

  • เซิร์ฟเวอร์ไม่รู้จักเที่ยวบินนี้
  • เที่ยวบินที่ป้อนไม่มีตัวระบุอย่างน้อย 1 รายการ
  • วันที่แสดงโฆษณาเป็นวันที่ที่ผ่านมาแล้ว
  • โมเดลไม่รองรับประเภทเครื่องบิน
  • ไม่มีการกำหนดค่าใบอนุญาตที่มี

คำขอสามารถมีรอบการบินได้สูงสุด 1,000 รอบ หากคำขอมีเที่ยวบินตรงมากกว่า 1, 000 รายการ หากจะล้มเหลวโดยมีข้อผิดพลาด INVALID_ARGUMENT

คำขอ HTTP

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

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

เนื้อหาของคำขอ

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

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

object (Flight)

ต้องระบุ เที่ยวบินตรงเพื่อดูข้อมูลปริมาณการปล่อยก๊าซโดยประมาณ

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

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

คำจำกัดความเอาต์พุตสำหรับการตอบกลับ [flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions]

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

object (FlightWithEmissions)

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

object (ModelVersion)

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

ช่วงเวลาแสดงโฆษณา

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

การแสดง JSON 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
ช่อง
origin

string

ต้องระบุ รหัสสนามบิน IATA สำหรับต้นทางของเที่ยวบิน เช่น "LHR"
destination

string

ต้องระบุ รหัสสนามบิน IATA สำหรับจุดหมายของเที่ยวบิน เช่น "JFK"
operatingCarrierCode

string

ต้องระบุ รหัสผู้ให้บริการ IATA เช่น "AA"
flightNumber

integer

ต้องระบุ หมายเลขเที่ยวบิน เช่น 324
departureDate

object (Date)

ต้องระบุ วันที่เที่ยวบินในเขตเวลาของสนามบินต้นทาง ต้องเป็นวันที่ปัจจุบันหรืออนาคต

วันที่

แสดงวันที่ในปฏิทินทั้งหมดหรือบางส่วน เช่น วันเกิด มีการระบุเวลาของวันและเขตเวลาไว้ที่อื่นหรือไม่มีนัยสำคัญ วันที่จะสัมพันธ์กับปฏิทินเกรกอเรียน ซึ่งอาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้

  • วันที่แบบเต็มพร้อมค่าปี เดือน และวันที่ไม่ใช่ 0
  • เดือนและวัน 1 ปี (เช่น วันครบรอบ)
  • 1 ปีเท่านั้น โดยมี 0 เดือนกับ 0 วัน
  • ปีและเดือนที่มี 0 วัน (เช่น วันที่หมดอายุของบัตรเครดิต)

ประเภทที่เกี่ยวข้อง

การแสดง JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
ช่อง
year

integer

ปีของวันที่ ต้องอยู่ระหว่าง 1 ถึง 9999 หรือ 0 เพื่อระบุวันที่โดยไม่ต้องใส่ปี
month

integer

เดือนของปี ค่านี้ต้องอยู่ระหว่าง 1 ถึง 12 หรือ 0 เพื่อระบุปีโดยไม่มีเดือนและวัน
day

integer

วันของเดือน ค่านี้ต้องอยู่ระหว่าง 1 ถึง 31 และใช้ได้กับปีและเดือน หรือ 0 เพื่อระบุปีอย่างเดียว หรือปีและเดือนที่วันไม่สำคัญ

FlightWithEmissions

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

การแสดง JSON 
{
  "flight": {
    object (Flight)
  },
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
ช่อง
flight

object (Flight)

ต้องระบุ จับคู่ตัวระบุเที่ยวบินในคำขอ หมายเหตุ: รหัส IATA ทั้งหมดจะเป็นตัวพิมพ์ใหญ่
emissionsGramsPerPax

object (EmissionsGramsPerPax)

ไม่บังคับ จำนวนการปล่อยก๊าซโดยประมาณต่อผู้โดยสาร ระบบจะไม่แสดงข้อมูลดังกล่าวหากคำนวณการปล่อยก๊าซไม่ได้ โปรดดูรายการเหตุผลที่ระบบคำนวณการปล่อยก๊าซไม่ได้ที่ [flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions]

EmissionsGramsPerPax

การปล่อยก๊าซโดยแบ่งกลุ่มตามผลการค้นหาชั้นโดยสาร

การแสดง JSON 
{
  "first": integer,
  "business": integer,
  "premiumEconomy": integer,
  "economy": integer
}
ช่อง
first

integer

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

integer

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

integer

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

integer

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

ModelVersion

เวอร์ชัน Travel Impact Model ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดเวอร์ชันโมเดลได้ที่ https://github.com/google/travel-impact-model/#versioning

การแสดง JSON 
{
  "major": integer,
  "minor": integer,
  "patch": integer,
  "dated": string
}
ช่อง
major

integer

เวอร์ชันหลัก: การเปลี่ยนแปลงที่สําคัญกับวิธีการ (เช่น การเพิ่มแหล่งข้อมูลใหม่ลงในโมเดลซึ่งทําให้เกิดการเปลี่ยนแปลงเอาต์พุตที่สําคัญ) การเปลี่ยนแปลงดังกล่าวจะเกิดขึ้นไม่บ่อยนักและแจ้งให้ทราบล่วงหน้า อาจเกี่ยวข้องกับการเปลี่ยนแปลงเวอร์ชัน API ซึ่งจะเป็นไปตามหลักเกณฑ์ใน https://cloud.google.com/endpoints/docs/openapi/versioning-an-api#backwards-incompatible
minor

integer

เวอร์ชันย่อย: การเปลี่ยนแปลงโมเดลที่แม้จะสอดคล้องกันในทุกเวอร์ชันของสคีมา แล้วเปลี่ยนพารามิเตอร์โมเดลหรือการติดตั้งใช้งาน
patch

integer

เวอร์ชันของแพตช์: การเปลี่ยนแปลงในการใช้งานเพื่อแก้ไขข้อบกพร่องหรือความไม่ถูกต้องในการใช้งานโมเดล
dated

string

เวอร์ชันที่ระบุวันที่: ระบบจะสร้างชุดข้อมูลโมเดลขึ้นมาใหม่ด้วยข้อมูลอินพุตที่รีเฟรชแล้ว แต่ไม่มีการเปลี่ยนแปลงอัลกอริทึมเป็นประจำ