Method: batchGetAttributions

Pobiera wiele atrybucji smug kondensacyjnych na podstawie informacji o locie.

Jeśli operacja się uda, odpowiedź będzie zawierać listę atrybucji śladów kondensacyjnych.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Zasób nadrzędny udostępniony przez wszystkie pobierane atrybucje. Format: attributions

Parametry zapytania

Parametry
names[]

string

Wymagane. Nazwy zasobów lotów do pobrania. W jednym żądaniu można podać maksymalnie 100 nazw.

Format:

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

Komponenty:

  • {carrier}: dwuznakowy kod IATA przewoźnika (np. "AA", "UA").
  • {flightNumber}: 1–4-cyfrowy numer lotu (np. "123").
  • {departure_date}: data wylotu w formacie YYYY-MM-DD.
  • {departure_airport}: trzyliterowy kod IATA lotniska (np. "JFK", "LHR").

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź zawierająca przypisane ślady kondensacyjne dla attributions.batchGet.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
Pola
attributions[]

object (Attribution)

Lista atrybucji, po jednej dla każdej nazwy zasobu podanej w parametrze BatchGetAttributionsRequest.names. Kolejność atrybucji na tej liście będzie zgodna z kolejnością nazw w BatchGetAttributionsRequest. Jeśli nie znaleziono lotu, odpowiedni komunikat o atrybucji w odpowiedzi będzie zawierać tylko wypełnione pole name, a pola flightDetails i contrail będą puste.

Atrybucja

Reprezentuje zagregowane zdarzenie smugi kondensacyjnej dla konkretnego lotu, które podsumowuje wszystkie przypisane segmenty smugi kondensacyjnej (np. łączną liczbę kilometrów i energię).

Zapis JSON 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  }
}
Pola
name

string

Identyfikator. Nazwa zasobu lotu.

Format:

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

Komponenty:

  • {carrier}: dwuznakowy kod IATA przewoźnika (np. "AA", "UA").
  • {flightNumber}: 1–4-cyfrowy numer lotu (np. "123").
  • {departure_date}: data wylotu w formacie YYYY-MM-DD.
  • {departure_airport}: trzyliterowy kod IATA lotniska (np. "JFK", "LHR").
flightDetails

object (FlightDetails)

Szczegółowe informacje o tym locie.
contrail

object (ContrailAttributes)

Szczegóły przypisanych smug kondensacyjnych dla lotu.

Interpretacja stanu (w przypadku znalezionego lotu):

  • Jeśli występuje: przeprowadzono analizę śladów kondensacyjnych. Pola w ContrailAttributes wskazują wyniki (np. lengthMeters > 0 oznacza, że ślady kondensacyjne zostały przypisane).
  • Jeśli nie ma: w przypadku tego lotu NIE można było przeprowadzić analizy śladów kondensacyjnych.
    • Zwykle wynika to z niewystarczających danych wejściowych (np. brak danych o pogodzie lub niepewność ścieżki lotu).
    • NIE oznacza to, że nie powstały smugi kondensacyjne, tylko że nie można było tego stwierdzić.

FlightDetails

Określa pełny zestaw informacji o locie zwracanych w odpowiedzi.

Zapis JSON 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": string
}
Pola
carrier

string

Kod IATA przewoźnika obsługującego lot (np. „AA”).
flightNumber

integer

Numer lotu (np. „123”).
departureTime

string

Data wylotu w strefie czasowej lotniska wylotu int: epoka systemu Unix; str: ISO 8601.
icao24

string

24-bitowy adres samolotu ICAO
originAirport

string

Kod IATA lotniska wylotu.
destinationAirport

string

Kod IATA lotniska docelowego.
callSign

string

Znak wywoławczy samolotu powiązanego z punktem trasy.
analyzedFlightDistanceMeters

string (int64 format)

Dystans analizowanego lotu w metrach.

ContrailAttributes

Reprezentuje atrybuty smug kondensacyjnych dla lotu.

Zapis JSON 
{
  "lengthMeters": string,
  "effectiveEnergyForcingJoules": string
}
Pola
lengthMeters

string (int64 format)

Szacunkowa długość powstawania smug kondensacyjnych w metrach.
effectiveEnergyForcingJoules

string (int64 format)

Całkowita efektywna siła energetyczna przypisana do tego lotu w dżulach.