Package google.travel.sustainability.travelimpactmodel.v1

Dizin

TravelImpactModelService

Karbon emisyonu tahminleri sağlayan API.

ComputeFlightEmissions

rpc ComputeFlightEmissions(ComputeFlightEmissionsRequest) returns (ComputeFlightEmissionsResponse)

Emisyon tahminlerini almak için durum bilgisi içermeyen yöntem. Emisyon tahminlerinin nasıl hesaplandığıyla ilgili ayrıntıları GitHub'da bulabilirsiniz.

Yanıt, giriş uçuş ayaklarıyla eşleşen tüm girişleri aynı sırada içerir. Belirli bir uçuş ayağı için tahmin bulunmuyorsa yanıtta, uçuş ayağı nesnesi boş emisyon alanlarıyla birlikte döndürülür. İstek yine de başarılı kabul edilir. Emisyon tahminlerinin eksik olmasının nedenleri şunlardır:

  • Uçuş, sunucu tarafından bilinmiyor.
  • Giriş uçuş ayağında bir veya daha fazla tanımlayıcı eksik.
  • Uçuş tarihi geçmişte.
  • Uçak türü model tarafından desteklenmiyor.
  • Lisans yapılandırması eksik.

İstek en fazla 1.000 uçuş ayağı içerebilir. İstek 1.000'den fazla doğrudan uçuş içeriyorsa INVALID_ARGUMENT hatasıyla başarısız olur.
ComputeScope3FlightEmissions

rpc ComputeScope3FlightEmissions(ComputeScope3FlightEmissionsRequest) returns (ComputeScope3FlightEmissionsResponse)

Kapsam 3 raporlaması için bir dizi uçuş segmentine ait GHG emisyonu tahminlerini almak üzere kullanılan durum bilgisi içermeyen yöntem.

Yanıt, giriş Scope3FlightSegment uçuş segmentleriyle eşleşen tüm girişleri sağlanan sırayla içerir. Tahminler, aşağıdaki basamaklı mantık kullanılarak hesaplanır (mevcut olan ilk tahmin kullanılır):

  1. origin, destination, carrier, flightNumber, departureDate ve cabinClass için TIM tabanlı emisyonlar.
  2. origin, destination, departureDate yılı ve cabinClass göz önüne alındığında tipik uçuş emisyonları.
  3. Mesafeye dayalı emisyonlar distanceKm, departureDate yılı ve cabinClass kullanılarak hesaplanır.

Bu takvim yılında gelecekteki bir uçuş talep edilirse 1. katman emisyonları desteklenmez ve 2. veya 3. katman emisyonlarına geri dönülür. İstenen gelecekteki uçuş bu takvim yılı içinde değilse boş bir yanıt döndürülür. Gelecekteki uçuşlar için computeFlightEmissions API'sinin kullanılmasını öneririz.

Üç yöntemden herhangi biriyle belirli bir uçuş için tahmin bulunmuyorsa yanıtta, emisyon alanları boş olan bir Scope3FlightEmissions nesnesi döndürülür. İstek yine de başarılı kabul edilir. Genellikle, uçuş sunucu tarafından bilinmediğinde (ör. belirli bir uçuş yoksa veya istenen çift için normal uçuş emisyonları mevcut değilse) emisyon tahminleri eksik olur.

Aşağıdaki durumlarda istek INVALID_ARGUMENT hatasıyla başarısız olur:

  • İstek 1.000'den fazla uçuş ayağı içeriyor.
  • Giriş uçuş ayağında bir veya daha fazla tanımlayıcı eksik. Örneğin, TIM_EMISSIONS veya TYPICAL_FLIGHT_EMISSIONS türü eşleşmesi için geçerli bir mesafe olmadan kaynak/hedef eksik ya da DISTANCE_BASED_EMISSIONS türü eşleşmesi için mesafe eksik (mesafeye dayalı emisyonlara geri dönmek veya mesafeye dayalı emisyon tahmini almak istiyorsanız mesafe belirtmeniz gerekir).
  • Uçuş tarihi 2019'dan önceyse (kapsam 3 verileri yalnızca 2019 ve sonrası için kullanılabilir).
  • Uçuş mesafesi 0 veya daha az olmalıdır.
  • Kabin sınıfı eksik.

