Method: flights.computeFlightEmissions

उत्सर्जन के अनुमान पाने के लिए स्टेटलेस तरीका. उत्सर्जन के अनुमान का हिसाब लगाने के तरीके के बारे में जानकारी, GitHub पर उपलब्ध है

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

  • सर्वर के पास फ़्लाइट की जानकारी उपलब्ध नहीं है.
  • फ़्लाइट की इनपुट लेग में एक या एक से ज़्यादा आइडेंटिफ़ायर मौजूद नहीं हैं.
  • फ़्लाइट की तारीख बीत चुकी है.
  • मॉडल में, इस तरह के विमान का इस्तेमाल नहीं किया जा सकता.
  • सीट का कॉन्फ़िगरेशन मौजूद नहीं है.

अनुरोध में ज़्यादा से ज़्यादा 1,000 फ़्लाइट लेग हो सकते हैं. अगर अनुरोध में 1,000 से ज़्यादा डायरेक्ट फ़्लाइट हैं, तो INVALID_ARGUMENT गड़बड़ी का मैसेज दिखेगा.

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

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

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

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

अनुरोध के मुख्य भाग में, नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

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

object (Flight)

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

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

flights.computeFlightEmissions रिस्पॉन्स के लिए आउटपुट की परिभाषा.

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

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

object (FlightWithEmissions)

उत्सर्जन के अनुमान के साथ फ़्लाइट लेग की सूची.
modelVersion

object (ModelVersion)

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

फ़्लाइट

डायरेक्ट फ़्लाइट से होने वाले उत्सर्जन के अनुमान के लिए, किसी एक अनुरोध वाले आइटम से जुड़ी सभी जानकारी.

JSON के काेड में दिखाना 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
फ़ील्ड
origin

string

ज़रूरी है. फ़्लाइट के ऑरिजिन एयरपोर्ट का आईएटीए कोड, जैसे कि "LHR".
destination

string

ज़रूरी है. फ़्लाइट के डेस्टिनेशन एयरपोर्ट का आईएटीए कोड, जैसे कि "JFK".
operatingCarrierCode

string

ज़रूरी है. कैरियर का आईएटीए कोड, जैसे कि "AA".
flightNumber

integer

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

object (Date)

ज़रूरी है. ऑरिजिन एयरपोर्ट के टाइम ज़ोन के हिसाब से, फ़्लाइट की तारीख. तारीख, मौजूदा या आने वाले समय की होनी चाहिए.

तारीख

कैलेंडर की पूरी या कुछ तारीख दिखाता है, जैसे कि जन्मदिन. दिन का समय और टाइम ज़ोन, कहीं और बताया गया है या यह जानकारी ज़रूरी नहीं है. तारीख, ग्रेगोरियन कैलेंडर के हिसाब से होती है. यह इनमें से किसी एक को दिखा सकता है:

  • साल, महीने, और दिन की वैल्यू शून्य से ज़्यादा होनी चाहिए.
  • साल के तौर पर शून्य के साथ महीना और दिन (उदाहरण के लिए, सालगिरह).
  • साल, जिसमें महीना और दिन शून्य है.
  • साल और महीना, जिसमें दिन की वैल्यू शून्य हो. उदाहरण के लिए, क्रेडिट कार्ड के खत्म होने की तारीख.

मिलते-जुलते टाइप:

JSON के काेड में दिखाना 
{
  "year": integer,
  "month": integer,
  "day": integer
}
फ़ील्ड
year

integer

तारीख का साल. यह संख्या 1 से 9999 के बीच होनी चाहिए. अगर साल के बिना तारीख बतानी है, तो 0 डालें.
month

integer

साल का महीना. यह 1 से 12 के बीच की कोई संख्या होनी चाहिए. इसके अलावा, महीने और दिन के बिना साल बताने के लिए, 0 डाला जा सकता है.
day

integer

