एट्रिब्यूशन

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

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

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

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}: तीन अक्षर वाला आईएटीए एयरपोर्ट कोड (जैसे, "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: यूनिक्स इपॉक या str: ISO 8601.
icao24

string

आईसीएओ का 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 हिमावारी के फ़ुल डिस्क स्कैन का डेटा.