एट्रिब्यूशन

फ़्लाइट की किसी सूची के लिए, कॉन्ट्रेल से जुड़े सेगमेंट.

डेटा फ़ॉर्मैट

जिन्हें एट्रिब्यूट किया गया है उन कॉन्ट्रेल के अनुरोधों में, इस स्ट्रक्चर का डेटा शामिल होता है:

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

object (Attribution)

BatchGetAttributionsRequest.names में दिए गए हर संसाधन के नाम के लिए, एट्रिब्यूशन की सूची. इस सूची में एट्रिब्यूशन का क्रम, BatchGetAttributionsRequest में नामों के क्रम से मेल खाएगा. अगर कोई फ़्लाइट नहीं मिली है, तो जवाब में एट्रिब्यूशन मैसेज में सिर्फ़ name फ़ील्ड दिखेगा. वहीं, flightDetails और contrail फ़ील्ड खाली होंगे.

एट्रिब्यूशन

यह किसी फ़्लाइट के लिए, एग्रीगेट किए गए कॉन्ट्रेल इवेंट को दिखाता है. इसमें एट्रिब्यूट किए गए सभी कॉन्ट्रेल सेगमेंट (जैसे, कुल किलोमीटर और ऊर्जा) की खास जानकारी होती है.

JSON के काेड में दिखाना 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ]
}
फ़ील्ड
name

string

आइडेंटिफ़ायर. फ़्लाइट का संसाधन नाम.

फ़ॉर्मैट:

carriers/{carrier}/flightNumbers/{flightNumber}/departureDates/{departure_date}/departureAirports/{departure_airport}

कॉम्पोनेंट:

  • {carrier}: दो वर्णों वाला IATA कैरियर कोड (जैसे, "AA", "UA").
  • {flightNumber}: फ़्लाइट नंबर, एक से चार अंकों का होना चाहिए. उदाहरण के लिए, "123".
  • {departure_date}: फ़्लाइट के रवाना होने की तारीख. यह तारीख, फ़्लाइट के रवाना होने वाले एयरपोर्ट के स्थानीय समय के हिसाब से YYYY-MM-DD फ़ॉर्मैट में होनी चाहिए.
  • {departure_airport}: हवाई अड्डे का तीन अक्षर वाला IATA कोड (जैसे, "JFK", "LHR").
flightDetails

object (FlightDetails)

इस फ़्लाइट की पूरी जानकारी.
contrail

object (ContrailAttributes)

पूरी फ़्लाइट के लिए, कॉन्ट्रेल एट्रिब्यूट को एग्रीगेट किया गया है. इससे एट्रिब्यूट किए गए सभी सेगमेंट के कॉन्ट्रेल एट्रिब्यूट का हिसाब लगाया जाता है.

फ़्लाइट की स्थिति के बारे में जानकारी (खोजे गए फ़्लाइट के लिए):

  • अगर मौजूद है, तो: कॉन्ट्रेल का विश्लेषण किया गया था. ContrailAttributes में मौजूद फ़ील्ड, नतीजों के बारे में बताते हैं. उदाहरण के लिए, lengthMeters > 0 का मतलब है कि कॉन्ट्रेल को एट्रिब्यूट किया गया था. अगर कोई खाली ContrailAttributes मैसेज मौजूद है, तो इसका मतलब है कि विश्लेषण किया गया था. हालांकि, lengthMeters और एनर्जी फ़ोर्सिंग, दोनों की वैल्यू शून्य है.
  • अगर मौजूद नहीं है, तो: इस फ़्लाइट के लिए, कॉन्ट्रेल का विश्लेषण नहीं किया जा सका.
    • आम तौर पर, ऐसा इसलिए होता है, क्योंकि इनपुट डेटा में ज़रूरी जानकारी नहीं होती. उदाहरण के लिए, मौसम का डेटा मौजूद न होना या फ़्लाइट के रास्ते के बारे में सटीक जानकारी न होना.
    • इसका मतलब यह नहीं है कि कोई कॉन्ट्रेल नहीं बना. इसका मतलब सिर्फ़ यह है कि यह पता नहीं लगाया जा सका कि कॉन्ट्रेल बना या नहीं.
segments[]

object (SegmentAttribution)

हर सेगमेंट के लिए कॉन्ट्रेल एट्रिब्यूशन. हर एंट्री, फ़्लाइट के उस अलग-अलग समय अंतराल को दिखाती है जब कॉन्ट्रेल बने थे.

FlightDetails

इससे, जवाब में फ़्लाइट की पूरी जानकारी मिलती है.

JSON के काेड में दिखाना 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": integer
}
फ़ील्ड
carrier