İstek, yedek mantıkla işlendiğinden yanlış yapılandırılmış istekler, yedek yöntemler kullanılarak geçerli emisyon tahminleri döndürebilir. Örneğin, bir istekte yanlış uçuş numarası varsa ancak kalkış ve varış noktası belirtilmişse istek yine de başarılı olur ancak döndürülen emisyonlar yalnızca tipik uçuş emisyonlarına göre belirlenir. Benzer şekilde, normal bir uçuş emisyonu isteğinde kaynak eksikse ancak geçerli bir mesafe belirtilmişse istek yalnızca mesafeye dayalı emisyonlara göre başarılı olabilir. Bu nedenle, sonuçların beklendiği gibi olduğunu doğrulamak için iade edilen emisyonların kaynağı (source) kontrol edilmelidir.
ComputeTypicalFlightEmissions

rpc ComputeTypicalFlightEmissions(ComputeTypicalFlightEmissionsRequest) returns (ComputeTypicalFlightEmissionsResponse)

İki havalimanı (pazar olarak da bilinir) arasındaki normal uçuş emisyonu tahminlerini alır. Belirli bir pazar için tahmin bulunmuyorsa yanıtta, emisyon alanları boş olan pazar nesnesi döndürülür. İstek yine de başarılı kabul edilir.

Normal emisyon tahminlerinin nasıl hesaplandığıyla ilgili ayrıntıları GitHub'da bulabilirsiniz.

İstek en fazla 1.000 pazar içerebilir. İstek 1.000'den fazla pazar içeriyorsa INVALID_ARGUMENT hatasıyla başarısız olur.

ComputeFlightEmissionsRequest

ComputeFlightEmissions isteği için giriş tanımı.

Alanlar
flights[]

Flight

Zorunlu. Emisyon tahminlerinin döndürüleceği doğrudan uçuşlar.

ComputeFlightEmissionsResponse

ComputeFlightEmissions yanıtı için çıkış tanımı.

Alanlar
flight_emissions[]

FlightWithEmissions

Emisyon tahminlerini içeren uçuş etaplarının listesi.
model_version

ModelVersion

Bu yanıttaki tüm uçuşların emisyon tahminlerinin hesaplandığı model sürümü.

ComputeScope3FlightEmissionsRequest

Kapsam 3 emisyonları için istekte bulunulacak uçuş segmentlerinin listesi.

Alanlar
flights[]

Scope3FlightSegment

Zorunlu. Emisyon tahminlerinin döndürüleceği uçuşlar.
model_version

ModelVersion

İsteğe bağlı. Bu istekteki tüm uçuşların emisyon tahminlerinin hesaplandığı model sürümü.

ComputeScope3FlightEmissionsResponse

Kapsam 3 emisyon tahminlerini içeren uçuş listesi.

Alanlar
flight_emissions[]

Scope3FlightEmissions

Emisyon tahminlerinin yer aldığı uçuş segmentlerinin listesi.
model_version

ModelVersion

Bu yanıttaki tüm uçuşların emisyon tahminlerinin hesaplandığı model sürümü.

ComputeTypicalFlightEmissionsRequest

Tipik emisyonların isteneceği havaalanı (pazar) çiftlerinin listesi.

Alanlar
markets[]

Market

Zorunlu. Bu pazar çifti için normal uçuş emisyonu tahminlerini isteyin. En fazla 1.000 pazar istenebilir.

ComputeTypicalFlightEmissionsResponse

Yanıtta emisyonların yanı sıra model sürümü de yer alır.

Alanlar
typical_flight_emissions[]

TypicalFlightEmissions

Pazarın Normal Uçuş Emisyonu istendi.
model_version

ModelVersion

Bu yanıttaki tüm uçuşlar için normal uçuş emisyonu tahminlerinin hesaplandığı model sürümü.

ContrailsImpactBucket

Yoğunlaşma izlerinin ısınma etkisinin, toplam CO2e emisyonlarının etkisine kıyasla önemi.

