Method: batchGetAttributions

چندین ویژگی ردپا را بر اساس اطلاعات پرواز دریافت می‌کند.

در صورت موفقیت، پاسخ، فهرستی از موارد انتساب ردپا خواهد بود.

درخواست HTTP

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

این URL از سینتکس Transcoding در 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} : کد فرودگاه سه حرفی یاتا (مثلاً "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} : کد فرودگاه سه حرفی یاتا (مثلاً "JFK" ، "LHR" ).
flightDetails

object ( FlightDetails )

اطلاعات دقیق این پرواز

contrail

object ( ContrailAttributes )

ویژگی‌های تجمعی ردپا برای کل پرواز. این، ویژگی‌های ردپا را از تمام بخش‌های اختصاص داده شده جمع می‌کند.

تفسیر ایالتی (در یک پرواز یافت شده):

  • در صورت وجود: تحلیل ردپا انجام شد. فیلدهای داخل ContrailAttributes نتایج را نشان می‌دهند (مثلاً lengthMeters > 0 به این معنی است که ردپاها نسبت داده شده‌اند).
  • در صورت عدم وجود: تجزیه و تحلیل ردپا برای این پرواز امکان‌پذیر نبود.
    • این معمولاً به دلیل داده‌های ورودی ناکافی است (مثلاً، داده‌های هواشناسی از دست رفته یا عدم قطعیت مسیر پرواز).
    • این به این معنی نیست که هیچ ردی از دنباله‌دار تشکیل نشده، بلکه فقط به این معنی است که نمی‌توان در این مورد تصمیم قطعی گرفت.

segments[]

object ( SegmentAttribution )

نسبت‌های ردپا به ازای هر بخش. هر ورودی نشان‌دهنده یک بازه زمانی مشخص از پرواز است که ردپا(ها) به آن نسبت داده شده است.

جزئیات پرواز

مجموعه کامل اطلاعات پرواز برگردانده شده در پاسخ را تعریف می‌کند.

نمایش 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: unix epoch; str: ISO 8601

icao24

string

آدرس ۲۴ بیتی هواپیما در ایکائو

originAirport

string

کد فرودگاه مبدا یاتا

destinationAirport

string

کد فرودگاه مقصد یاتا

callSign

string

علامت تماس هواپیما. این فیلد ترجیحاً شامل علامت تماس مورد استفاده در ارتباطات کنترل ترافیک هوایی (ATC) است. اگر علامت تماس خاص ATC در دسترس نباشد یا با علامت استاندارد پرواز یکسان باشد، این فیلد علامت استاندارد پرواز (معمولاً ترکیبی از کد شرکت هواپیمایی و شماره پرواز برای پروازهای تجاری) را در خود جای می‌دهد.

analyzedFlightDistanceMeters

integer

مسافت پرواز مورد تجزیه و تحلیل، بر حسب متر.

ویژگی‌های مسیر

ویژگی‌های ردپا را برای یک پرواز یا بخش پرواز نشان می‌دهد.

نمایش 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 )

ویژگی‌های Contrail برای این بخش خاص.

detectionEvidences[]

object ( ContrailDetectionEvidence )

ردیابی ردپاهای ماهواره‌ای منفرد که شواهدی برای انتساب به این بخش پروازی ارائه می‌دهد.

شواهد تشخیص مسیر

جزئیات مشاهده یک دنباله توسط یک ماهواره.

نمایش JSON 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
فیلدها
observationTime

string ( Timestamp format)

زمانی که تصویر ماهواره‌ای گرفته شده و در آن رد دنباله شناسایی شده است. این معمولاً زمان شروع اسکن است. این برچسب زمانی بر حسب ثانیه UTC است.

observedLengthMeters

integer

طول سر تا سر مشاهده شده از ویژگی خطی پس‌دمه بر حسب متر، همانطور که در تصویر ماهواره‌ای مشخص شده توسط observationTime شناسایی شده است. این طول می‌تواند با lengthMeters در SegmentAttribution.contrail متفاوت باشد زیرا:

  • ممکن است رد دنباله در جو بین تشکیل و مشاهده، تکامل یافته باشد (مثلاً پخش شده، طولانی‌تر شده و غیره).
  • الگوریتم انتساب تنها توانست با اطمینان بخشی از این ردپا را به این پرواز نسبت دهد.
dataSource

enum ( DataSource )

فقط خروجی. منبع داده‌های ماهواره‌ای مورد استفاده برای این تشخیص.

منبع داده

منبع داده‌های ماهواره‌ای مورد استفاده برای تشخیص ردپا. ممکن است در آینده مقادیر بیشتری اضافه شود.

انوم‌ها
DATA_SOURCE_UNSPECIFIED منبع داده نامشخص.
GOES_EAST_FULL_DISK داده‌های حاصل از اسکن کامل دیسک توسط GOES-East.
GOES_WEST_FULL_DISK داده‌های حاصل از اسکن کامل دیسک توسط GOES-West.
MTG_000_FULL_DISK داده‌های حاصل از اسکن کامل دیسک توسط MTG-000.
HIMAWARI_FULL_DISK داده‌های حاصل از اسکن کامل دیسک هیماواری.