Method: flights.computeScope3FlightEmissions

Metode tanpa status untuk mengambil perkiraan emisi GHG untuk serangkaian segmen penerbangan untuk pelaporan Scope 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 berjenjang berikut (menggunakan yang pertama tersedia):

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

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

Jika tidak ada perkiraan yang tersedia untuk penerbangan tertentu dengan salah satu dari tiga metode, respons akan menampilkan objek Scope3FlightEmissions dengan kolom emisi yang kosong. Permintaan akan tetap dianggap berhasil. Umumnya, perkiraan 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, asal/tujuan tidak ada tanpa jarak yang valid untuk pencocokan jenis TIM_EMISSIONS atau TYPICAL_FLIGHT_EMISSIONS, atau jarak tidak ada untuk pencocokan jenis DISTANCE_BASED_EMISSIONS (jika Anda ingin melakukan penggantian ke perkiraan emisi berbasis jarak atau menginginkan perkiraan 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 dapat menampilkan perkiraan emisi yang valid menggunakan metode penggantian. Misalnya, jika permintaan memiliki nomor penerbangan yang salah, tetapi menentukan asal dan tujuan, permintaan akan tetap berhasil, tetapi emisi yang ditampilkan hanya akan didasarkan pada emisi penerbangan umum. Demikian pula, jika permintaan tidak mencantumkan asal untuk permintaan emisi penerbangan biasa, tetapi menentukan jarak yang valid, permintaan dapat berhasil hanya berdasarkan emisi berbasis jarak. Oleh karena itu, seseorang harus memeriksa sumber emisi yang dikembalikan (source) untuk mengonfirmasi bahwa hasilnya sesuai yang diharapkan.

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 untuk 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 (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 berbasis jarak dan penerbangan umum (nilai bulan dan hari diabaikan, sehingga dapat dihilangkan, ditetapkan ke 0, atau ditetapkan ke tanggal yang valid untuk kasus tersebut). Oleh karena itu, jika tanggal tertentu tidak diberikan untuk emisi TIM, kami akan kembali ke emisi penerbangan standar (atau berbasis jarak).
cabinClass

enum (CabinClass)

Wajib. Kelas kabin penerbangan.
origin

string

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

string

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

string

Opsional. Kode maskapai IATA, misalnya KE. Atribut ini wajib diisi jika pencocokan penerbangan tertentu diinginkan. Jika tidak, ini tidak digunakan untuk model emisi berbasis jarak dan penerbangan umum. Ini bisa berupa kode maskapai penerbangan operasional dan pemasaran (yaitu codeshare tercakup).
flightNumber

integer

Opsional. Nomor penerbangan, misalnya 71. ID ini pertama kali digunakan untuk mencocokkan penerbangan tertentu jika nomor penerbangan ditentukan bersama dengan asal, tujuan, dan maskapai. Jika nomor penerbangan tidak ditentukan, kami akan mencoba mencocokkan penerbangan dengan penerbangan umum antara bandara asal dan tujuan yang diberikan. Jika gagal dan/atau asal & 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. Hal ini digunakan untuk mencocokkan penerbangan dengan emisi berbasis jarak jika asal dan tujuan tidak diberikan atau tidak ada penerbangan standar yang cocok. Kolom ini mendukung nilai antara 0 dan 2,5e16 km.

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 Lingkup 3 dengan perkiraan emisi.

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

object (Scope3FlightSegment)

Wajib. 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 dari bahan bakar hingga lepas landas per penumpang berdasarkan info yang diminta.
wttEmissionsGramsPerPax

string (int64 format)

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

enum (Scope3DataType)

Opsional. Sumber data emisi.

Scope3DataType

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

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