एट्रिब्यूशन

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

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

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

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)
    }
  ],
  "visualizationUrl": string
}
फ़ील्ड
name

string

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

फ़ॉर्मैट:

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

कॉम्पोनेंट:

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

object (FlightDetails)

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

object (ContrailAttributes)

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

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

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

object (SegmentAttribution)

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

string

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

ATTRIBUTION_VIEW_OBSERVATION व्यू का इस्तेमाल करने पर, सिर्फ़ मिली हुई फ़्लाइट के लिए जानकारी अपने-आप भर जाती है.

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)

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

string (Timestamp format)

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

object (ContrailAttributes)

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

object (ContrailDetectionEvidence)

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

enum (AttributionMethod)

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

boolean

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

object (WaypointAttribution)

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

ContrailDetectionEvidence

कॉन्ट्रेल के बारे में सैटलाइट से मिली जानकारी.

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

string (Timestamp format)

सैटलाइट से ली गई उस इमेज का समय जिसमें कॉन्ट्रेल का पता चला था. आम तौर पर, यह स्कैन शुरू होने का समय होता है. यह टाइमस्टैंप, यूटीसी ईपॉक सेकंड में होता है.
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 एमटीजी-000 फ़ुल डिस्क स्कैन से मिला डेटा.
HIMAWARI_FULL_DISK हिमावारी के फ़ुल डिस्क स्कैन से मिला डेटा.

Contrails API में सैटलाइट से ली गई तस्वीरें, इनके आधार पर दिखाई जाती हैं:

WaypointAttribution

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

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

string (Timestamp format)

यूटीसी epoch सेकंड में, वेपॉइंट पर पहुंचने का समय.
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 के तहत लाइसेंस मिला है.