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)
  }
}
فیلدها
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 به این معنی است که ردپاها نسبت داده شده‌اند).
  • در صورت عدم وجود: تجزیه و تحلیل ردپا برای این پرواز امکان‌پذیر نبود.
    • این معمولاً به دلیل داده‌های ورودی ناکافی است (مثلاً، داده‌های هواشناسی از دست رفته یا عدم قطعیت مسیر پرواز).
    • این به این معنی نیست که هیچ ردی از دنباله‌دار تشکیل نشده، بلکه فقط به این معنی است که نمی‌توان در این مورد تصمیم قطعی گرفت.

جزئیات پرواز

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

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

icao24

string

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

originAirport

string

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

destinationAirport

string

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

callSign

string

علامت تماس هواپیمای مرتبط با نقطه مسیر.

analyzedFlightDistanceMeters

string ( int64 format)

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

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

ویژگی‌های ردّ هوا (contrails) برای یک پرواز را نشان می‌دهد.

نمایش JSON 
{
  "lengthMeters": string,
  "effectiveEnergyForcingJoules": string
}
فیلدها
lengthMeters

string ( int64 format)

طول تخمینی تشکیل ردپا، بر حسب متر.

effectiveEnergyForcingJoules

string ( int64 format)

کل انرژی مؤثر وارده به این پرواز، بر حسب ژول.