Sıralamalar
CONTRAILS_IMPACT_UNSPECIFIED Yoğunlaşma izlerinin etkisi belirtilmemiştir.
CONTRAILS_IMPACT_NEGLIGIBLE Yoğunlaşma izlerinin etkisi, toplam CO2e emisyonlarına kıyasla ihmal edilebilir düzeydedir.
CONTRAILS_IMPACT_MODERATE Yoğunlaşma izlerinin etkisi, toplam CO2e emisyonlarıyla karşılaştırılabilir.
CONTRAILS_IMPACT_SEVERE Yoğunlaşma izlerinin etkisi, toplam CO2e emisyonlarının etkisinden daha yüksektir.

EasaLabelMetadata

EASA Uçuş Emisyon Etiketi ile ilgili meta veriler.

Alanlar
label_issue_date

Date

Etiketin düzenlendiği tarih.
label_expiry_date

Date

Etiketin geçerliliğinin sona ereceği tarih. Etiket bu tarihin sonuna kadar gösterilebilir.
label_version

string

Etiketin sürümü.
saf_discount_percentage

double

Etikete uygulanan sürdürülebilir uçak yakıtı (SAF) emisyon indirimi yüzdesi. Ondalık sayı olarak yüzde. Değerler [0,1] aralığındadır. Örneğin, 0,0021 değeri %0,21 anlamına gelir.

Bu indirim ve emisyonlardaki azalma, EASA etiketi tarafından bildirilir ancak bu API tarafından dağıtılan CO2e tahminlerine dahil edilmez.

EmissionsGramsPerPax

Koltuk sınıfı başına gruplandırılmış emisyon sonuçları.

Alanlar
first

int32

First class'taki bir yolcunun emisyonu gram cinsinden. Bu alan, uçakta first class koltuklar olup olmadığına bakılmaksızın her zaman hesaplanır ve doldurulur.
business

int32

Business class'ta bir yolcunun emisyonu (gram cinsinden). Bu alan, uçakta business class koltuklar olup olmadığına bakılmaksızın her zaman hesaplanır ve doldurulur.
premium_economy

int32

Premium ekonomi sınıfındaki bir yolcunun emisyonu gram cinsinden. Bu alan, uçakta premium ekonomi sınıfı koltuklar olup olmadığına bakılmaksızın her zaman hesaplanır ve doldurulur.
economy

int32

Ekonomi sınıfında bir yolcunun emisyonu (gram cinsinden). Bu alan, uçakta ekonomi sınıfı koltuklar olup olmadığına bakılmaksızın her zaman hesaplanır ve doldurulur.

Uçuş

Direkt uçuş emisyon tahminleri için tek bir istek öğesiyle ilgili tüm ayrıntılar.

Alanlar
origin

string

Zorunlu. Uçuşun kalkış noktasının IATA havaalanı kodu (ör. "LHR").
destination

string

Zorunlu. Uçuş varış noktasının IATA havaalanı kodu (ör. "JFK").
operating_carrier_code

string

Zorunlu. IATA hava yolu kodu (ör. "AA").
flight_number

int32

Zorunlu. Uçuş numarası (ör. 324)
departure_date

Date

Zorunlu. Kalkış havaalanının saat dilimindeki uçuş tarihi. Bugün veya gelecekteki bir tarih olmalıdır.

FlightWithEmissions

Emisyon tahminleriyle birlikte direkt uçuş.

Alanlar
flight

Flight

Tanımlayıcı. İstekteki uçuş tanımlayıcılarıyla eşleşir. Not: Tüm IATA kodları büyük harfle yazılır.
source

Source

İsteğe bağlı. Emisyon verilerinin kaynağı.
emissions_grams_per_pax

EmissionsGramsPerPax

İsteğe bağlı. Yolcu başına emisyon tahmini sayıları. Emisyonlar hesaplanamadıysa gösterilmez. Emisyonların hesaplanamamasının nedenlerinin listesi için ComputeFlightEmissions başlıklı makaleyi inceleyin.
easa_label_metadata

EasaLabelMetadata

İsteğe bağlı. EASA Uçuş Emisyon Etiketi ile ilgili meta veriler. Yalnızca emisyon veri kaynağı EASA olduğunda ayarlanır.
contrails_impact_bucket

