Package google.travel.sustainability.travelimpactmodel.v1

Indeks

TravelImpactModelService

API untuk memberikan estimasi emisi karbon.

ComputeFlightEmissions

rpc ComputeFlightEmissions(ComputeFlightEmissionsRequest) returns (ComputeFlightEmissionsResponse)

Metode tanpa status untuk mengambil estimasi emisi. Detail tentang cara penghitungan estimasi emisi ada di GitHub

Respons akan berisi semua entri yang cocok dengan segmen penerbangan input, dalam urutan yang sama. Jika tidak ada estimasi yang tersedia untuk segmen penerbangan tertentu, respons akan menampilkan objek segmen penerbangan dengan kolom emisi yang kosong. Permintaan akan tetap dianggap berhasil. Alasan estimasi emisi tidak ada meliputi:

  • Penerbangan tidak diketahui oleh server.
  • Segmen penerbangan input tidak memiliki satu atau beberapa ID.
  • Tanggal penerbangan sudah lewat.
  • Jenis pesawat tidak didukung oleh model.
  • Konfigurasi tempat duduk tidak ada.

Permintaan dapat berisi hingga 1.000 segmen penerbangan. Jika permintaan memiliki lebih dari 1.000 penerbangan langsung, permintaan akan gagal dengan error INVALID_ARGUMENT.
ComputeScope3FlightEmissions

rpc ComputeScope3FlightEmissions(ComputeScope3FlightEmissionsRequest) returns (ComputeScope3FlightEmissionsResponse)

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, Anda harus memeriksa sumber emisi yang dikembalikan (source) untuk mengonfirmasi bahwa hasilnya sesuai yang diharapkan.
ComputeTypicalFlightEmissions

rpc ComputeTypicalFlightEmissions(ComputeTypicalFlightEmissionsRequest) returns (ComputeTypicalFlightEmissionsResponse)

Mengambil perkiraan emisi penerbangan standar antara dua bandara, yang juga dikenal sebagai pasar. Jika tidak ada perkiraan yang tersedia untuk pasar tertentu, respons akan menampilkan objek pasar dengan kolom emisi kosong. Permintaan akan tetap dianggap berhasil.

Detail tentang cara penghitungan estimasi emisi standar ada di GitHub.

Permintaan dapat berisi hingga 1.000 pasar. Jika permintaan memiliki lebih dari 1.000 pasar, permintaan akan gagal dengan error INVALID_ARGUMENT.

ComputeFlightEmissionsRequest

Definisi input untuk permintaan ComputeFlightEmissions.

Kolom
flights[]

Flight

Wajib. Penerbangan langsung untuk mengembalikan perkiraan emisi.

ComputeFlightEmissionsResponse

Definisi output untuk respons ComputeFlightEmissions.

Kolom
flight_emissions[]

FlightWithEmissions

Daftar segmen penerbangan dengan perkiraan emisi.
model_version

ModelVersion

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

ComputeScope3FlightEmissionsRequest

Daftar segmen penerbangan untuk meminta emisi Cakupan 3.

Kolom
flights[]

Scope3FlightSegment

Wajib. Penerbangan untuk menampilkan perkiraan emisi.
model_version

ModelVersion

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

ComputeScope3FlightEmissionsResponse

Daftar penerbangan dengan perkiraan emisi Cakupan 3.

Kolom
flight_emissions[]

Scope3FlightEmissions

Daftar segmen penerbangan dengan perkiraan emisi.
model_version

ModelVersion

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

ComputeTypicalFlightEmissionsRequest

Daftar pasangan bandara (pasar) untuk meminta emisi standar.

Kolom
markets[]

Market

Wajib. Minta perkiraan emisi penerbangan standar untuk pasangan pasar ini. Maksimum 1.000 pasar dapat diminta.

ComputeTypicalFlightEmissionsResponse

Respons mencakup emisi, tetapi juga versi model.

Kolom
typical_flight_emissions[]

TypicalFlightEmissions

Emisi Penerbangan Standar Pasar diminta.
model_version

ModelVersion

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

ContrailsImpactBucket

Signifikansi dampak pemanasan kontrail dibandingkan dengan total dampak emisi CO2e.

Enum
CONTRAILS_IMPACT_UNSPECIFIED Dampak jejak pesawat tidak ditentukan.
CONTRAILS_IMPACT_NEGLIGIBLE Dampak jejak kondensasi tidak signifikan dibandingkan dengan total emisi CO2e.
CONTRAILS_IMPACT_MODERATE Dampak jejak kondensasi sebanding dengan total emisi CO2e.
CONTRAILS_IMPACT_SEVERE Dampak kontrail lebih tinggi daripada total dampak emisi CO2e.

EasaLabelMetadata

Metadata tentang Label Emisi Penerbangan EASA.

Kolom
label_issue_date

Date

Tanggal saat label dikeluarkan.
label_expiry_date

Date

Tanggal habis masa berlaku label. Label dapat ditampilkan hingga akhir tanggal ini.
label_version

string

Versi label.
saf_discount_percentage

double

Persentase diskon emisi Bahan Bakar Penerbangan Ramah Lingkungan (SAF) yang diterapkan pada label. Ini adalah persentase sebagai desimal. Nilainya berada dalam interval [0,1]. Misalnya, 0,0021 berarti 0,21%.

Diskon dan pengurangan emisi ini dilaporkan oleh label EASA, tetapi tidak disertakan dalam perkiraan CO2e yang didistribusikan oleh API ini.

