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 smugi 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, podsumowujące wszystkie przypisane segmenty smugi kondensacyjnej (np. łączną liczbę kilometrów i energię).

Zapis JSON 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ]
}
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)

Zagregowane atrybuty smug kondensacyjnych dla całego lotu. Sumuje atrybuty śladów kondensacyjnych ze wszystkich przypisanych segmentów.

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ć.
segments[]

object (SegmentAttribution)

Atrybucje śladów kondensacyjnych w poszczególnych segmentach. Każdy wpis reprezentuje odrębny przedział czasu lotu, do którego przypisano smugi kondensacyjne.

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": integer
}
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. To pole zawiera przede wszystkim znak wywoławczy używany w komunikacji z kontrolą ruchu lotniczego (ATC). Jeśli konkretny znak wywoławczy ATC jest niedostępny lub taki sam jak standardowy oznaczenie lotu, to pole zawiera standardowe oznaczenie lotu (zwykle kombinację kodu linii lotniczej i numeru lotu w przypadku lotów komercyjnych).
analyzedFlightDistanceMeters

integer

Dystans analizowanego lotu w metrach.

ContrailAttributes

Zawiera atrybuty śladu kondensacyjnego dla lotu lub jego odcinka.

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

integer

Długość w metrach podzbiorów ścieżki lotu, do których przypisano smugi kondensacyjne. Jest ona obliczana jako odległość po okręgu wielkim między punktami trasy lotu.
effectiveEnergyForcingJoules

string (int64 format)

Całkowite efektywne wymuszanie radiacyjne smug kondensacyjnych w dżulach. Jest ona obecnie obliczana na podstawie średnich klimatycznych i może ulec zmianie.

SegmentAttribution

Reprezentuje atrybucję śladów kondensacyjnych w określonym segmencie czasowym lotu.

Zapis JSON 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ]
}
Pola
startTime

string (Timestamp format)

Czas rozpoczęcia segmentu lotu, do którego przypisane są smugi kondensacyjne. Ta sygnatura czasowa jest podana w sekundach epoki UTC.
endTime

string (Timestamp format)

Godzina zakończenia segmentu lotu, do którego przypisane są smugi kondensacyjne. Ta sygnatura czasowa jest podana w sekundach epoki UTC.
contrail

object (ContrailAttributes)

Atrybuty Contrail dla tego konkretnego segmentu.
detectionEvidences[]

object (ContrailDetectionEvidence)

Poszczególne wykrycia śladów kondensacyjnych z satelity, które stanowią dowód na przypisanie ich do tego segmentu lotu.

ContrailDetectionEvidence

Szczegóły pojedynczej obserwacji smugi kondensacyjnej przez satelitę.

Zapis JSON 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
Pola
observationTime

string (Timestamp format)

Czas, w którym wykonano zdjęcie satelitarne, na którym wykryto ślad kondensacyjny. Jest to zwykle czas rozpoczęcia skanowania. Ta sygnatura czasowa jest podana w sekundach epoki UTC.
observedLengthMeters

integer

Obserwowana długość liniowej smugi kondensacyjnej w metrach, wykryta na zdjęciu satelitarnym określonym przez observationTime. Długość ta może się różnić od wartości lengthMeters w SegmentAttribution.contrail, ponieważ:

  • Ślad kondensacyjny mógł się zmienić (np. rozprzestrzenić, wydłużyć itp.) w atmosferze między jego powstaniem a obserwacją.
  • Algorytm atrybucji był w stanie przypisać do tego lotu tylko część tej smugi kondensacyjnej.
dataSource

enum (DataSource)

Tylko dane wyjściowe. Źródło danych satelitarnych użytych do wykrycia.

DataSource

Źródło danych satelitarnych używanych do wykrywania smug kondensacyjnych. W przyszłości możemy dodać kolejne wartości.

Wartości w polu enum
DATA_SOURCE_UNSPECIFIED Nieokreślone źródło danych.
GOES_EAST_FULL_DISK Dane z pełnych skanów dysku GOES-East.
GOES_WEST_FULL_DISK Dane z pełnych skanów dysku GOES-West.
MTG_000_FULL_DISK Dane z pełnych skanów dysku MTG-000.
HIMAWARI_FULL_DISK Dane z pełnych skanów dysku Himawari.