Method: flights.computeScope3FlightEmissions

Kapsam 3 raporlaması için bir dizi uçuş segmentine ait sera gazı emisyonu tahminlerini alır.

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 mantık kullanılır):

  1. origin, destination, carrier, flightNumber, departureDate ve cabinClass için TIM tabanlı emisyonlar.
  2. origin, destination, departureDate yılı ve cabinClass için tipik uçuş emisyonları.
  3. Mesafeye dayalı emisyonlar distanceKm, departureDate yılı ve cabinClass kullanılarak hesaplanır.

Bu takvim yılında talep edilen gelecekteki bir uçuş varsa 1. kademe emisyonları desteklemiyoruz ve 2. veya 3. kademe emisyonlara geri dönüyoruz. İstenen gelecekteki uçuş bu takvim yılında değilse boş bir yanıt döndürürüz. Gelecekteki uçuşlar için computeFlightEmissions API'nin kullanılmasını öneririz.

Belirli bir uçuş için üç yöntemden herhangi biriyle tahmin yapılamıyorsa yanıt, boş emisyon alanları içeren bir Scope3FlightEmissions nesnesi döndürür. İstek yine de başarılı kabul edilir. Emisyon tahminlerinin eksik olması genellikle uçuşun sunucu tarafından bilinmediği durumlarda (ör. belirli bir uçuşun olmaması veya istenen çift için normal uçuş emisyonlarının mevcut olmaması) meydana gelir.

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

  • İstek,1.000'den fazla uçuş ayağı içeriyor.
  • Girilen uçuş ayağında bir veya daha fazla tanımlayıcı eksik. Örneğin, TIM_EMISSIONS veya TYPICAL_FLIGHT_EMISSIONS türü eşleştirme için geçerli bir mesafe olmadan eksik başlangıç/varış noktası ya da DISTANCE_BASED_EMISSIONS türü eşleştirme için eksik mesafe (mesafeye dayalı emisyonlara geri dönmek veya mesafeye dayalı emisyon tahmini almak istiyorsanız bir 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.
  • Kabin sınıfı eksik.

İstek, yedek mantığıyla işlendiğinden, yanlış yapılandırılmış isteklerin yedek yöntemler kullanılarak geçerli emisyon tahminleri döndürmesi mümkündür. Örneğin, bir istekte uçuş numarası yanlışsa 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 dayalı olur. Benzer şekilde, bir istekte tipik bir uçuş emisyonu isteğinin kalkış noktası 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 (source) kaynağı 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ıdır. Bu istekteki tüm uçuşlar için emisyon tahminlerinin hesaplandığı model sürümü.

Yanıt metni

Kapsam 3 emisyon tahminlerini içeren uçuşların 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 tahminleri içeren uçuş segmentlerinin listesi.
modelVersion

object (ModelVersion)

Bu yanıttaki tüm uçuşlar için 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 (Scope3FlightSegment.CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
Alanlar
departureDate

object (Date)

Zorunlu. Kalkış havalimanının saat diliminde 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 atlanabilir, 0 olarak ayarlanabilir veya geçerli bir tarihe 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 (Scope3FlightSegment.CabinClass)

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

string

İsteğe bağlıdır. Uçuşun kalkış yeri için 3 karakterli IATA havaalanı kodu (ör. YVR). Varış yeri, hava yolu şirketi 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 öncelikle uçuşu, belirtilen kalkış ve varış havaalanları arasındaki tipik bir uçuşla eşleştirmeye çalışırız. Aksi takdirde, uçuş mesafesi sağlanmışsa mesafeye dayalı emisyon modelini kullanırız.
destination

string

İsteğe bağlıdır. Uçuşun varış noktası için 3 karakterli IATA havaalanı kodu (ör. ICN). Bu, kalkış noktası, hava yolu şirketi 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 öncelikle uçuşu, belirtilen kalkış ve varış havaalanları arasındaki tipik bir uçuşla eşleştirmeye çalışırız. Aksi takdirde, uçuş mesafesi sağlanmışsa mesafeye dayalı emisyon modelini kullanırız.
carrierCode

string

İsteğe bağlıdır. 2 karakterli IATA hava yolu şirketi kodu (ör. KE). Belirli bir uçuş eşleştirmesi isteniyorsa bu gereklidir. Aksi takdirde, bu değer tipik uçuş ve mesafeye dayalı emisyon modelleri için kullanılmaz. Bu, hem işleten hem de pazarlayan hava yolu şirketinin kodu olabilir (kod paylaşımı dahildir).
flightNumber

integer

İsteğe bağlıdır. En fazla 4 haneli uçuş numarası (ör. 71, [1, 9999] arasında). Bu, kalkış noktası, varış noktası ve hava yolu şirketinin yanı sıra bir uçuş numarası belirtilmişse öncelikle belirli bir uçuşu eşleştirmek için kullanılır. Uçuş numarası belirtilmezse öncelikle uçuşu, belirtilen kalkış ve varış havaalanları arasındaki tipik bir uçuşla eşleştirmeye çalışırız. Bu işlem başarısız olursa ve/veya kalkış ve varış noktası 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), [1, 1e12) km. Bu, kalkış ve varış noktası sağlanmadığında veya eşleşen tipik uçuş olmadığında bir uçuşu mesafeye dayalı emisyonlarla eşleştirmek için kullanılır.

Scope3FlightSegment.CabinClass

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

Sıralamalar
CABIN_CLASS_UNSPECIFIED Kabin sınıfı belirtilmemiş.
ECONOMY Ekonomi sınıfı.
PREMIUM_ECONOMY Premium ekonomi sınıfı.
BUSINESS Business class.
FIRST First class.

Scope3FlightEmissions

Emisyon tahminleri içeren kapsam 3 uçuşu.

JSON gösterimi 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3FlightEmissions.Scope3DataType),
  "modelVersion": string
}
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ıdır. İstenen bilgilere göre yolcu başına toplam uçuş emisyonu (kaynaktan depoya ve depodan kullanıma emisyonların toplamı). Bu, toplam emisyon değeridir. TTW veya WTT emisyonlarını kullanmak için özel 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 tanktan uçağa uçuş emisyonları.
wttEmissionsGramsPerPax

string (int64 format)

İsteğe bağlıdır. İstenen bilgilere göre yolcu başına kuyudan depoya uçuş emisyonları.
source

enum (Scope3FlightEmissions.Scope3DataType)

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

string

İsteğe bağlıdır. Emisyonların hesaplandığı model sürümü.

Scope3FlightEmissions.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ı belirtir.

Sıralamalar
SCOPE3_DATA_TYPE_UNSPECIFIED Belirtilmemiş veri türü.
TIM_EMISSIONS Kalkış noktası, varış noktası, hava yolu şirketi, uçuş numarası, kalkış tarihi ve yılına 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.