Atribuições

Segmentos de rastros de condensação atribuídos para 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 em 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 ficarão vazios.

Atribuição

Representa um evento de rastro de condensação agregado para um voo específico, resumindo todos os segmentos de rastro 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)
    }
  ],
  "visualizationUrl": string
}
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 de companhia aérea IATA de 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 (disponível a partir de 2024).
  • {departure_airport}: código do aeroporto da IATA de três letras (por exemplo, "JFK", "LHR").
flightDetails

object (FlightDetails)

As informações detalhadas sobre este voo.
contrail

object (ContrailAttributes)

Atributos agregados de rastro para todo o voo. Isso soma os atributos de contrail de todos os segmentos atribuídos.

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

  • Se presente: a análise de rastro foi realizada. Os campos dentro de 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 força de energia foram avaliadas como zero.
  • Se ausente: NÃO foi possível realizar a análise de rastro de condensação para este voo.
    • Isso geralmente ocorre devido a dados de entrada insuficientes (por exemplo, falta de dados meteorológicos ou incerteza sobre a rota do voo).
    • Isso NÃO significa que nenhuma trilha foi formada, apenas que não foi possível fazer uma determinação.
segments[]

object (SegmentAttribution)

Atribuições de rastro de condensação por segmento. Cada entrada representa um intervalo de tempo distinto do voo ao qual as trilhas foram atribuídas.
visualizationUrl

string

Apenas saída. Link para uma visualização interativa da atribuição de rastro de condensação desse voo na página ContrailWatch do ContrailExplorer. Ele mostra a rota do voo correspondente aos rastros de condensação detectados por satélites.

Preenchido apenas para voos encontrados ao usar a visualização ATTRIBUTION_VIEW_OBSERVATION.

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 específico do ATC 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 do código da companhia aérea e do número do voo para voos comerciais).
analyzedFlightDistanceMeters

integer

Distância do voo analisado, em metros.

ContrailAttributes

Representa os atributos de rastro 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 rota de voo aos quais os rastros foram atribuídos. Isso é calculado como a distância do grande círculo entre os pontos de passagem do voo.
effectiveEnergyForcingJoules

string (int64 format)

Forçamento total de energia de rastro de condensação, em joules. Isso é feito extraindo a força radiativa efetiva das saídas de previsão do CoCiP em grade 4D e interpolando-as linearmente. Essa metodologia está sujeita a mudanças.

SegmentAttribution

Representa a atribuição de rastro 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 ao qual 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 ao qual os rastros de condensação são atribuídos. Esse carimbo de data/hora está em segundos da época UTC.
contrail

object (ContrailAttributes)

Atributos de contrail para esse segmento específico.
detectionEvidences[]

object (ContrailDetectionEvidence)

Detecções individuais de rastros de condensação por satélite que fornecem evidências para a atribuição a esse trecho do 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 o trajeto do voo do segmento foi gerado por interpolação em um longo intervalo de dados ADS-B (>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 de satélite de um rastro de condensação.

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

string (Timestamp format)

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

integer

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

  • A trilha 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 com confiança uma parte desse rastro de condensação a este voo.
dataSource

enum (DataSource)

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

DataSource

A fonte 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 nível 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 varreduras de disco completo do GOES-West.
MTG_000_FULL_DISK Dados de verificações de disco completo do MTG-000.
HIMAWARI_FULL_DISK Dados de varreduras de disco completo do Himawari.

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

WaypointAttribution

Representa os atributos de rastro de condensação de 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 waypoint em segundos da época UTC.
contrailAttributes

object (ContrailAttributes)

Os atributos de rastro mapeados nesse waypoint 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 por satélite.
ATTRIBUTION_METHOD_COCIP Atribuições que dependem estritamente da modelagem CoCiP baseada em física.
ATTRIBUTION_METHOD_OBSERVATION_ENHANCED_COCIP

Atribuição híbrida que combina as 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 maior.
  • Sem detecções: se detectionEvidences estiver ausente, 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 com base em observações:

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.