Atrybucje

Przypisane segmenty smug kondensacyjnych dla określonej listy lotów.

Format danych

Żądania przypisanych smug kondensacyjnych zawierają dane o następującej strukturze:

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

object (Attribution)

Lista atrybucji, po jednej dla każdej nazwy zasobu określonej w BatchGetAttributionsRequest.names. Kolejność atrybucji na tej liście będzie zgodna z kolejnością nazw w BatchGetAttributionsRequest. Jeśli lot nie został znaleziony, odpowiednia wiadomość Attribution 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 smug kondensacyjnych (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}

Elementy:

  • {carrier}: 2-znakowy 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}: 3-znakowy kod lotniska IATA (np. "JFK", "LHR").
flightDetails

object (FlightDetails)

Szczegółowe informacje o tym locie.
contrail

object (ContrailAttributes)

Zagregowane atrybuty smug kondensacyjnych dla całego lotu. Jest to suma atrybutów smug kondensacyjnych ze wszystkich przypisanych segmentów.

Interpretacja stanu (w przypadku znalezionego lotu):

  • Jeśli jest obecny: przeprowadzono analizę smug kondensacyjnych. Pola w ContrailAttributes wskazują wyniki (np. lengthMeters > 0 oznacza, że smugi kondensacyjne zostały przypisane).
  • Jeśli nie ma: nie można było przeprowadzić analizy smug kondensacyjnych dla tego lotu.
    • Zwykle wynika to z niewystarczających danych wejściowych (np. braku danych pogodowych lub niepewności co do trasy lotu).
    • Nie oznacza to, że nie powstały żadne smugi kondensacyjne, tylko że nie można było tego stwierdzić.
segments[]

object (SegmentAttribution)

Atrybucje smug 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 LUB 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 preferencyjnie znak wywoławczy używany w komunikacji z kontrolą ruchu lotniczego. Jeśli konkretny znak wywoławczy ATC jest niedostępny lub jest taki sam jak standardowy identyfikator lotu, to pole zawiera standardowy identyfikator lotu (zwykle połączenie kodu linii lotniczej i numeru lotu w przypadku lotów komercyjnych).
analyzedFlightDistanceMeters

integer

Odległość analizowanego lotu w metrach.

ContrailAttributes

Reprezentuje atrybuty smug kondensacyjnych dla lotu lub segmentu lotu.

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

integer

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

string (int64 format)

Łączna efektywna siła energetyczna smug kondensacyjnych w dżulach. Jest ona obecnie obliczana na podstawie średnich wartości klimatycznych i może ulec zmianie.

SegmentAttribution

Reprezentuje atrybucję smug kondensacyjnych dla określonego segmentu czasowego 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 przypisano smugi kondensacyjne. Ta sygnatura czasowa jest podana w sekundach epoki UTC.
endTime

string (Timestamp format)

Czas zakończenia segmentu lotu, do którego przypisano smugi kondensacyjne. Ta sygnatura czasowa jest podana w sekundach epoki UTC.
contrail

object (ContrailAttributes)

Atrybuty smug kondensacyjnych dla tego konkretnego segmentu.
detectionEvidences[]

object (ContrailDetectionEvidence)

Poszczególne wykrycia smug kondensacyjnych przez satelitę, które stanowią dowód na przypisanie 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 wykonania zdjęcia satelitarnego, na którym wykryto smugę kondensacyjną. Zwykle jest to czas rozpoczęcia skanowania. Ta sygnatura czasowa jest podana w sekundach epoki UTC.
observedLengthMeters

integer

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

  • Smuga kondensacyjna mogła się zmienić (np. rozszerzyć, wydłużyć itp.) w atmosferze między jej powstaniem a obserwacją.
  • Algorytm atrybucji mógł przypisać tylko część tej smugi kondensacyjnej do tego lotu.
dataSource

enum (DataSource)

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

DataSource

Źródło danych satelitarnych użytych do wykrycia smug kondensacyjnych. W przyszłości mogą zostać dodane dodatkowe wartości.

Obecnie dostępne są dane satelitarne z satelitów GOES East i MTG. Atrybucje na podstawie danych z satelity GOES East mają jakość produkcyjną, a atrybucje na podstawie danych z satelity MTG są nadal w fazie beta i aktywnie ulepszane.

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