महीने का दिन. यह वैल्यू 1 से 31 के बीच की होनी चाहिए. साथ ही, यह साल और महीने के लिए मान्य होनी चाहिए. इसके अलावा, साल या साल और महीने के लिए 0 भी डाला जा सकता है, जहां दिन की वैल्यू का कोई मतलब नहीं है.

FlightWithEmissions

उत्सर्जन के अनुमान के साथ सीधी फ़्लाइट.

JSON के काेड में दिखाना 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
फ़ील्ड
flight

object (Flight)

ज़रूरी है. यह अनुरोध में मौजूद फ़्लाइट आइडेंटिफ़ायर से मेल खाता है. ध्यान दें: सभी आईएटीए कोड कैपिटल लेटर में होते हैं.
source

enum (Source)

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

object (EmissionsGramsPerPax)

ज़रूरी नहीं. हर यात्री के हिसाब से उत्सर्जन के अनुमानित आंकड़े. अगर उत्सर्जन का हिसाब नहीं लगाया जा सका, तो यह एट्रिब्यूट मौजूद नहीं होगा. उत्सर्जन का हिसाब न लगा पाने की वजहों की सूची के लिए, flights.computeFlightEmissions देखें.
easaLabelMetadata

object (EasaLabelMetadata)

ज़रूरी नहीं. ईएएसए फ़्लाइट के उत्सर्जन से जुड़े लेबल का मेटाडेटा. सिर्फ़ तब सेट करें, जब उत्सर्जन का डेटा सोर्स EASA हो.
contrailsImpactBucket

enum (ContrailsImpactBucket)

ज़रूरी नहीं. CO2e उत्सर्जन के कुल असर की तुलना में, कॉन्ट्रेल से होने वाली गर्मी के असर की अहमियत.

स्रोत

उत्सर्जन के डेटा का सोर्स.

Enums
SOURCE_UNSPECIFIED उत्सर्जन के डेटा के सोर्स की जानकारी नहीं दी गई है.
TIM उत्सर्जन का डेटा, ट्रैवल इंपैक्ट मॉडल से लिया गया है.
EASA उत्सर्जन का डेटा, ईएएसए के पर्यावरण लेबल से लिया गया है.

EasaLabelMetadata

ईएएसए फ़्लाइट के उत्सर्जन से जुड़े लेबल का मेटाडेटा.

JSON के काेड में दिखाना 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
फ़ील्ड
labelIssueDate

object (Date)

लेबल जारी करने की तारीख.
labelExpiryDate

object (Date)

लेबल की समयसीमा खत्म होने की तारीख. लेबल को इस तारीख तक दिखाया जा सकता है.
labelVersion

string

लेबल का वर्शन.
safDiscountPercentage

number

लेबल पर लागू होने वाली, सस्टेनेबल एविएशन फ़्यूल (एसएएफ़) के उत्सर्जन की छूट का प्रतिशत. यह दशमलव के तौर पर प्रतिशत होता है. वैल्यू, [0,1] की रेंज में होती हैं. उदाहरण के लिए, 0.0021 का मतलब 0.21% है.

उत्सर्जन में होने वाली इस छूट और कमी की जानकारी, ईएएसए लेबल से दी जाती है. हालांकि, इन्हें इस एपीआई से मिलने वाले CO2e के अनुमान में शामिल नहीं किया जाता.

ContrailsImpactBucket

CO2e उत्सर्जन के कुल असर की तुलना में, कॉन्ट्रेल से होने वाली गर्मी के असर की अहमियत.

Enums
CONTRAILS_IMPACT_UNSPECIFIED कॉन्ट्रेल के असर के बारे में जानकारी नहीं दी गई है.
CONTRAILS_IMPACT_NEGLIGIBLE कुल CO2e उत्सर्जन की तुलना में, कॉन्ट्रेल का असर नगण्य है.
CONTRAILS_IMPACT_MODERATE कॉन्ट्रेल का असर, CO2e के कुल उत्सर्जन के बराबर होता है.
CONTRAILS_IMPACT_SEVERE कॉन्ट्रेल का असर, कुल CO2e उत्सर्जन के असर से ज़्यादा होता है.