Atribuições

Segmentos de rastros de condensação atribuídos a uma lista específica de voos.

Formato de dados

As solicitações de rastros de condensação atribuídos contêm dados com a seguinte estrutura:

Representação JSON 
{
  "attributions": [
    {
      object (Attribution)
    }
  ]
}
Campos
attributions[]

object (Attribution)

Uma lista de atribuições, uma para cada nome de recurso especificado no BatchGetAttributionsRequest.names. A ordem das atribuições nessa lista vai corresponder à ordem dos nomes no BatchGetAttributionsRequest. Se um voo não for encontrado, a mensagem de atribuição correspondente na resposta terá apenas o campo name preenchido, enquanto flightDetails e contrail estarão vazios.

Atribuição

Representa um evento de condensação agregado para um voo específico, resumindo todos os segmentos de condensação atribuídos (por exemplo, total de quilômetros e energia).

Representação JSON 
{
  "name": string,
  "flightDetails": {
    object (FlightDetails)
  },
  "contrail": {
    object (ContrailAttributes)
  },
  "segments": [
    {
      object (SegmentAttribution)
    }
  ]
}
Campos
name

string

Identificador. O nome do recurso do voo.

Formato:

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

Componentes:

  • {carrier}: código IATA da transportadora com dois caracteres (por exemplo, "AA", "UA").
  • {flightNumber}: número do voo de 1 a 4 dígitos (por exemplo, "123").
  • {departure_date}: data de partida do voo de acordo com o horário local do aeroporto de origem no formato YYYY-MM-DD.
  • {departure_airport}: código IATA do aeroporto com três letras (por exemplo, "JFK", "LHR").
flightDetails

object (FlightDetails)

As informações detalhadas deste voo.
contrail

object (ContrailAttributes)

Atributos agregados de rastros de condensação para todo o voo. Isso resume os atributos de contrail de todos os segmentos atribuídos.

Interpretação do estado (em um voo encontrado):

  • Se presente:foi realizada uma análise de contrail. Os campos em ContrailAttributes indicam os resultados. Por exemplo, lengthMeters > 0 significa que rastros de condensação foram atribuídos. Se uma mensagem ContrailAttributes vazia estiver presente, isso significa que a análise foi realizada, mas lengthMeters e a imposição de energia foram avaliadas como zero.
  • Se estiver ausente:não foi possível realizar a análise de rastros de condensação para este voo.
    • Isso geralmente acontece devido a dados de entrada insuficientes (por exemplo, falta de dados meteorológicos ou incerteza na trajetória de voo).
    • Isso NÃO significa que não houve formação de rastros de condensação, apenas que não foi possível fazer uma determinação.
segments[]

object (SegmentAttribution)

Atribuições de rastros de condensação por segmento. Cada entrada representa um intervalo de tempo distinto do voo a que os rastros de condensação foram atribuídos.

FlightDetails

Define o conjunto completo de informações de voo retornadas na resposta.

Representação JSON 
{
  "carrier": string,
  "flightNumber": integer,
  "departureTime": string,
  "icao24": string,
  "originAirport": string,
  "destinationAirport": string,
  "callSign": string,
  "analyzedFlightDistanceMeters": integer
}
Campos
carrier

string

Código IATA da companhia aérea do voo (por exemplo, "AA").
flightNumber

integer

Número do voo (por exemplo, "123").
departureTime

string

Data de partida no fuso horário do aeroporto de origem no formato AAAAMMDD.
icao24

string

Endereço de aeronave de 24 bits da OACI
originAirport

string

Código IATA do aeroporto de origem.
destinationAirport

string

Código IATA do aeroporto de destino.
callSign

string

Indicativo de chamada da aeronave. Esse campo contém preferencialmente o indicativo de chamada usado nas comunicações de controle de tráfego aéreo (ATC, na sigla em inglês). Se o indicativo de chamada ATC específico não estiver disponível ou for igual ao designador de voo padrão, esse campo vai conter o designador de voo padrão (geralmente uma combinação de código da companhia aérea e número do voo para voos comerciais).
analyzedFlightDistanceMeters

integer

Distância do voo analisado, em metros.

ContrailAttributes

Representa os atributos de esteira de condensação de um voo ou trecho de voo.

Representação JSON 
{
  "lengthMeters": integer,
  "effectiveEnergyForcingJoules": string
}
Campos
lengthMeters

integer

O comprimento, em metros, dos subconjuntos da trajetória de voo a que os rastros de condensação foram atribuídos. Isso é calculado como a distância do grande círculo entre os pontos de referência do voo.
effectiveEnergyForcingJoules

string (int64 format)

Forçante energética total efetiva de rastros de condensação, em joules. Isso é derivado da extração do forçamento radiativo efetivo das saídas de previsão do CoCiP em grade 4D e da interpolação linear delas. Essa metodologia está sujeita a mudanças.

SegmentAttribution

Representa a atribuição de rastros de condensação para um segmento de tempo específico de um voo.

