Method: flights.computeScope3FlightEmissions

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.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek metni

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "flights": [
    {
      object (Scope3FlightSegment)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Alanlar
flights[]

object (Scope3FlightSegment)

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

object (ModelVersion)

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

Yanıt metni

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

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "flightEmissions": [
    {
      object (Scope3FlightEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Alanlar
flightEmissions[]

object (Scope3FlightEmissions)

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

object (ModelVersion)

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

Scope3FlightSegment

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

JSON gösterimi 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
Alanlar
departureDate

object (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.
cabinClass

enum (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.
carrierCode

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

integer

İ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.
distanceKm

string (int64 format)

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

Scope3FlightEmissions

Emisyon tahminleriyle birlikte Kapsam 3 uçuşu.

JSON gösterimi 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3DataType)
}
Alanlar
flight

object (Scope3FlightSegment)

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

string (int64 format)

İ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.
ttwEmissionsGramsPerPax

string (int64 format)

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

string (int64 format)

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

enum (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.