Method: flights.computeScope3FlightEmissions

Mengambil estimasi emisi gas rumah kaca untuk serangkaian segmen penerbangan untuk pelaporan cakupan 3.

Respons akan berisi semua entri yang cocok dengan segmen penerbangan Scope3FlightSegment input, dalam urutan yang sama seperti yang diberikan. Estimasi akan dihitung menggunakan logika menurun berikut (menggunakan logika pertama yang tersedia):

  1. Emisi berbasis TIM dengan mempertimbangkan origin, destination, carrier, flightNumber, departureDate, dan cabinClass.
  2. Emisi penerbangan standar berdasarkan origin, destination, tahun di departureDate, dan cabinClass.
  3. Emisi berbasis jarak dihitung menggunakan distanceKm, tahun di departureDate, dan cabinClass.

Jika ada penerbangan mendatang yang diminta dalam tahun kalender ini, kami tidak mendukung emisi Tingkat 1 dan akan beralih ke emisi Tingkat 2 atau 3. Jika penerbangan mendatang yang diminta tidak ada dalam tahun kalender ini, kami akan menampilkan respons kosong. Sebaiknya gunakan computeFlightEmissions API untuk penerbangan mendatang.

Jika tidak ada estimasi yang tersedia untuk penerbangan tertentu dengan salah satu dari tiga metode tersebut, respons akan menampilkan objek Scope3FlightEmissions dengan kolom emisi kosong. Permintaan akan tetap dianggap berhasil. Umumnya, estimasi emisi tidak ada jika penerbangan tidak diketahui oleh server (misalnya, tidak ada penerbangan tertentu, atau emisi penerbangan standar tidak tersedia untuk pasangan yang diminta).

Permintaan akan gagal dengan error INVALID_ARGUMENT jika:

  • Permintaan berisi lebih dari 1.000 segmen penerbangan.
  • Segmen penerbangan input tidak memiliki satu atau beberapa ID. Misalnya, tidak ada asal/tujuan tanpa jarak yang valid untuk pencocokan jenis TIM_EMISSIONS atau TYPICAL_FLIGHT_EMISSIONS, atau tidak ada jarak untuk pencocokan jenis DISTANCE_BASED_EMISSIONS (jika Anda ingin beralih ke emisi berbasis jarak atau menginginkan estimasi emisi berbasis jarak, Anda harus menentukan jarak).
  • Tanggal penerbangan sebelum tahun 2019 (data Cakupan 3 hanya tersedia untuk tahun 2019 dan setelahnya).
  • Jarak penerbangan adalah 0 atau lebih rendah.
  • Kelas kabin tidak ada.

