Method: batchGetAttributions

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

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

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

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

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

पाथ पैरामीटर

पैरामीटर
parent

string

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

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

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

FlightDetails

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

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

string

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

integer

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

string

मूल हवाई अड्डे के टाइमज़ोन में, यात्रा शुरू करने की तारीख int: यूनिक्स इपॉक; str: ISO 8601.
icao24

string

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

string

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

string

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

string

वेपॉइंट से जुड़े एयरक्राफ्ट का कॉलसाइन.
analyzedFlightDistanceMeters

string (int64 format)

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

ContrailAttributes

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

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

string (int64 format)

मीटर में, कॉन्ट्रेल बनने की अनुमानित लंबाई.
effectiveEnergyForcingJoules

string (int64 format)

इस फ़्लाइट की वजह से होने वाली कुल ऊर्जा खपत, जूल में.