ContrailsImpactBucket

İsteğe bağlı. Yoğunlaşma izlerinin ısınma etkisinin, toplam CO2e emisyonlarının etkisine kıyasla önemi.

Market

Bir çift havaalanı.

Alanlar
origin

string

Zorunlu. Uçuşun kalkış noktasının IATA havaalanı kodu (ör. "LHR").
destination

string

Zorunlu. Uçuş varış noktasının IATA havaalanı kodu (ör. "JFK").

ModelVersion

Seyahat Etkisi Modeli sürümü. Model sürümü oluşturma hakkında daha fazla bilgi için GitHub'a bakın.

Alanlar
major

int32

Ana sürümler: Metodolojideki büyük değişiklikler (ör. modele yeni veri kaynakları eklenmesi ve bunun sonucunda büyük çıktı değişiklikleri yapılması). Bu tür değişiklikler nadiren yapılır ve önceden duyurulur. Google Cloud API kurallarına uygun API sürümü değişiklikleri içerebilir.
minor

int32

Alt sürümler: Şema sürümlerinde tutarlı olsa da model parametrelerini veya uygulamayı değiştiren model değişiklikleri.
patch

int32

Yama sürümleri: Model uygulamasındaki hataları veya yanlışlıkları gidermeyi amaçlayan uygulama değişiklikleri.
dated

string

Tarihli sürümler: Model veri kümeleri, yenilenen giriş verileriyle yeniden oluşturulur ancak algoritmalarda düzenli olarak değişiklik yapılmaz.

Scope3FlightEmissions

Emisyon tahminleriyle birlikte Kapsam 3 uçuşu.

Alanlar
flight

Scope3FlightSegment

Tanımlayıcı. İstekteki uçuş tanımlayıcılarıyla eşleşir.
wtw_emissions_grams_per_pax

int64

İsteğe bağlı. İstenen bilgilere göre yolcu başına toplam uçuş emisyonları (kaynaktan depoya ve depodan uyanmaya kadar olan emisyonların toplamı). Bu, toplam emisyondur ve TTW veya WTT emisyonlarını kullanmak için belirli nedenleriniz yoksa bu sayıyı kullanmanız gerekir.
ttw_emissions_grams_per_pax

int64

İsteğe bağlı. İstenen bilgilere göre yolcu başına yakıttan kalkışa kadar olan uçuş emisyonları.
wtt_emissions_grams_per_pax

int64

İsteğe bağlı. İstenen bilgilere göre yolcu başına yakıt üretiminden depolamaya kadar olan uçuş emisyonları.
source

Scope3DataType

İsteğe bağlı. Emisyon verilerinin kaynağı.

Scope3DataType

Kapsam 3 emisyonlarını hesaplamak için kullanılan eşleme türü. Bu, Kapsam 3 yanıtı için kullanılır ve emisyonları hesaplamak için hangi yöntemin kullanıldığını işaretler.

Sıralamalar
SCOPE3_DATA_TYPE_UNSPECIFIED Belirtilmemiş veri türü.
TIM_EMISSIONS Başlangıç noktası, varış noktası, kargo şirketi, uçuş numarası, kalkış tarihi ve yıla göre TIM tabanlı emisyonlar.
TYPICAL_FLIGHT_EMISSIONS Kalkış noktası, varış noktası ve yıla göre normal uçuş emisyonları.
DISTANCE_BASED_EMISSIONS Kat edilen mesafeye ve yıla göre mesafeye dayalı emisyonlar.

Scope3FlightSegment

Kapsam 3 emisyonlarının getirildiği uçuş parametreleri.

Alanlar
departure_date

Date

Zorunlu. Kalkış havaalanının saat dilimindeki uçuş tarihi. Normal uçuş ve mesafeye dayalı emisyon modelleri için yalnızca yıl gereklidir (ay ve gün değerleri yoksayılır. Bu nedenle, bu durumlarda değerler atlanabilir, 0 olarak ayarlanabilir veya geçerli bir tarih olarak ayarlanabilir). Benzer şekilde, TIM emisyonları için belirli bir tarih sağlanmazsa tipik uçuş (veya mesafeye dayalı) emisyonlarına geri döneriz.
cabin_class