Karena permintaan diproses dengan logika penggantian, permintaan yang salah dikonfigurasi mungkin menampilkan estimasi emisi yang valid menggunakan metode penggantian. Misalnya, jika permintaan memiliki nomor penerbangan yang salah, tetapi menentukan bandara keberangkatan dan tujuan, permintaan akan tetap berhasil, tetapi emisi yang ditampilkan hanya akan didasarkan pada emisi penerbangan standar. Demikian pula, jika permintaan tidak menyertakan bandara keberangkatan untuk permintaan emisi penerbangan standar, tetapi menentukan jarak yang valid, permintaan tersebut dapat berhasil hanya berdasarkan emisi berbasis jarak. Oleh karena itu, Anda harus memeriksa sumber emisi yang ditampilkan (source) untuk mengonfirmasi bahwa hasilnya sesuai harapan.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "flights": [
    {
      object (Scope3FlightSegment)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Kolom
flights[]

object (Scope3FlightSegment)

Wajib. Penerbangan yang akan menampilkan perkiraan emisi.
modelVersion

object (ModelVersion)

Opsional. Versi model yang digunakan untuk menghitung perkiraan emisi untuk semua penerbangan dalam permintaan ini.

Isi respons

Daftar penerbangan dengan perkiraan emisi Cakupan 3.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "flightEmissions": [
    {
      object (Scope3FlightEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Kolom
flightEmissions[]

object (Scope3FlightEmissions)

Daftar segmen penerbangan dengan perkiraan emisi.
modelVersion

object (ModelVersion)

Versi model yang digunakan untuk menghitung perkiraan emisi untuk semua penerbangan dalam respons ini.

Scope3FlightSegment

Parameter penerbangan yang digunakan untuk mengambil emisi Cakupan 3.

Representasi JSON 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (Scope3FlightSegment.CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
Kolom
departureDate

object (Date)

Wajib. Tanggal penerbangan dalam zona waktu bandara asal. Hanya tahun yang diperlukan untuk model emisi penerbangan standar dan berbasis jarak (nilai bulan dan hari diabaikan, sehingga dapat dihilangkan, ditetapkan ke 0, atau ditetapkan ke tanggal yang valid untuk kasus tersebut). Demikian pula, jika tanggal tertentu tidak diberikan untuk emisi TIM, kami akan kembali ke emisi penerbangan standar (atau berbasis jarak).
cabinClass

enum (Scope3FlightSegment.CabinClass)

Wajib. Kelas kabin penerbangan.
origin

string

Opsional. Kode bandara IATA 3 karakter untuk asal penerbangan, misalnya YVR. Ini digunakan untuk mencocokkan penerbangan tertentu jika diberikan bersama tujuan, maskapai penerbangan, dan nomor penerbangan. Jika tidak ada kecocokan, kami akan mencoba mencocokkan penerbangan dengan penerbangan standar antara bandara keberangkatan dan tujuan yang diberikan. Jika tidak, kami akan menggunakan model emisi berbasis jarak jika jarak penerbangan diberikan.
destination

string

Opsional. Kode bandara IATA 3 karakter untuk tujuan penerbangan, misalnya ICN. Informasi ini digunakan untuk mencocokkan penerbangan tertentu jika diberikan bersama dengan bandara keberangkatan, maskapai penerbangan, dan nomor penerbangan. Jika tidak ada kecocokan, kami akan mencoba mencocokkan penerbangan dengan penerbangan standar antara bandara keberangkatan dan tujuan yang diberikan. Jika tidak, kami akan menggunakan model emisi berbasis jarak jika jarak penerbangan diberikan.
carrierCode

string

Opsional. Kode maskapai penerbangan IATA 2 karakter, misalnya KE. Hal ini diperlukan jika pencocokan penerbangan tertentu diinginkan. Jika tidak, data ini tidak akan digunakan untuk model emisi berbasis jarak dan penerbangan standar. Ini dapat berupa kode maskapai penerbangan pengoperasian dan pemasaran (yaitu, codeshare tercakup).
flightNumber

integer

Opsional. Nomor penerbangan hingga 4 digit, misalnya 71, dari [1, 9999]. Informasi ini pertama kali digunakan untuk mencocokkan penerbangan tertentu jika nomor penerbangan ditentukan bersama dengan bandara keberangkatan, bandara tujuan, dan maskapai penerbangan. Jika nomor penerbangan tidak ditentukan, kami akan mencoba mencocokkan penerbangan dengan penerbangan standar antara bandara asal dan tujuan yang diberikan. Jika gagal dan/atau bandara keberangkatan & tujuan tidak diberikan, kami akan menggunakan model emisi berbasis jarak berdasarkan jarak penerbangan yang diberikan.
distanceKm

string (int64 format)

Opsional. Jarak dalam kilometer, misalnya 2423, dari [1, 1e12) km. Jarak ini digunakan untuk mencocokkan penerbangan dengan emisi berbasis jarak jika bandara asal dan tujuan tidak diberikan atau tidak ada penerbangan standar yang cocok.

Scope3FlightSegment.CabinClass

Kelas kabin penerbangan.

Enum
CABIN_CLASS_UNSPECIFIED Kelas kabin tidak ditentukan.
ECONOMY Kelas ekonomi.
PREMIUM_ECONOMY Kelas ekonomi premium.
BUSINESS Kelas bisnis.
FIRST Kelas satu.

Scope3FlightEmissions

Penerbangan cakupan 3 dengan perkiraan emisi.

Representasi JSON 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3FlightEmissions.Scope3DataType),
  "modelVersion": string
}
Kolom
flight

object (Scope3FlightSegment)

ID. Cocok dengan ID penerbangan dalam permintaan.
wtwEmissionsGramsPerPax

string (int64 format)

Opsional. Total emisi penerbangan (jumlah well-to-tank dan tank-to-wake) per penumpang berdasarkan info yang diminta. Ini adalah total emisi dan kecuali jika Anda memiliki alasan khusus untuk menggunakan emisi TTW atau WTT, Anda harus menggunakan angka ini.
ttwEmissionsGramsPerPax

string (int64 format)

Opsional. Emisi penerbangan tank-to-wake per penumpang berdasarkan info yang diminta.
wttEmissionsGramsPerPax

string (int64 format)

Opsional. Emisi penerbangan well-to-tank per penumpang berdasarkan info yang diminta.
source

enum (Scope3FlightEmissions.Scope3DataType)

Opsional. Sumber data emisi.
modelVersion

string

Opsional. Versi model yang digunakan untuk menghitung emisi.

Scope3FlightEmissions.Scope3DataType

Jenis pencocokan yang digunakan untuk menghitung emisi Cakupan 3. Metode ini digunakan untuk respons Cakupan 3, yang menandai metode mana yang digunakan untuk menghitung emisi.

Enum
SCOPE3_DATA_TYPE_UNSPECIFIED Jenis data tidak ditentukan.
TIM_EMISSIONS Emisi berbasis TIM berdasarkan asal, tujuan, maskapai penerbangan, nomor penerbangan, tanggal keberangkatan, dan tahun.
TYPICAL_FLIGHT_EMISSIONS Emisi penerbangan standar berdasarkan bandara keberangkatan, bandara tujuan, dan tahun.
DISTANCE_BASED_EMISSIONS Emisi berbasis jarak berdasarkan jarak tempuh dan tahun.