string

फ़्लाइट का आईएटीए कैरियर कोड (जैसे, "AA").
flightNumber

integer

फ़्लाइट का नंबर (जैसे, "123").
departureTime

string

मूल हवाई अड्डे के टाइमज़ोन के हिसाब से, YYYYMMDD फ़ॉर्मैट में यात्रा शुरू करने की तारीख.
icao24

string

आईसीएओ का 24-बिट वाला एयरक्राफ़्ट पता
originAirport

string

आईएटीए ऑरिजिन एयरपोर्ट कोड.
destinationAirport

string

डेस्टिनेशन एयरपोर्ट का आईएटीए कोड.
callSign

string

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

integer

मीटर में, फ़्लाइट की दूरी का विश्लेषण किया गया.

ContrailAttributes

यह किसी फ़्लाइट या फ़्लाइट सेगमेंट के लिए, कॉन्ट्रेल एट्रिब्यूट दिखाता है.

JSON के काेड में दिखाना 
{
  "lengthMeters": integer,
  "effectiveEnergyForcingJoules": string
}
फ़ील्ड
lengthMeters

integer

फ़्लाइट पाथ के उन सबसेट की लंबाई, जिन्हें कॉन्ट्रेल के लिए एट्रिब्यूट किया गया था. यह लंबाई मीटर में होती है. इसका हिसाब, फ़्लाइट के वेपॉइंट के बीच की दूरी के हिसाब से लगाया जाता है.
effectiveEnergyForcingJoules

string (int64 format)

जूल में, कॉन्ट्रेल की वजह से होने वाली कुल ऊर्जा. इसे 4D ग्रिड वाले CoCiP के अनुमानित आउटपुट से, असरदार रेडिएटिव फ़ोर्सिंग को निकालकर और उन्हें रैखिक रूप से इंटरपोलेट करके निकाला जाता है. इस तरीके में बदलाव किया जा सकता है.

SegmentAttribution

यह फ़्लाइट के किसी खास समय सेगमेंट के लिए कॉन्ट्रेल एट्रिब्यूशन को दिखाता है.

JSON के काेड में दिखाना 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}
फ़ील्ड
startTime

string (Timestamp format)

फ़्लाइट के उस सेगमेंट के शुरू होने का समय जिससे कॉन्ट्रेल एट्रिब्यूट किए जाते हैं. यह टाइमस्टैंप, यूटीसी के epoch सेकंड में है.
endTime

string (Timestamp format)

फ़्लाइट के उस सेगमेंट के खत्म होने का समय जिससे कॉन्ट्रेल एट्रिब्यूट किए जाते हैं. यह टाइमस्टैंप, यूटीसी के epoch सेकंड में है.
contrail

object (ContrailAttributes)

इस सेगमेंट के लिए कॉन्ट्रेल एट्रिब्यूट.
detectionEvidences[]

object (ContrailDetectionEvidence)

अलग-अलग सैटलाइट से पता लगाए गए कॉन्ट्रेल, जो इस फ़्लाइट सेगमेंट को एट्रिब्यूट करने का सबूत देते हैं.
attributionMethod

enum (AttributionMethod)

सिर्फ़ आउटपुट के लिए. इस सेगमेंट में कॉन्ट्रेल को एट्रिब्यूट करने के लिए इस्तेमाल किया गया तरीका. जैसे, CoCiP मॉडल या सीधे तौर पर निगरानी करना.
longGapInterpolation

boolean

सिर्फ़ आउटपुट के लिए. अगर सेगमेंट फ़्लाइट पाथ को, लंबे समय तक एडीएसी-बी डेटा उपलब्ध न होने (>5 मिनट) के दौरान इंटरपोलेट करके जनरेट किया गया था, तो यह वैल्यू सही होती है.
waypointAttributions[]

object (WaypointAttribution)

सिर्फ़ आउटपुट के लिए. इस सेगमेंट में मैप किए गए, हर वेपॉइंट के कॉन्ट्रेल एट्रिब्यूट.

ContrailDetectionEvidence

किसी कॉन्ट्रेल की एक ही सैटलाइट से की गई निगरानी की जानकारी.

JSON के काेड में दिखाना 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
फ़ील्ड
observationTime

string (Timestamp format)

सैटलाइट से ली गई उस इमेज को कैप्चर करने का समय जिसमें कॉन्ट्रेल का पता चला था. आम तौर पर, यह स्कैन शुरू होने का समय होता है. यह टाइमस्टैंप, यूटीसी epoch सेकंड में है.
observedLengthMeters

integer