CabinClass

Zorunlu. Uçuşun kabin sınıfı.
origin

string

İsteğe bağlı. Uçuşun kalkış noktası için 3 karakterli IATA havaalanı kodu (ör. YVR). Bu, varış noktası, operatör ve uçuş numarasıyla birlikte sağlandığında belirli bir uçuşu eşleştirmek için kullanılır. Eşleşme yoksa önce uçuşu, sağlanan başlangıç ve varış havaalanları arasındaki normal bir uçuşla eşleştirmeye çalışırız. Aksi takdirde, uçuş mesafesi sağlanırsa mesafeye dayalı emisyon modelini kullanırız.
destination

string

İsteğe bağlı. Uçuş varış noktası için 3 karakterlik IATA havaalanı kodu (ör. ICN). Kalkış yeri, operatör ve uçuş numarasıyla birlikte sağlanırsa belirli bir uçuşu eşleştirmek için kullanılır. Eşleşme yoksa önce uçuşu, sağlanan başlangıç ve varış havaalanları arasındaki normal bir uçuşla eşleştirmeye çalışırız. Aksi takdirde, uçuş mesafesi sağlanırsa mesafeye dayalı emisyon modelini kullanırız.
carrier_code

string

İsteğe bağlı. 2 karakterli IATA taşıyıcı kodu (ör. KE). Belirli bir uçuşun eşleştirilmesi isteniyorsa bu gereklidir. Aksi takdirde, bu özellik normal uçuş ve mesafeye dayalı emisyon modellerinde kullanılmaz. Bu, hem işletim hem de pazarlama taşıyıcı kodu olabilir (ör. ortak uçuş desteklenir).
flight_number

int32

İsteğe bağlı. 4 basamağa kadar uçuş numarası, örneğin [1, 9999] aralığında 71. Bu, kalkış noktası, varış noktası ve taşıyıcı ile birlikte bir uçuş numarası belirtilmişse belirli bir uçuşu eşleştirmek için ilk olarak kullanılır. Uçuş numarası belirtilmemişse önce uçuşu, belirtilen kalkış ve varış noktası havaalanları arasındaki normal bir uçuşla eşleştirmeye çalışırız. Bu işlem başarısız olursa ve/veya kalkış ile varış noktası bilgisi sağlanmazsa sağlanan uçuş mesafesine göre mesafeye dayalı emisyon modelini kullanırız.
distance_km

int64

İsteğe bağlı. Kilometre cinsinden mesafe (ör. 2423), [1, 2.5e16) km. Bu, kalkış ve varış noktası sağlanmadığında veya eşleşen normal uçuş olmadığında bir uçuşu mesafeye dayalı emisyonlarla eşleştirmek için kullanılır.

CabinClass

Uçuşun kabin sınıfı.

Sıralamalar
CABIN_CLASS_UNSPECIFIED Belirtilmemiş kabin sınıfı.
ECONOMY Ekonomi sınıfı.
PREMIUM_ECONOMY Premium ekonomi sınıfı
BUSINESS Business class.
FIRST Birinci sınıf.

Kaynak

Emisyon verilerinin kaynağı.

Sıralamalar
SOURCE_UNSPECIFIED Emisyon verilerinin kaynağı belirtilmemiş.
TIM Emisyon verileri Seyahat Etkisi Modeli'nden alınır.
EASA Emisyon verileri, EASA çevre etiketlerinden alınır.

TypicalFlightEmissions

Belirli bir pazar için normal uçuş emisyonu tahminleri

Alanlar
market

Market

Tanımlayıcı. İstekteki uçuş tanımlayıcılarıyla eşleşir. Not: Tüm IATA kodları büyük harfle yazılır.
emissions_grams_per_pax

EmissionsGramsPerPax

İsteğe bağlı. İstenen pazar için yolcu başına normal uçuş emisyonları. Tipik emisyonlar hesaplanamadıysa gösterilmez. Tipik uçuş emisyonlarının hesaplanamamasının nedenlerinin listesi için GitHub'a bakın.