Method: flights.computeScope3FlightEmissions

Kapsam 3 raporlaması için bir dizi uçuş segmentiyle ilgili 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 aynı sırada 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 göz önüne alındığında TIM'e dayalı emisyonlar.
  2. origin, destination, departureDate yılı ve cabinClass göz önüne alındığında tipik uçuş emisyonları.
  3. distanceKm, departureDate yılı ve cabinClass kullanılarak hesaplanan mesafeye dayalı emisyonlar.

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 gelecek 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 boş emisyon alanlarına sahip bir Scope3FlightEmissions nesnesi döndürülür. İstek yine de başarılı kabul edilir. Genellikle, emisyon tahminlerinin eksik olması, uçuşun sunucu tarafından bilinmediği (ör. belirli bir uçuşun olmaması veya istenen çift için normal uçuş emisyonlarının mevcut olmaması) durumlarda görülür.

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 (3. kapsam 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, bir istekte tipik bir uçuş emisyonu isteği için 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 döndürülen 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 metni 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ıdır. Bu istekteki tüm uçuşların emisyon tahminlerinin hesaplandığı model sürümü.

Yanıt gövdesi

3. Kapsam 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 normal 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ıdır. Uçuşun kalkış noktası için 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ış noktası 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ıdır. Uçuş varış noktasının 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ış noktası 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ıdır. IATA hava yolu kodu (ör. KE). Belirli bir uçuşla eşleşme 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ıdır. Uçuş numarası (ör. 71). Bu, kalkış yeri, varış yeri ve taşıyıcı ile birlikte bir uçuş numarası belirtilmişse önce belirli bir uçuşu eşleştirmek için 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ı bilgileri sağlanmazsa, sağlanan uçuş mesafesine göre mesafeye dayalı emisyon modelini kullanırız.
distanceKm

string (int64 format)

İsteğe bağlıdır. Kilometre cinsinden mesafe (ör. 2423). 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. Bu alan, 0 ile 2,5e16 km arasındaki değerleri destekler.

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 Kapsam 3 uçuşu.

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

object (Scope3FlightSegment)

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

string (int64 format)

İsteğe bağlıdır. İ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ıdır. İstenen bilgilere göre yolcu başına yakıttan kalkışa kadar olan uçuş emisyonları.
wttEmissionsGramsPerPax

string (int64 format)

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

enum (Scope3DataType)

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

Scope3DataType

Kapsam 3 emisyonlarını hesaplamak için kullanılan eşleşme 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.