EmissionsGramsPerPax

Hasil emisi yang dikelompokkan per kelas tempat duduk.

Kolom
first

int32

Emisi untuk satu penumpang di kelas satu dalam gram. Kolom ini selalu dihitung dan diisi, terlepas dari apakah pesawat memiliki kursi kelas satu atau tidak.
business

int32

Emisi untuk satu penumpang di kelas bisnis dalam gram. Kolom ini selalu dihitung dan diisi, terlepas dari apakah pesawat memiliki kursi kelas bisnis atau tidak.
premium_economy

int32

Emisi untuk satu penumpang di kelas ekonomi premium dalam gram. Kolom ini selalu dihitung dan diisi, terlepas dari apakah pesawat memiliki kursi kelas ekonomi premium atau tidak.
economy

int32

Emisi untuk satu penumpang di kelas ekonomi dalam gram. Kolom ini selalu dihitung dan diisi, terlepas dari apakah pesawat memiliki kursi kelas ekonomi atau tidak.

Penerbangan

Semua detail terkait satu item permintaan untuk perkiraan emisi penerbangan langsung.

Kolom
origin

string

Wajib. Kode bandara IATA untuk asal penerbangan, misalnya "LHR".
destination

string

Wajib. Kode bandara IATA untuk tujuan penerbangan, misalnya "JFK".
operating_carrier_code

string

Wajib. Kode maskapai IATA, misalnya "AA".
flight_number

int32

Wajib. Nomor penerbangan, misalnya 324.
departure_date

Date

Wajib. Tanggal penerbangan dalam zona waktu bandara asal. Harus berupa tanggal saat ini atau di masa mendatang.

FlightWithEmissions

Penerbangan langsung dengan perkiraan emisi.

Kolom
flight

Flight

Wajib. Cocok dengan ID penerbangan dalam permintaan. Catatan: semua kode IATA menggunakan huruf kapital.
source

Source

Opsional. Sumber data emisi.
emissions_grams_per_pax

EmissionsGramsPerPax

Opsional. Angka estimasi emisi per penumpang. Tidak akan ada jika emisi tidak dapat dihitung. Untuk mengetahui daftar alasan mengapa emisi tidak dapat dihitung, lihat ComputeFlightEmissions.
easa_label_metadata

EasaLabelMetadata

Opsional. Metadata tentang Label Emisi Penerbangan EASA. Hanya disetel jika sumber data emisi adalah EASA.
contrails_impact_bucket

ContrailsImpactBucket

Opsional. Signifikansi dampak pemanasan kontrail dibandingkan dengan total dampak emisi CO2e.

Pasar

Sepasang bandara.

Kolom
origin

string

Wajib. Kode bandara IATA untuk asal penerbangan, misalnya "LHR".
destination

string

Wajib. Kode bandara IATA untuk tujuan penerbangan, misalnya "JFK".

ModelVersion

Versi Travel Impact Model. Untuk mengetahui informasi selengkapnya tentang pembuatan versi model, lihat GitHub.

Kolom
major

int32

Versi utama: Perubahan besar pada metodologi (misalnya, menambahkan sumber data baru ke model yang menyebabkan perubahan besar pada output). Perubahan tersebut akan jarang terjadi dan diumumkan jauh sebelumnya. Mungkin melibatkan perubahan versi API, yang akan mematuhi pedoman Google Cloud API
minor

int32

Versi minor: Perubahan pada model yang, meskipun konsisten di seluruh versi skema, mengubah parameter atau implementasi model.
patch

int32

Versi patch: Perubahan implementasi yang dimaksudkan untuk mengatasi bug atau ketidakakuratan dalam implementasi model.
dated

string

Versi berlabel tanggal: Dataset model dibuat ulang dengan data input yang diperbarui, tetapi tidak ada perubahan pada algoritma secara berkala.

Scope3FlightEmissions

Penerbangan Lingkup 3 dengan perkiraan emisi.

Kolom
flight

Scope3FlightSegment

Wajib. Cocok dengan ID penerbangan dalam permintaan.
wtw_emissions_grams_per_pax

int64

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.
ttw_emissions_grams_per_pax

int64

Opsional. Emisi penerbangan dari bahan bakar hingga lepas landas per penumpang berdasarkan info yang diminta.
wtt_emissions_grams_per_pax

int64

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

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.

Scope3FlightSegment

Parameter penerbangan yang digunakan untuk mengambil emisi Cakupan 3.

Kolom
departure_date

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).
cabin_class

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.
carrier_code

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).
flight_number

int32

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.
distance_km

int64

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.

Sumber

Sumber data emisi.

Enum
SOURCE_UNSPECIFIED Sumber data emisi tidak ditentukan.
TIM Data emisi berasal dari Model Dampak Perjalanan.
EASA Data emisi berasal dari label lingkungan EASA.

TypicalFlightEmissions

Perkiraan emisi penerbangan standar untuk pasar tertentu

Kolom
market

Market

Wajib. Cocok dengan ID penerbangan dalam permintaan. Catatan: semua kode IATA menggunakan huruf kapital.
emissions_grams_per_pax

EmissionsGramsPerPax

Opsional. Emisi penerbangan standar per penumpang untuk pasar yang diminta. Tidak akan ada jika emisi umum tidak dapat dihitung. Untuk mengetahui daftar alasan mengapa emisi penerbangan umum tidak dapat dihitung, lihat GitHub.