Method: batchGetAttributions

फ़्लाइट की जानकारी के आधार पर, कॉन्ट्रेल के असर का अनुमान कई बार लगाया जाता है.

अगर अनुरोध पूरा हो जाता है, तो जवाब में कॉन्ट्रेल एट्रिब्यूशन की सूची दिखेगी.

एचटीटीपी अनुरोध

GET https://contrails.googleapis.com/v2/{parent=attributions}:batchGet

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
parent

string

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

क्वेरी पैरामीटर

पैरामीटर
names[]

string

ज़रूरी है. उन फ़्लाइट के संसाधन नाम जिन्हें वापस पाना है. एक अनुरोध में ज़्यादा से ज़्यादा 100 नाम दिए जा सकते हैं.

फ़ॉर्मैट:

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

कॉम्पोनेंट:

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

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य भाग

जवाब में, attributions.batchGet के लिए एट्रिब्यूट किए गए कॉन्ट्रेल शामिल हैं.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

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}: हवाई अड्डे का तीन अक्षर वाला IATA कोड (जैसे, "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

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

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 हिमावारी के पूरे डिस्क स्कैन का डेटा.