Representação JSON 
{
  "startTime": string,
  "endTime": string,
  "contrail": {
    object (ContrailAttributes)
  },
  "detectionEvidences": [
    {
      object (ContrailDetectionEvidence)
    }
  ],
  "attributionMethod": enum (AttributionMethod),
  "longGapInterpolation": boolean,
  "waypointAttributions": [
    {
      object (WaypointAttribution)
    }
  ]
}
Campos
startTime

string (Timestamp format)

Horário de início do segmento de voo a que os rastros de condensação são atribuídos. Esse carimbo de data/hora está em segundos da época UTC.
endTime

string (Timestamp format)

Horário de término do segmento de voo a que os rastros de condensação são atribuídos. Esse carimbo de data/hora está em segundos da época UTC.
contrail

object (ContrailAttributes)

Atributos do Contrail para esse segmento específico.
detectionEvidences[]

object (ContrailDetectionEvidence)

Detecções individuais de rastros de condensação de satélites que fornecem evidências para a atribuição a esse segmento de voo.
attributionMethod

enum (AttributionMethod)

Apenas saída. O método usado para atribuir rastros de condensação a esse segmento (por exemplo, modelo CoCiP ou observação direta).
longGapInterpolation

boolean

Apenas saída. Verdadeiro se a trajetória de voo do segmento foi gerada por interpolação em uma longa lacuna de dados do ADS-B (mais de 5 minutos).
waypointAttributions[]

object (WaypointAttribution)

Apenas saída. Atributos de rastro de condensação por ponto de referência mapeados nesse segmento.

ContrailDetectionEvidence

Detalhes de uma única observação por satélite de uma esteira de condensação.

Representação JSON 
{
  "observationTime": string,
  "observedLengthMeters": integer,
  "dataSource": enum (DataSource)
}
Campos
observationTime

string (Timestamp format)

Horário em que a imagem de satélite foi tirada e o rastro de condensação foi detectado. Normalmente, esse é o horário de início da leitura. Esse carimbo de data/hora está em segundos da época UTC.
observedLengthMeters

integer

O comprimento de ponta a ponta observado do rastro de condensação linear em metros, conforme detectado na imagem de satélite especificada por observationTime. Essa duração pode ser diferente do lengthMeters em SegmentAttribution.contrail porque:

  • O rastro pode ter evoluído (por exemplo, se espalhado, aumentado etc.) na atmosfera entre a formação e a observação.
  • O algoritmo de atribuição só conseguiu atribuir uma parte desse rastro de condensação a esse voo.
dataSource

enum (DataSource)

Apenas saída. A origem dos dados de satélite usados para essa detecção.

DataSource

A origem dos dados de satélite usados para detecção de rastros de condensação. Outros valores podem ser adicionados no futuro.

Entre as saídas de dados de satélite disponíveis, as atribuições baseadas no GOES East e no Himawari têm qualidade de produção, enquanto as atribuições baseadas no MTG ainda estão na fase Beta e passando por melhorias de qualidade.

Tipos enumerados
DATA_SOURCE_UNSPECIFIED Fonte de dados não especificada.
GOES_EAST_FULL_DISK Dados de verificações de disco completo do GOES-East.
GOES_WEST_FULL_DISK Dados de verificações de disco completo do GOES-West.
MTG_000_FULL_DISK Dados de verificações completas do disco MTG-000.
HIMAWARI_FULL_DISK Dados de verificações de disco completo do Himawari.

As imagens de satélite da API Contrails são baseadas em:

WaypointAttribution

Representa atributos de esteira de condensação para um ponto de referência específico em um trecho de voo.

Representação JSON 
{
  "time": string,
  "contrailAttributes": {
    object (ContrailAttributes)
  }
}
Campos
time

string (Timestamp format)

O horário no ponto de referência em segundos da época UTC.
contrailAttributes

object (ContrailAttributes)

Os atributos de rastro mapeados neste ponto de referência específico.

AttributionMethod

Define o procedimento ou a metodologia específica usada para fazer a atribuição.

Tipos enumerados
ATTRIBUTION_METHOD_OBSERVATION Atribuição derivada estritamente da correspondência com detecções de rastros de condensação de satélites.
ATTRIBUTION_METHOD_COCIP Atribuições baseadas estritamente na modelagem CoCiP orientada pela física.
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

Atribuição híbrida que combina previsões do modelo CoCiP ajustadas por detecções de satélite.

  • Com detecções:se detectionEvidences estiver presente, o rastro de condensação foi previsto e confirmado por observação, recebendo um peso de aquecimento aprimorado.
  • Sem detecções:se detectionEvidences estiver faltando, o rastro foi previsto, mas não observado. Portanto, o aquecimento calculado é descontado.
ATTRIBUTION_METHOD_UNSPECIFIED Método não especificado.

Observações

Cada DataSource usa limites diferentes para processar visualizações baseadas em observação:

Caixas delimitadoras de cobertura de satélite (visualização plana de Mercator)

Licença

Os dados expostos pela API ContrailWatch Attributions são licenciados de acordo com a CC BY-NC 4.0 (em inglês).