observationTime में दी गई सैटलाइट इमेज में, लीनियर कॉन्ट्रेल की कुल लंबाई मीटर में. यह लंबाई, SegmentAttribution.contrail में मौजूद lengthMeters से अलग हो सकती है. इसकी वजह यह है कि:

  • ऐसा हो सकता है कि विमान के निकलने के बाद, वायुमंडल में कॉन्ट्रेल की स्थिति बदल गई हो. जैसे, वह फैल गया हो, लंबा हो गया हो वगैरह.
  • एट्रिब्यूशन एल्गोरिदम, इस कॉन्ट्रेल के सिर्फ़ एक हिस्से को इस फ़्लाइट से जोड़ पाया.
dataSource

enum (DataSource)

सिर्फ़ आउटपुट के लिए. सैटलाइट से मिले डेटा का सोर्स, जिसका इस्तेमाल इस बदलाव का पता लगाने के लिए किया गया है.

DataSource

सैटलाइट से मिले उस डेटा का सोर्स जिसका इस्तेमाल, कॉन्ट्रेल का पता लगाने के लिए किया जाता है. आने वाले समय में, इसमें अन्य वैल्यू जोड़ी जा सकती हैं.

उपलब्ध सैटलाइट डेटा आउटपुट में से, GOES East और Himawari पर आधारित एट्रिब्यूशन की क्वालिटी प्रोडक्शन-लेवल की है. वहीं, MTG पर आधारित एट्रिब्यूशन अब भी बीटा वर्शन में हैं और इनकी क्वालिटी को बेहतर बनाने पर काम किया जा रहा है.

Enums
DATA_SOURCE_UNSPECIFIED डेटा सोर्स के बारे में जानकारी नहीं दी गई है.
GOES_EAST_FULL_DISK GOES-East के फ़ुल डिस्क स्कैन का डेटा.
GOES_WEST_FULL_DISK GOES-West के पूरे डिस्क स्कैन का डेटा.
MTG_000_FULL_DISK MTG-000 के पूरे डिस्क स्कैन का डेटा.
HIMAWARI_FULL_DISK Himawari के पूरे डिस्क स्कैन का डेटा.

Contrails API की सैटलाइट इमेज, इनके आधार पर तैयार की जाती हैं:

WaypointAttribution

यह फ़्लाइट सेगमेंट में किसी खास वेपॉइंट के लिए, कॉन्ट्रेल एट्रिब्यूट दिखाता है.

JSON के काेड में दिखाना 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
फ़ील्ड
time

string (Timestamp format)

यूटीसी के हिसाब से, वेपॉइंट पर पहुंचने का समय.
contrailAttributes

object (ContrailAttributes)

इस खास वेपॉइंट पर मैप किए गए कॉन्ट्रेल एट्रिब्यूट.

AttributionMethod

इससे एट्रिब्यूशन करने के लिए इस्तेमाल की गई खास प्रक्रिया या तरीके के बारे में पता चलता है.

Enums
ATTRIBUTION_METHOD_OBSERVATION सैटलाइट से मिले डेटा के आधार पर, विमान के धुएं का पता लगाकर एट्रिब्यूशन किया जाता है.
ATTRIBUTION_METHOD_COCIP ये एट्रिब्यूशन, पूरी तरह से फ़िज़िक्स पर आधारित CoCiP मॉडलिंग पर निर्भर करते हैं.
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

हाइब्रिड एट्रिब्यूशन, जिसमें CoCiP मॉडल के अनुमानों को सैटलाइट से मिले डेटा के हिसाब से अडजस्ट किया जाता है.

  • डिटेक्शन के साथ: अगर detectionEvidences मौजूद है, तो इसका मतलब है कि कॉन्ट्रेल का अनुमान लगाया गया था और पुष्टि की गई थी. इसलिए, इसे ज़्यादा वार्मिंग वेट मिला.
  • बिना पता लगाए: अगर detectionEvidences मौजूद नहीं है, तो इसका मतलब है कि कॉन्ट्रेल का अनुमान लगाया गया था, लेकिन इसे देखा नहीं गया. इसलिए, कैलकुलेट की गई वार्मिंग को कम कर दिया जाता है.
ATTRIBUTION_METHOD_UNSPECIFIED तरीका नहीं बताया गया है.

नोट

हर DataSource, ऑब्ज़र्वेशनल व्यू को प्रोसेस करने के लिए अलग-अलग बाउंड का इस्तेमाल करता है:

सैटलाइट कवरेज बाउंडिंग बॉक्स (फ़्लैट मरकेटर व्यू)

लाइसेंस

ContrailWatch Attributions API से मिले डेटा का लाइसेंस, CC BY-NC 4.0 के तहत मिलता है.