Method: batchGetAttributions

ফ্লাইট তথ্যের মাধ্যমে একাধিক কনট্রাইল অ্যাট্রিবিউশন পায়।

যদি সফল হয়, তাহলে প্রতিক্রিয়া হবে কনট্রাইল অ্যাট্রিবিউশনের একটি তালিকা।

HTTP অনুরোধ

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

URL টি gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পথের পরামিতি

পরামিতি
parent

string

প্রয়োজনীয়। পুনরুদ্ধার করা সমস্ত অ্যাট্রিবিউশনের দ্বারা ভাগ করা মূল সম্পদ। ফর্ম্যাট: অ্যাট্রিবিউশন

কোয়েরি প্যারামিটার

পরামিতি
names[]

string

প্রয়োজনীয়। যেসব ফ্লাইটের রিসোর্স নাম উদ্ধার করতে হবে। একটি অনুরোধে সর্বাধিক ১০০টি নাম প্রদান করা যেতে পারে।

বিন্যাস:

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

উপাদান:

  • {carrier} : ২-অক্ষরের IATA ক্যারিয়ার কোড (যেমন, "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} : ২-অক্ষরের IATA ক্যারিয়ার কোড (যেমন, "AA" , "UA" )।
  • {flightNumber} : ১-৪ সংখ্যার ফ্লাইট নম্বর (যেমন, "123" )।
  • {departure_date} : ফ্লাইট ছাড়ার তারিখ YYYY-MM-DD ফর্ম্যাটে।
  • {departure_airport} : ৩-অক্ষরের IATA বিমানবন্দর কোড (যেমন, "JFK" , "LHR" )।
flightDetails

object ( FlightDetails )

এই ফ্লাইটের বিস্তারিত তথ্য।

contrail

object ( ContrailAttributes )

সমগ্র ফ্লাইটের জন্য সমষ্টিগত কনট্রাইল বৈশিষ্ট্য। এটি সমস্ত অ্যাট্রিবিউটেড সেগমেন্ট থেকে কনট্রাইল বৈশিষ্ট্যের সারসংক্ষেপ।

রাষ্ট্র ব্যাখ্যা (একটি পাওয়া ফ্লাইটের মধ্যে):

  • যদি থাকে: Contrail বিশ্লেষণ করা হয়েছে। ContrailAttributes ভিতরের ক্ষেত্রগুলি ফলাফল নির্দেশ করে (যেমন, lengthMeters > 0 মানে contrails অ্যাট্রিবিউট করা হয়েছে)।
  • যদি অনুপস্থিত থাকে: এই ফ্লাইটের জন্য কনট্রেইল বিশ্লেষণ করা যাবে না।
    • এটি সাধারণত অপর্যাপ্ত ইনপুট ডেটার কারণে হয় (যেমন, আবহাওয়ার ডেটা অনুপস্থিত বা বিমানের পথের অনিশ্চয়তা)।
    • এর অর্থ এই নয় যে কোনও বিপরীতমুখী ধারণা তৈরি হয়নি, কেবল একটি সিদ্ধান্ত নেওয়া যায়নি।

segments[]

object ( SegmentAttribution )

প্রতি-সেগমেন্ট কনট্রাইল অ্যাট্রিবিউশন। প্রতিটি এন্ট্রি সেই ফ্লাইটের একটি স্বতন্ত্র সময় ব্যবধান উপস্থাপন করে যেখানে কনট্রাইল(গুলি) আরোপ করা হয়েছিল।

ফ্লাইটের বিবরণ

প্রতিক্রিয়ায় ফেরত আসা সম্পূর্ণ ফ্লাইট তথ্যের সেট সংজ্ঞায়িত করে।

JSON উপস্থাপনা 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": integer
}
ক্ষেত্র
carrier

string

ফ্লাইটের IATA ক্যারিয়ার কোড (যেমন "AA")।

flightNumber

integer

ফ্লাইটের ফ্লাইট নম্বর (যেমন "১২৩")।

departureTime

string

উৎপত্তিস্থল বিমানবন্দরের টাইমজোনে প্রস্থানের তারিখ int: unix epoch; str: ISO 8601 ।

icao24

string

ICAO 24-বিট বিমানের ঠিকানা

originAirport

string

IATA এর উৎপত্তিস্থল বিমানবন্দর কোড।

destinationAirport

string

IATA গন্তব্য বিমানবন্দর কোড।

callSign

string

বিমানের কলসাইন। এই ক্ষেত্রটিতে অগ্রাধিকারমূলকভাবে এয়ার ট্র্যাফিক কন্ট্রোল (ATC) যোগাযোগে ব্যবহৃত কলসাইন থাকে। যদি নির্দিষ্ট ATC কলসাইনটি উপলব্ধ না থাকে বা স্ট্যান্ডার্ড ফ্লাইট ডিজাইনারের মতো হয়, তাহলে এই ক্ষেত্রটি স্ট্যান্ডার্ড ফ্লাইট ডিজাইনার (সাধারণত বাণিজ্যিক ফ্লাইটের জন্য এয়ারলাইন কোড এবং ফ্লাইট নম্বরের সংমিশ্রণ) ধারণ করে।

analyzedFlightDistanceMeters

