एट्रिब्यूशन

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

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

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

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

object (FlightDetails)

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

object (ContrailAttributes)

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

स्टेटस की व्याख्या (मिली हुई फ़्लाइट के लिए):

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

ऑरिजिन एयरपोर्ट के टाइमज़ोन में, रवानगी की तारीख. int: unix epoch या str: ISO 8601.
icao24

string

ICAO 24-बिट एयरक्राफ्ट का पता
originAirport

string

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

string

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

string

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

integer

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

ContrailAttributes

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

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

integer

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

string (int64 format)

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

SegmentAttribution

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

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

string (Timestamp format)

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

string (Timestamp format)

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

object (ContrailAttributes)

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

object (ContrailDetectionEvidence)

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

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 और MTG, सैटलाइट डेटा के आउटपुट के तौर पर उपलब्ध हैं. GOES East पर आधारित एट्रिब्यूशन, प्रोडक्शन-लेवल की क्वालिटी वाले होते हैं. वहीं, 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 के फ़ुल डिस्क स्कैन का डेटा.

लाइसेंस

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