Atrybucje

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

Format danych

Żądania dotyczące 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 odpowiadać kolejności nazw w pliku BatchGetAttributionsRequest. Jeśli lot nie zostanie znaleziony, 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 smug kondensacyjnych 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)
    }
  ],
  "visualizationUrl": string
}
Pola
name

string

Identyfikator. Nazwa zasobu lotu.

Format:

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

Komponenty:

  • {carrier}: 2-znakowy kod IATA przewoźnika (np. "AA", "UA").
  • {flightNumber}: numer lotu składający się z 1–4 cyfr (np. "123").
  • {departure_date}: data wylotu według czasu lokalnego lotniska początkowego w formacie YYYY-MM-DD (dostępna od 2024 r.).
  • {departure_airport}: trzyliterowy 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 ramach znalezionego lotu):

  • Jeśli jest obecna: przeprowadzono analizę smug kondensacyjnych. Pola w sekcji ContrailAttributes wskazują wyniki (np. lengthMeters > 0 oznacza, że smugi kondensacyjne zostały przypisane). Jeśli pojawi się pusta wiadomość ContrailAttributes, oznacza to, że analiza została przeprowadzona, ale zarówno lengthMeters, jak i wymuszenie energii zostały ocenione jako zero.
  • Jeśli nie: analiza smug kondensacyjnych NIE mogła zostać przeprowadzona dla tego lotu.
    • Zwykle jest to spowodowane niewystarczającą ilością danych wejściowych (np. brakiem danych o pogodzie lub niepewnością co do toru lotu).
    • NIE oznacza to, że nie powstały żadne smugi, tylko że nie udało się tego ustalić.
segments[]

object (SegmentAttribution)

Atrybucje smug kondensacyjnych na segment. Każdy wpis reprezentuje odrębny przedział czasu lotu, do którego przypisano smugi kondensacyjne.
visualizationUrl

string

Tylko dane wyjściowe. Link do interaktywnej wizualizacji atrybucji smug kondensacyjnych tego lotu na stronie ContrailWatch w ContrailExplorer. Pokazuje trasę lotu dopasowaną do smug kondensacyjnych wykrytych przez satelity.

Wartość jest podawana tylko w przypadku znalezionych lotów, gdy używasz widoku ATTRIBUTION_VIEW_OBSERVATION.

FlightDetails

Definiuje 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 w formacie RRRRMMDD.
icao24

string

24-bitowy adres statku powietrznego ICAO
originAirport

string

Kod IATA lotniska wylotu.
destinationAirport

string

Kod IATA lotniska docelowego.
callSign

string

Znak wywoławczy samolotu. To pole zawiera preferowany znak wywoławczy używany w komunikacji z kontrolą ruchu lotniczego (ATC). 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 kombinację 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) podzbiorów ścieżki lotu, do których przypisano smugi kondensacyjne. Jest ona obliczana jako odległość po ortodromie między punktami trasy lotu.
effectiveEnergyForcingJoules

string (int64 format)

Łączne efektywne wymuszanie energii przez smugi kondensacyjne w dżulach. Jest on obliczany przez wyodrębnienie efektywnego wymuszania radiacyjnego z wyników prognozy CoCiP w siatce 4D i ich liniową interpolację. Ta metodologia może ulec zmianie.

SegmentAttribution

Reprezentuje atrybucję smugi kondensacyjnej dla określonego segmentu czasowego lotu.

Zapis JSON 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}
Pola
startTime

string (Timestamp format)

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

string (Timestamp format)

Czas zakończenia segmentu lotu, do którego przypisane są smugi kondensacyjne. Ta sygnatura czasowa jest podawana w sekundach czasu uniksowego UTC.
contrail

object (ContrailAttributes)

Atrybuty smug kondensacyjnych dla tego konkretnego segmentu.
detectionEvidences[]

object (ContrailDetectionEvidence)

Wykryte przez satelitę pojedyncze smugi kondensacyjne, które stanowią dowód na przypisanie do tego segmentu lotu.
attributionMethod

enum (AttributionMethod)

Tylko dane wyjściowe. Metoda użyta do przypisania smug kondensacyjnych do tego segmentu (np. model CoCiP lub bezpośrednia obserwacja).
longGapInterpolation

boolean

Tylko dane wyjściowe. Wartość „True”, jeśli ścieżka lotu segmentu została wygenerowana przez interpolację w przypadku długiej przerwy w danych ADS-B (>5 minut).
waypointAttributions[]

object (WaypointAttribution)

Tylko dane wyjściowe. Atrybuty smug kondensacyjnych dla poszczególnych punktów orientacyjnych zmapowane w tym segmencie.

ContrailDetectionEvidence

Szczegóły pojedynczej obserwacji satelitarnej smugi kondensacyjnej.

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 podawana w sekundach czasu uniksowego 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. rozprzestrzenić, wydłużyć itp.) w atmosferze między momentem powstania a obserwacją.
  • Algorytm atrybucji był w stanie przypisać tylko część tej smugi kondensacyjnej do tego lotu.
dataSource

enum (DataSource)

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

DataSource

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

Wśród dostępnych danych satelitarnych atrybucje oparte na GOES East i Himawari mają jakość na poziomie produkcyjnym, natomiast atrybucje oparte na MTG są nadal w fazie beta i są aktywnie ulepszane.

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

Zdjęcia satelitarne w interfejsie Contrails API są oparte na:

WaypointAttribution

Reprezentuje atrybuty smug kondensacyjnych dla konkretnego punktu na trasie w segmencie lotu.

Zapis JSON 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
Pola
time

string (Timestamp format)

Czas w punkcie pośrednim w sekundach epoki UTC.
contrailAttributes

object (ContrailAttributes)

Atrybuty smug kondensacyjnych zmapowane w tym konkretnym punkcie trasy.

AttributionMethod

Określa konkretną procedurę lub metodologię używaną do przypisywania atrybucji.

Wartości w polu enum
ATTRIBUTION_METHOD_OBSERVATION Atrybucja oparta wyłącznie na dopasowaniu do wykrytych przez satelitę smug kondensacyjnych.
ATTRIBUTION_METHOD_COCIP Atrybucje oparte wyłącznie na fizycznym modelowaniu CoCiP.
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

Atrybucja hybrydowa łącząca prognozy modelu CoCiP skorygowane o wykrycia satelitarne.

  • Z wykryciami: jeśli występuje detectionEvidences, smuga kondensacyjna została przewidziana i potwierdzona przez obserwację, co zwiększa wagę ocieplenia.
  • Bez wykrywania: jeśli brakuje detectionEvidences, smugę kondensacyjną przewidywano, ale nie zaobserwowano, więc obliczone ocieplenie jest pomniejszone.
ATTRIBUTION_METHOD_UNSPECIFIED Nieokreślona metoda.

Uwagi

Każdy DataSource używa innych granic do przetwarzania widoków opartych na obserwacjach:

Ramki ograniczające zasięg satelitarny (płaski widok Mercatora)

Licencja

Dane udostępniane przez interfejs ContrailWatch Attributions API są objęte licencją CC BY-NC 4.0.