integer

ফ্লাইটের দূরত্ব মিটারে বিশ্লেষণ করা হয়েছে।

ContrailAttributes সম্পর্কে

একটি ফ্লাইট বা ফ্লাইট সেগমেন্টের জন্য কনট্রাইল বৈশিষ্ট্যগুলি উপস্থাপন করে।

JSON উপস্থাপনা 
{
  "lengthMeters": integer,
  "effectiveEnergyForcingJoules": string
}
ক্ষেত্র
lengthMeters

integer

ফ্লাইট পাথের উপসেট(গুলি) এর দৈর্ঘ্য, মিটারে, যার সাথে কনট্রেইলগুলি যুক্ত করা হয়েছিল। এটি ফ্লাইট ওয়েপয়েন্টগুলির মধ্যে বৃহৎ বৃত্তের দূরত্ব হিসাবে গণনা করা হয়।

effectiveEnergyForcingJoules

string ( int64 format)

মোট কার্যকর কনট্রাইল শক্তি বল, জুলে। এটি বর্তমানে জলবায়ুগত গড়ের উপর ভিত্তি করে গণনা করা হয় এবং পরিবর্তন সাপেক্ষে।

সেগমেন্টঅ্যাট্রিবিউশন

একটি ফ্লাইটের একটি নির্দিষ্ট সময় বিভাগের জন্য কনট্রাইল অ্যাট্রিবিউশন প্রতিনিধিত্ব করে।

JSON উপস্থাপনা 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ]
}
ক্ষেত্র
startTime

string ( Timestamp format)

যে ফ্লাইট সেগমেন্টের সাথে কনট্রেইল যুক্ত, তার শুরুর সময়। এই টাইমস্ট্যাম্পটি UTC যুগের সেকেন্ডে।

endTime

string ( Timestamp format)

যে ফ্লাইট সেগমেন্টের সাথে কনট্রেইল যুক্ত করা হয়েছে তার শেষ সময়। এই টাইমস্ট্যাম্পটি UTC যুগের সেকেন্ডে।

contrail

object ( ContrailAttributes )

এই নির্দিষ্ট বিভাগের জন্য কনট্রেইল বৈশিষ্ট্য।

detectionEvidences[]

object ( ContrailDetectionEvidence )

পৃথক উপগ্রহ কন্ট্রিল সনাক্তকরণ যা এই ফ্লাইট সেগমেন্টের জন্য দায়ীত্বের প্রমাণ প্রদান করে।

ContrailDetectionEvidence সম্পর্কে

একটি কনট্রিলের একক উপগ্রহ পর্যবেক্ষণের বিবরণ।

JSON উপস্থাপনা 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
ক্ষেত্র
observationTime

string ( Timestamp format)

স্যাটেলাইট চিত্রটি তোলার সময়, যখন কনট্রেইল সনাক্ত করা হয়েছিল। এটি সাধারণত স্ক্যানের শুরুর সময়। এই টাইমস্ট্যাম্পটি UTC যুগের সেকেন্ডে।

observedLengthMeters

integer

observationTime দ্বারা নির্দিষ্ট করা স্যাটেলাইট ছবিতে সনাক্ত করা রৈখিক কন্ট্রিল বৈশিষ্ট্যের পরিলক্ষিত শেষ থেকে শেষ দৈর্ঘ্য মিটারে। এই দৈর্ঘ্য SegmentAttribution.contrail এর lengthMeters থেকে ভিন্ন হতে পারে কারণ:

  • গঠন এবং পর্যবেক্ষণের মধ্যবর্তী সময়ে বায়ুমণ্ডলে কনট্রেইল বিবর্তিত হতে পারে (যেমন, বিস্তার, দীর্ঘায়িত, ইত্যাদি)।
  • অ্যাট্রিবিউশন অ্যালগরিদম আত্মবিশ্বাসের সাথে এই কনট্রেইলের একটি অংশকে এই ফ্লাইটের সাথে যুক্ত করতে সক্ষম হয়েছিল।
dataSource

enum ( DataSource )

শুধুমাত্র আউটপুট। এই সনাক্তকরণের জন্য ব্যবহৃত স্যাটেলাইট ডেটার উৎস।

তথ্যসূত্র

কন্ট্রিল সনাক্তকরণের জন্য ব্যবহৃত স্যাটেলাইট ডেটার উৎস। ভবিষ্যতে অতিরিক্ত মান যোগ করা হতে পারে।

এনামস
DATA_SOURCE_UNSPECIFIED অনির্দিষ্ট তথ্য উৎস।
GOES_EAST_FULL_DISK GOES-East এর পূর্ণ ডিস্ক স্ক্যান থেকে প্রাপ্ত তথ্য।
GOES_WEST_FULL_DISK GOES-ওয়েস্টের পূর্ণ ডিস্ক স্ক্যান থেকে প্রাপ্ত তথ্য।
MTG_000_FULL_DISK MTG-000 পূর্ণ ডিস্ক স্ক্যান থেকে প্রাপ্ত তথ্য।
HIMAWARI_FULL_DISK হিমাওয়ারির পূর্ণ ডিস্ক স্ক্যান থেকে প্রাপ্ত তথ্য।