- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- FlightWithDetailedEmissions
- FlightEmissionsDetails
- EmissionsBreakdown
- EmissionsMetadata
- EmissionsProvenance
- EmissionsProvenance.EmissionsProvenanceEntry
- EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType
- EmissionsProvenance.EmissionsProvenanceEntry.DataSource
- EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy
- EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy
- EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy
- EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy
- EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy
- EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy
- EmissionsProvenance.EmissionsProvenanceEntry.DataCategory
- इसे आज़माएं!
यह अनुरोध, उत्सर्जन के अनुमानों के बारे में ज़्यादा जानकारी देता है.
फ़्लाइट से होने वाले कार्बन उत्सर्जन के बारे में पूरी जानकारी दी जाती है. इसमें हर यात्री के हिसाब से ग्रीनहाउस गैस उत्सर्जन के अनुमानों के बारे में बताया जाता है. साथ ही, इसमें मेटाडेटा भी शामिल होता है. इस मेटाडेटा में, उत्सर्जन की गणना करने के तरीके, उत्सर्जन के बारे में पूरी जानकारी, कॉन्ट्रेल के असर, और डेटा के सोर्स के बारे में बताया जाता है.
उत्सर्जन के अनुमानों का हिसाब कैसे लगाया जाता है, इसकी जानकारी GitHub पर उपलब्ध है.
जवाब में, फ़्लाइट के उन सभी लेग की जानकारी शामिल होगी जो इनपुट से मेल खाती हैं. यह जानकारी उसी क्रम में होगी जिस क्रम में इनपुट दिया गया था. अगर किसी फ़्लाइट लेग के लिए अनुमान उपलब्ध नहीं हैं, तो जवाब में फ़्लाइट लेग ऑब्जेक्ट दिखेगा. इसमें उत्सर्जन के फ़ील्ड खाली होंगे. अनुरोध को अब भी पूरा माना जाएगा. उत्सर्जन के अनुमान न दिखने की ये वजहें हो सकती हैं:
- सर्वर को फ़्लाइट की जानकारी नहीं है.
- इनपुट किए गए फ़्लाइट लेग में एक या एक से ज़्यादा आइडेंटिफ़ायर मौजूद नहीं हैं.
- फ़्लाइट की तारीख बीत चुकी है.
- मॉडल में, एयरक्राफ़्ट टाइप मौजूद नहीं है.
- सीट का कॉन्फ़िगरेशन मौजूद नहीं है.
अनुरोध में ज़्यादा से ज़्यादा 100 फ़्लाइट लेग हो सकते हैं. अगर अनुरोध में 100 से ज़्यादा फ़्लाइट लेग हैं, तो INVALID_ARGUMENT गड़बड़ी की वजह से अनुरोध पूरा नहीं हो पाएगा.
एचटीटीपी अनुरोध
POST https://travelimpactmodel.googleapis.com/v1/flights:computeDetailedFlightEmissions
यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:
| JSON के काेड में दिखाना |
|---|
{
"flights": [
{
object ( |
| फ़ील्ड | |
|---|---|
flights[] |
ज़रूरी है. वापस आने वाली फ़्लाइट के लिए, कार्बन उत्सर्जन का अनुमान. |
जवाब का मुख्य भाग
flights.computeDetailedFlightEmissions के जवाब के लिए आउटपुट की परिभाषा.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
| JSON फ़ॉर्मैट में दिखाया गया है |
|---|
{ "flightsWithDetailedEmissions": [ { object ( |
| फ़ील्ड | |
|---|---|
flightsWithDetailedEmissions[] |
फ़्लाइट के लेग की सूची, जिसमें उत्सर्जन के अनुमान शामिल हैं. |
modelVersion |
मॉडल का वह वर्शन जिसके तहत, इस जवाब में शामिल सभी फ़्लाइट के लिए उत्सर्जन के अनुमान का हिसाब लगाया गया था. |
FlightWithDetailedEmissions
सीधी फ़्लाइट, जिसमें अनुमानित कार्बन उत्सर्जन की जानकारी दी गई हो.
| JSON के काेड में दिखाना |
|---|
{ "flight": { object ( |
| फ़ील्ड | |
|---|---|
flight |
सिर्फ़ आउटपुट के लिए. अनुरोध में दिए गए फ़्लाइट आइडेंटिफ़ायर से मेल खाता हो. ध्यान दें: सभी आईएटीए कोड कैपिटल लेटर में होते हैं. |
flightEmissionsDetails |
सिर्फ़ आउटपुट के लिए. फ़्लाइट से होने वाले कार्बन उत्सर्जन का पूरा डेटा. |
emissionsMetadata |
सिर्फ़ आउटपुट के लिए. फ़्लाइट से होने वाले उत्सर्जन की गणना के बारे में अतिरिक्त मेटाडेटा. |
FlightEmissionsDetails
किसी फ़्लाइट से होने वाले उत्सर्जन के बारे में जानकारी.
| JSON के काेड में दिखाना |
|---|
{ "emissionsGramsPerPax": { object ( |
| फ़ील्ड | |
|---|---|
emissionsGramsPerPax |
सिर्फ़ आउटपुट के लिए. हर यात्री के हिसाब से, अनुमानित कार्बन उत्सर्जन के आंकड़े. अगर उत्सर्जन का हिसाब नहीं लगाया जा सका, तो यह मौजूद नहीं होगा. कार्बन उत्सर्जन का हिसाब न लगाने की वजहों की सूची देखने के लिए, |
emissionsBreakdown |
सिर्फ़ आउटपुट के लिए. कुल उत्सर्जनGramsPerPax वैल्यू के अलग-अलग उत्सर्जन हिस्सों के बारे में जानकारी. कुल ब्रेकडाउन की वैल्यू, हमेशा emissionsGramsPerPax के बराबर होनी चाहिए. |
contrailsImpactBucket |
सिर्फ़ आउटपुट के लिए. कुल CO2e उत्सर्जन के मुकाबले, कॉन्ट्रेल से होने वाली गर्मी के असर का महत्व. |
source |
सिर्फ़ आउटपुट के लिए. उत्सर्जन के डेटा का सोर्स. |
EmissionsBreakdown
कुल उत्सर्जनGramsPerPax वैल्यू के अलग-अलग उत्सर्जन हिस्सों के बारे में जानकारी. कुल ब्रेकडाउन की वैल्यू, हमेशा emissionsGramsPerPax के बराबर होनी चाहिए.
| JSON के काेड में दिखाना |
|---|
{ "wttEmissionsGramsPerPax": { object ( |
| फ़ील्ड | |
|---|---|
wttEmissionsGramsPerPax |
हर यात्री के हिसाब से, वेल-टू-टैंक एमिशन (तेल को कुएं से निकालने की प्रक्रिया से लेकर उसके अंतिम इस्तेमाल के दौरान हुए उत्सर्जन) का अनुमान लगाने वाले नंबर. अगर उत्सर्जन का हिसाब नहीं लगाया जा सका, तो यह मौजूद नहीं होगा. कार्बन उत्सर्जन का हिसाब न लगाने की वजहों की सूची देखने के लिए, |
ttwEmissionsGramsPerPax |
हर यात्री के हिसाब से, टैंक से लेकर वेक तक के उत्सर्जन के अनुमानित आंकड़े. अगर उत्सर्जन का हिसाब नहीं लगाया जा सका, तो यह मौजूद नहीं होगा. कार्बन उत्सर्जन का हिसाब न लगाने की वजहों की सूची देखने के लिए, |
EmissionsMetadata
सभी अतिरिक्त मेटाडेटा.
| JSON के काेड में दिखाना |
|---|
{ "emissionsProvenance": { object ( |
| फ़ील्ड | |
|---|---|
emissionsProvenance |
सिर्फ़ आउटपुट के लिए. उत्सर्जन का डेटा कैलकुलेट करने के लिए इस्तेमाल किए गए डेटा के सोर्स के बारे में जानकारी. इसमें, योगदान देने वाले फ़ैक्टर और उनके डेटा सोर्स भी शामिल हैं. |
easaLabelMetadata |
सिर्फ़ आउटपुट के लिए. ईएएसए फ़्लाइट के उत्सर्जन से जुड़े लेबल के बारे में मेटाडेटा. यह कुकी सिर्फ़ तब सेट की जाती है, जब उत्सर्जन डेटा सोर्स EASA हो. |
timWebsiteEmissionsCalculatorUrl |
सिर्फ़ आउटपुट के लिए. |
EmissionsProvenance
उत्सर्जन के अनुमानों का हिसाब लगाने के लिए इस्तेमाल किए गए डेटा के सोर्स की जानकारी. इसमें योगदान देने वाले फ़ैक्टर और उनके डेटा सोर्स शामिल हैं.
| JSON के काेड में दिखाना |
|---|
{
"provenanceEntries": [
{
object ( |
| फ़ील्ड | |
|---|---|
provenanceEntries[] |
सिर्फ़ आउटपुट के लिए. उत्सर्जन का हिसाब लगाने के लिए इस्तेमाल किए गए सभी फ़ैक्टर. |
EmissionsProvenance.EmissionsProvenanceEntry
उत्सर्जन की गणना में योगदान देने वाले किसी एक फ़ैक्टर के बारे में जानकारी.
| JSON के काेड में दिखाना |
|---|
{ "provenanceEntryType": enum ( |
| फ़ील्ड | |
|---|---|
provenanceEntryType |
सिर्फ़ आउटपुट के लिए. यह जानकारी, ओरिजिन की जानकारी देने वाली एंट्री के टाइप के बारे में बताती है. |
source |
सिर्फ़ आउटपुट के लिए. डेटा का सोर्स. |
sourceVersion |
सिर्फ़ आउटपुट के लिए. सोर्स डेटा का वर्शन. उदाहरण के लिए, "2025/04". |
dataCategory |
सिर्फ़ आउटपुट के लिए. डेटा सोर्स की डेटा कैटगरी. |
यूनियन फ़ील्ड data_strategy. दिए गए डेटा सोर्स के लिए उत्सर्जन का हिसाब लगाने के लिए इस्तेमाल की गई रणनीति. फ़ील्ड सेट, data_source टाइप से मैच करेगा. data_strategy इनमें से सिर्फ़ एक हो सकता है: |
|
fuelBurnEeaStrategy |
सिर्फ़ आउटपुट के लिए. ईईए में ईंधन के इस्तेमाल की रणनीति. |
loadFactorsT100Strategy |
सिर्फ़ आउटपुट के लिए. T100 लोड फ़ैक्टर के लिए रणनीति. |
loadFactorsChAviationStrategy |
सिर्फ़ आउटपुट के लिए. CH Aviation के लोड फ़ैक्टर के लिए रणनीति. |
cargoMassFractionT100Strategy |
सिर्फ़ आउटपुट के लिए. T100 के कार्गो मास फ़्रैक्शन के लिए रणनीति. |
seatAreaRatioIataStrategy |
सिर्फ़ आउटपुट के लिए. आईएटीए के सीट एरिया के अनुपात के लिए रणनीति. |
distanceAdjustmentStrategy |
सिर्फ़ आउटपुट के लिए. दूरी के हिसाब से अडजस्ट करने की रणनीति. |
यूनियन फ़ील्ड data_value. दिए गए डेटा सोर्स के लिए डेटा वैल्यू. फ़ील्ड सेट, provenance_entry_type से मेल खाएगा. data_value इनमें से सिर्फ़ एक हो सकता है: |
|
loadFactorsData |
सिर्फ़ आउटपुट के लिए. लोड फ़ैक्टर के डेटा की वैल्यू. अगर इसे सेट नहीं किया जाता है, तो लोड फ़ैक्टर की वैल्यू उपलब्ध नहीं होती है. |
cargoMassFractionData |
सिर्फ़ आउटपुट के लिए. कार्गो के मास फ़्रैक्शन की वैल्यू. अगर इसे सेट नहीं किया जाता है, तो कार्गो के द्रव्यमान के अनुपात की वैल्यू उपलब्ध नहीं होती है. |
seatAreaRatioData |
सिर्फ़ आउटपुट के लिए. हर बुकिंग क्लास के लिए, सीट एरिया रेशियो की वैल्यू. अगर यह सेट नहीं है, तो सीट एरिया रेशियो की वैल्यू उपलब्ध नहीं होती. |
estimatedFlightDistanceKm |
सिर्फ़ आउटपुट के लिए. सीसीडी फ़्लाइट फ़ेज़ में तय की गई अनुमानित दूरी. इसकी वैल्यू किलोमीटर में होती है. इसका हिसाब, दूरी को अडजस्ट करने वाले फ़ैक्टर (डीएएफ़) का इस्तेमाल करके लगाया जाता है. अगर इसे सेट नहीं किया जाता है, तो फ़्लाइट की अनुमानित दूरी की वैल्यू उपलब्ध नहीं होती है. |
EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType
यह जानकारी, ओरिजिन की जानकारी देने वाली एंट्री के टाइप के बारे में बताती है. आने वाले समय में, नई वैल्यू जोड़ी जा सकती हैं. क्लाइंट को, ऐसी enum वैल्यू को आसानी से हैंडल करने के लिए तैयार रहना चाहिए जिनके बारे में उसे पता नहीं है.
| Enums | |
|---|---|
EMISSIONS_PROVENANCE_ENTRY_TYPE_UNSPECIFIED |
Provenance एंट्री टाइप की जानकारी नहीं दी गई है. |
FUEL_BURN |
ईंधन के इस्तेमाल की जानकारी देने वाली एंट्री का टाइप. |
LOAD_FACTORS |
लोड फ़ैक्टर एंट्री टाइप. |
CARGO_MASS_FRACTION |
कार्गो के मास फ़्रैक्शन का एंट्री टाइप. |
SEATING_CONFIG |
सीट के कॉन्फ़िगरेशन की एंट्री का टाइप. |
SEAT_AREA_RATIOS |
सीट के अनुपात का एंट्री टाइप. |
DISTANCE_ADJUSTMENT |
दूरी के हिसाब से बिड घटाने या बढ़ाने की सेटिंग का एंट्री टाइप. |
EmissionsProvenance.EmissionsProvenanceEntry.DataSource
कार्बन उत्सर्जन के सोर्स की जानकारी देने वाले फ़ैक्टर के लिए डेटा का सोर्स. आने वाले समय में, नई वैल्यू जोड़ी जा सकती हैं. क्लाइंट को, ऐसी enum वैल्यू को आसानी से हैंडल करने के लिए तैयार रहना चाहिए जिनके बारे में उसे पता नहीं है.
| Enums | |
|---|---|
DATA_SOURCE_UNSPECIFIED |
डेटा सोर्स की जानकारी नहीं दी गई है. |
EEA |
यह डेटा, यूरोपियन एनवायरमेंट एजेंसी (ईईए) से मिला है. |
T100 |
अमेरिका के ब्यूरो ऑफ़ ट्रांसपोर्टेशन स्टैटिस्टिक्स से मिला T-100 डेटासेट. |
CH_AVIATION |
ch-aviation से मिला डेटा. |
OAG |
यह डेटा, Official Aviation Guide (OAG) से मिला है. |
OPERATING_CARRIER |
यह डेटा, शिपिंग की सुविधा देने वाली कंपनी से मिला है. |
AIRCRAFT_MODEL_TYPICAL |
हवाई जहाज़ के मॉडल के आधार पर सामान्य डेटा. |
GLOBAL_DEFAULT |
यह ग्लोबल डिफ़ॉल्ट वैल्यू है. इसका इस्तेमाल तब किया जाता है, जब कोई दूसरा डेटा सोर्स उपलब्ध न हो. |
IATA |
इंटरनैशनल एयर ट्रांसपोर्ट असोसिएशन (आईएटीए) से मिला डेटा. |
ICL |
यह डेटा, इंपीरियल कॉलेज लंदन से मिला है. |
EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy
ईईए में ईंधन के इस्तेमाल की रणनीति. आने वाले समय में, नई वैल्यू जोड़ी जा सकती हैं. क्लाइंट को, ऐसी enum वैल्यू को आसानी से हैंडल करने के लिए तैयार रहना चाहिए जिनके बारे में उसे पता नहीं है.
| Enums | |
|---|---|
STRATEGY_UNSPECIFIED |
रणनीति की जानकारी नहीं दी गई है. |
AIRCRAFT_MAPPING_FALLBACK_WITH_CORRECTION_FACTOR |
स्टैटिक करेक्शन फ़ैक्टर लागू किया गया था. |
AIRCRAFT_MAPPING_EXACT |
विमान की सटीक मैपिंग का इस्तेमाल किया गया था. |
AIRCRAFT_MAPPING_FALLBACK |
एयरक्राफ्ट की मैपिंग के लिए फ़ॉलबैक का इस्तेमाल किया गया था. |
EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy
T100 लोड फ़ैक्टर के लिए रणनीति. आने वाले समय में, नई वैल्यू जोड़ी जा सकती हैं. क्लाइंट को, ऐसी enum वैल्यू को आसानी से हैंडल करने के लिए तैयार रहना चाहिए जिनके बारे में उसे पता नहीं है.
| Enums | |
|---|---|
STRATEGY_UNSPECIFIED |
रणनीति की जानकारी नहीं दी गई है. |
CARRIER_ROUTE_MONTH |
कैरियर, रूट, और यात्रा के महीने के हिसाब से डेटा. |
CARRIER_MONTH |
कैरियर और यात्रा के महीने के हिसाब से डेटा. |
ACTUAL_CARRIER_ROUTE_YEAR_MONTH |
पुराना डेटा, जिसमें कैरियर, रास्ता, साल, और महीना मैच करता हो. |
EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy
CH-Aviation के लोड फ़ैक्टर के लिए रणनीति. आने वाले समय में, नई वैल्यू जोड़ी जा सकती हैं. क्लाइंट को, ऐसी enum वैल्यू को आसानी से हैंडल करने के लिए तैयार रहना चाहिए जिनके बारे में उसे पता नहीं है.
| Enums | |
|---|---|
STRATEGY_UNSPECIFIED |
रणनीति की जानकारी नहीं दी गई है. |
CARRIER_MONTH |
कैरियर और यात्रा के महीने के हिसाब से डेटा. |
ACTUAL_CARRIER_YEAR_MONTH |
कैरियर, साल, और महीने से मेल खाने वाला पुराना डेटा. |
EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy
T100 के कार्गो मास फ़्रैक्शन के लिए रणनीति. आने वाले समय में, नई वैल्यू जोड़ी जा सकती हैं. क्लाइंट को, ऐसी enum वैल्यू को आसानी से हैंडल करने के लिए तैयार रहना चाहिए जिनके बारे में उसे पता नहीं है.
| Enums | |
|---|---|
STRATEGY_UNSPECIFIED |
रणनीति की जानकारी नहीं दी गई है. |
CARRIER_ROUTE_AIRCRAFT_CLASS |
कैरियर, रूट, और एयरक्राफ़्ट क्लास के हिसाब से डेटा. |
ROUTE_AIRCRAFT_CLASS |
रास्ते और हवाई जहाज़ की क्लास के हिसाब से डेटा. |
DISTANCE_AIRCRAFT_CLASS |
दूरी के हिसाब से बैंड और एयरक्राफ़्ट क्लास के हिसाब से डेटा. |
ACTUAL_CARRIER_ROUTE_YEAR_MONTH_AIRCRAFT_CLASS |
एयरलाइन, रूट, साल, महीने, और हवाई जहाज़ की क्लास से मेल खाने वाला पुराना डेटा. |
EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy
आईएटीए के सीट एरिया के अनुपात के लिए रणनीति. आने वाले समय में, नई वैल्यू जोड़ी जा सकती हैं. क्लाइंट को, ऐसी enum वैल्यू को आसानी से हैंडल करने के लिए तैयार रहना चाहिए जिनके बारे में उसे पता नहीं है.
| Enums | |
|---|---|
STRATEGY_UNSPECIFIED |
रणनीति की जानकारी नहीं दी गई है. |
NARROW_AIRCRAFT_BODY |
इसमें नैरो बॉडी एयरक्राफ्ट के लिए, सीट एरिया के अनुपात का इस्तेमाल किया गया था. |
WIDE_AIRCRAFT_BODY |
इसमें वाइड बॉडी एयरक्राफ्ट के लिए, सीट एरिया के अनुपात का इस्तेमाल किया गया था. |
EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy
दूरी के हिसाब से अडजस्ट करने की रणनीति. आने वाले समय में, नई वैल्यू जोड़ी जा सकती हैं. क्लाइंट को, ऐसी enum वैल्यू को आसानी से हैंडल करने के लिए तैयार रहना चाहिए जिनके बारे में उसे पता नहीं है.
| Enums | |
|---|---|
STRATEGY_UNSPECIFIED |
रणनीति की जानकारी नहीं दी गई है. |
ORIGIN_DESTINATION |
यात्रा शुरू करने और पहुंचने वाले हवाई अड्डे के हिसाब से, दूरी के लिए अडजस्टमेंट फ़ैक्टर तय किया जाता है. |
COUNTRY_PAIR |
दूरी के हिसाब से किराये में बदलाव करने वाला फ़ैक्टर, यात्रा शुरू करने और खत्म करने वाले देश के हिसाब से तय होता है. |
DEFAULT |
दूरी के हिसाब से किराये में बदलाव करने का फ़ैक्टर, डिफ़ॉल्ट वैल्यू पर आधारित होता है. ऐसा इसलिए, क्योंकि हमें एयरपोर्ट या देश के हिसाब से किराये में बदलाव करने का फ़ैक्टर नहीं मिला. |
EmissionsProvenance.EmissionsProvenanceEntry.DataCategory
डेटा सोर्स की डेटा कैटगरी. आने वाले समय में, नई वैल्यू जोड़ी जा सकती हैं. क्लाइंट को, ऐसी enum वैल्यू को आसानी से हैंडल करने के लिए तैयार रहना चाहिए जिनके बारे में उसे पता नहीं है.
| Enums | |
|---|---|
DATA_CATEGORY_UNSPECIFIED |
डेटा कैटगरी की जानकारी नहीं दी गई है. |
PRIMARY |
आईएसओ 14083 में बताए गए प्राइमरी डेटा के मुताबिक. |
MODELED |
मॉडल किया गया डेटा, जैसा कि ISO 14083 में बताया गया है. |
DEFAULT |
डिफ़ॉल्ट वैल्यू डेटा, जैसा कि ISO 14083 में बताया गया है. |