Method: flights.computeScope3FlightEmissions

यह फ़ंक्शन, स्कोप 3 की रिपोर्टिंग के लिए, फ़्लाइट के सेगमेंट के सेट के लिए जीएचजी उत्सर्जन के अनुमानों को वापस लाता है.

जवाब में, इनपुट Scope3FlightSegment फ़्लाइट सेगमेंट से मेल खाने वाली सभी एंट्री शामिल होंगी. ये एंट्री, उसी क्रम में होंगी जिस क्रम में इनपुट दिया गया था. अनुमानों का हिसाब, कैस्केडिंग लॉजिक का इस्तेमाल करके लगाया जाएगा. इसके लिए, उपलब्ध पहला लॉजिक इस्तेमाल किया जाएगा:

  1. टीआईएम के आधार पर उत्सर्जन का अनुमान, origin, destination, carrier, flightNumber, departureDate, और cabinClass के हिसाब से दिया गया है.
  2. origin, destination, departureDate में साल, और cabinClass के हिसाब से फ़्लाइट से होने वाला सामान्य उत्सर्जन.
  3. दूरी के आधार पर उत्सर्जन की गणना, distanceKm, departureDate में साल, और cabinClass का इस्तेमाल करके की जाती है.

अगर इस कैलेंडर साल में किसी फ़्लाइट का अनुरोध किया गया है, तो हम टियर 1 के उत्सर्जन का हिसाब लगाने की सुविधा नहीं देते. इसके बजाय, टियर 2 या 3 के उत्सर्जन का हिसाब लगाया जाएगा. अगर अनुरोध की गई फ़्लाइट इस साल के कैलेंडर में नहीं है, तो हम कोई जवाब नहीं देंगे. हमारा सुझाव है कि आने वाली फ़्लाइट के लिए, computeFlightEmissions एपीआई का इस्तेमाल करें.

अगर किसी फ़्लाइट के लिए, तीनों में से किसी भी तरीके से अनुमान उपलब्ध नहीं हैं, तो जवाब में Scope3FlightEmissions ऑब्जेक्ट दिखेगा. इसमें उत्सर्जन के फ़ील्ड खाली होंगे. अनुरोध को अब भी पूरा माना जाएगा. आम तौर पर, उत्सर्जन के अनुमान की जानकारी तब नहीं मिलती, जब सर्वर को फ़्लाइट की जानकारी नहीं होती. उदाहरण के लिए, कोई फ़्लाइट मौजूद नहीं है या अनुरोध किए गए रूट के लिए, फ़्लाइट से होने वाले सामान्य उत्सर्जन की जानकारी उपलब्ध नहीं है.

अगर ये शर्तें पूरी नहीं होती हैं, तो अनुरोध पूरा नहीं होगा और INVALID_ARGUMENT गड़बड़ी दिखेगी:

  • अनुरोध में 1,000 से ज़्यादा फ़्लाइट लेग शामिल हैं.
  • इनपुट किए गए फ़्लाइट लेग में एक या एक से ज़्यादा आइडेंटिफ़ायर मौजूद नहीं हैं. उदाहरण के लिए, TIM_EMISSIONS या TYPICAL_FLIGHT_EMISSIONS टाइप के मिलान के लिए, मान्य दूरी के बिना मूल जगह/मंज़िल की जानकारी मौजूद नहीं है या DISTANCE_BASED_EMISSIONS टाइप के मिलान के लिए दूरी की जानकारी मौजूद नहीं है. अगर आपको दूरी के हिसाब से उत्सर्जन का अनुमान लगाना है या दूरी के हिसाब से उत्सर्जन का अनुमान लगाना है, तो आपको दूरी की जानकारी देनी होगी.
  • फ़्लाइट की तारीख 2019 से पहले की है (स्कोप 3 का डेटा सिर्फ़ 2019 और उसके बाद के लिए उपलब्ध है).
  • फ़्लाइट की दूरी 0 या इससे कम हो.
  • केबिन क्लास की जानकारी मौजूद नहीं है.

अनुरोध को फ़ॉलबैक लॉजिक के साथ प्रोसेस किया जाता है. इसलिए, यह मुमकिन है कि गलत तरीके से कॉन्फ़िगर किए गए अनुरोधों से, फ़ॉलबैक तरीकों का इस्तेमाल करके उत्सर्जन के मान्य अनुमान मिलें. उदाहरण के लिए, अगर किसी अनुरोध में फ़्लाइट नंबर गलत है, लेकिन उसमें शुरुआती और मंज़िल की जगह की जानकारी दी गई है, तो भी अनुरोध पूरा हो जाएगा. हालांकि, लौटाए गए उत्सर्जन के आंकड़े सिर्फ़ फ़्लाइट से होने वाले सामान्य उत्सर्जन पर आधारित होंगे. इसी तरह, अगर किसी अनुरोध में फ़्लाइट से होने वाले उत्सर्जन के बारे में जानकारी नहीं दी गई है, लेकिन उसमें दूरी के बारे में मान्य जानकारी दी गई है, तो सिर्फ़ दूरी के आधार पर उत्सर्जन की जानकारी के हिसाब से अनुरोध पूरा किया जा सकता है. इसलिए, यह पक्का करने के लिए कि नतीजे उम्मीद के मुताबिक हैं, वापस किए गए उत्सर्जन (source) के सोर्स की जांच करनी चाहिए.

एचटीटीपी अनुरोध

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

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "flights": [
    {
      object (Scope3FlightSegment)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
फ़ील्ड
flights[]

object (Scope3FlightSegment)

ज़रूरी है. उन फ़्लाइट के लिए उत्सर्जन का अनुमान लगाएं.
modelVersion

object (ModelVersion)

ज़रूरी नहीं. मॉडल का वह वर्शन जिसके तहत इस अनुरोध में शामिल सभी फ़्लाइट के लिए, उत्सर्जन के अनुमान का हिसाब लगाया गया था.

जवाब का मुख्य भाग

स्कोप 3 के अनुमानित कार्बन उत्सर्जन के साथ फ़्लाइट की सूची.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "flightEmissions": [
    {
      object (Scope3FlightEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
फ़ील्ड
flightEmissions[]

object (Scope3FlightEmissions)

फ़्लाइट के सेगमेंट की सूची, जिसमें उत्सर्जन के अनुमान दिए गए हों.
modelVersion

object (ModelVersion)

मॉडल का वह वर्शन जिसके तहत, इस जवाब में शामिल सभी फ़्लाइट के लिए उत्सर्जन के अनुमान का हिसाब लगाया गया था.

Scope3FlightSegment

फ़्लाइट के वे पैरामीटर जिनके आधार पर स्कोप 3 के उत्सर्जन का डेटा फ़ेच किया जाता है.

JSON के काेड में दिखाना 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (Scope3FlightSegment.CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
फ़ील्ड
departureDate

object (Date)

ज़रूरी है. फ़्लाइट की तारीख, ऑरिजिन एयरपोर्ट के टाइम ज़ोन के हिसाब से. फ़्लाइट से होने वाले सामान्य उत्सर्जन और दूरी के आधार पर उत्सर्जन के मॉडल के लिए, सिर्फ़ साल की जानकारी ज़रूरी होती है. महीने और दिन की वैल्यू को अनदेखा कर दिया जाता है. इसलिए, इन वैल्यू को हटाया जा सकता है, 0 पर सेट किया जा सकता है या उन मामलों के लिए मान्य तारीख पर सेट किया जा सकता है. इसी तरह, अगर टीआईएम उत्सर्जन के लिए कोई तारीख नहीं दी जाती है, तो हम फ़्लाइट (या दूरी के आधार पर) से होने वाले सामान्य उत्सर्जन का इस्तेमाल करेंगे.
cabinClass

enum (Scope3FlightSegment.CabinClass)

ज़रूरी है. फ़्लाइट की केबिन क्लास.
origin

string

ज़रूरी नहीं. फ़्लाइट के शुरुआत की जगह वाले हवाई अड्डे के लिए, तीन वर्णों वाला आईएटीए हवाई अड्डे का कोड. उदाहरण के लिए, YVR. इसका इस्तेमाल, किसी फ़्लाइट की जानकारी को मैच करने के लिए किया जाता है. इसके लिए, मंज़िल, एयरलाइन, और फ़्लाइट नंबर की जानकारी देना ज़रूरी है. अगर कोई मैच नहीं मिलता है, तो हम सबसे पहले, फ़्लाइट को मूल और मंज़िल वाले एयरपोर्ट के बीच की सामान्य फ़्लाइट से मैच करने की कोशिश करेंगे. अगर फ़्लाइट की दूरी की जानकारी दी गई है, तो हम दूरी के हिसाब से उत्सर्जन का अनुमान लगाने वाले मॉडल का इस्तेमाल करेंगे.
destination

string

ज़रूरी नहीं. फ़्लाइट के डेस्टिनेशन के लिए, तीन वर्णों वाला आईएटीए हवाई अड्डे का कोड, जैसे कि ICN. अगर इसे उड़ान भरने की जगह, एयरलाइन, और फ़्लाइट नंबर के साथ दिया जाता है, तो इसका इस्तेमाल किसी फ़्लाइट से मिलान करने के लिए किया जाता है. अगर कोई मैच नहीं मिलता है, तो हम सबसे पहले, फ़्लाइट को मूल और मंज़िल वाले एयरपोर्ट के बीच की सामान्य फ़्लाइट से मैच करने की कोशिश करेंगे. अगर फ़्लाइट की दूरी की जानकारी दी गई है, तो हम दूरी के हिसाब से उत्सर्जन का अनुमान लगाने वाले मॉडल का इस्तेमाल करेंगे.
carrierCode

string

ज़रूरी नहीं. दो वर्ण वाला आईएटीए कैरियर कोड, जैसे कि KE. अगर आपको किसी फ़्लाइट से जुड़ी जानकारी चाहिए, तो यह जानकारी देना ज़रूरी है. इसके अलावा, इसका इस्तेमाल फ़्लाइट और दूरी के आधार पर उत्सर्जन के मॉडल के लिए नहीं किया जाता है. यह ऑपरेटिंग और मार्केटिंग कैरियर कोड, दोनों हो सकता है. जैसे, कोडशेयरिंग को शामिल किया गया है.
flightNumber

integer

ज़रूरी नहीं. ज़्यादा से ज़्यादा चार अंकों वाला फ़्लाइट नंबर, जैसे कि 71, [1, 9999] के बीच का होना चाहिए. इसका इस्तेमाल सबसे पहले, किसी फ़्लाइट से जुड़ी जानकारी को मैच करने के लिए किया जाता है. ऐसा तब होता है, जब फ़्लाइट नंबर के साथ-साथ, शुरुआती जगह, मंज़िल, और कैरियर की जानकारी दी गई हो. अगर फ़्लाइट नंबर नहीं दिया गया है, तो हम सबसे पहले फ़्लाइट को, शुरुआत और मंज़िल वाले एयरपोर्ट के बीच चलने वाली किसी सामान्य फ़्लाइट से मैच करने की कोशिश करेंगे. अगर ऐसा नहीं होता है और/या ऑरिजिन और डेस्टिनेशन की जानकारी नहीं दी जाती है, तो हम फ़्लाइट की दूरी के आधार पर उत्सर्जन का अनुमान लगाने वाले मॉडल का इस्तेमाल करेंगे.
distanceKm

string (int64 format)

ज़रूरी नहीं. किलोमीटर में दूरी, जैसे कि 2423, [1, 2.5e16) कि॰मी॰. इसका इस्तेमाल, दूरी के हिसाब से उत्सर्जन का पता लगाने के लिए किया जाता है. ऐसा तब किया जाता है, जब मूल जगह और मंज़िल की जानकारी नहीं दी गई हो या मिलती-जुलती सामान्य फ़्लाइट उपलब्ध न हों.

Scope3FlightSegment.CabinClass

फ़्लाइट की केबिन क्लास.

Enums
CABIN_CLASS_UNSPECIFIED केबिन क्लास की जानकारी नहीं दी गई है.
ECONOMY इकॉनमी क्लास.
PREMIUM_ECONOMY प्रीमियम इकॉनमी क्लास.
BUSINESS बिज़नेस क्लास.
FIRST फ़र्स्ट क्लास.

Scope3FlightEmissions

स्कोप 3 के तहत आने वाली फ़्लाइट, जिसमें उत्सर्जन के अनुमान शामिल हैं.

JSON के काेड में दिखाना 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3FlightEmissions.Scope3DataType)
}
फ़ील्ड
flight

object (Scope3FlightSegment)

आइडेंटिफ़ायर. अनुरोध में दिए गए फ़्लाइट आइडेंटिफ़ायर से मेल खाता हो.
wtwEmissionsGramsPerPax

string (int64 format)

ज़रूरी नहीं. अनुरोध की गई जानकारी के आधार पर, हर यात्री के हिसाब से फ़्लाइट से होने वाला कुल उत्सर्जन (वेल-टू-टैंक और टैंक-टू-वेक का कुल उत्सर्जन). यह कुल उत्सर्जन है. अगर आपके पास टीटीडब्ल्यू या डब्ल्यूटीटी उत्सर्जन का इस्तेमाल करने की कोई खास वजह नहीं है, तो आपको इस नंबर का इस्तेमाल करना चाहिए.
ttwEmissionsGramsPerPax

string (int64 format)

ज़रूरी नहीं. मांगी गई जानकारी के आधार पर, हर यात्री के हिसाब से टैंक से वेक तक के फ़्लाइट का उत्सर्जन.
wttEmissionsGramsPerPax

string (int64 format)

ज़रूरी नहीं. अनुरोध की गई जानकारी के आधार पर, हर यात्री के हिसाब से फ़्लाइट के उत्सर्जन की जानकारी.
source

enum (Scope3FlightEmissions.Scope3DataType)

ज़रूरी नहीं. उत्सर्जन के डेटा का सोर्स.

Scope3FlightEmissions.Scope3DataType

स्कोप 3 के उत्सर्जन का हिसाब लगाने के लिए इस्तेमाल किया गया मैचिंग टाइप. इसका इस्तेमाल स्कोप 3 के जवाब के लिए किया जाता है. इससे यह पता चलता है कि उत्सर्जन का हिसाब लगाने के लिए, कौनसे तरीके का इस्तेमाल किया गया था.

Enums
SCOPE3_DATA_TYPE_UNSPECIFIED डेटा टाइप की जानकारी नहीं दी गई है.
TIM_EMISSIONS TIM के आधार पर उत्सर्जन की जानकारी. इसमें यात्रा की शुरुआत की जगह, मंज़िल, कैरियर, फ़्लाइट नंबर, जाने की तारीख, और साल शामिल होता है.
TYPICAL_FLIGHT_EMISSIONS फ़्लाइट की शुरुआत की जगह, मंज़िल, और साल के हिसाब से, फ़्लाइट से होने वाला सामान्य उत्सर्जन.
DISTANCE_BASED_EMISSIONS तय की गई दूरी और साल के आधार पर, दूरी के हिसाब से उत्सर्जन.