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 em BatchGetAttributionsRequest.names. A ordem das atribuições nessa lista corresponde à 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 estarão vazios.

Atribuição

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

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 da 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 no formato YYYY-MM-DD.
  • {departure_airport}: código do aeroporto IATA de três letras (por exemplo, "JFK", "LHR").
flightDetails

object (FlightDetails)

As informações detalhadas desse voo.
contrail

object (ContrailAttributes)

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

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

  • Se presente:a análise de rastros de condensação foi realizada. Os campos em ContrailAttributes indicam os resultados (por exemplo, lengthMeters > 0 significa que os rastros de condensação foram atribuídos).
  • Se ausente:a análise de rastros de condensação NÃO pôde ser realizada para esse voo.
    • Isso geralmente acontece devido a dados de entrada insuficientes (por exemplo, dados meteorológicos ausentes ou incerteza na trajetória de voo).
    • Isso NÃO significa que nenhum rastro de condensação foi formado, apenas que uma determinação não pôde ser feita.
segments[]

object (SegmentAttribution)

Atribuições de rastros de condensação por segmento. Cada entrada representa um intervalo de tempo distinto do voo ao qual 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 da companhia aérea IATA 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; int: época Unix OU str: ISO 8601.
icao24

string

Endereço de aeronave de 24 bits da ICAO
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). Se o indicativo de chamada específico do ATC não estiver disponível ou for o mesmo que o designador de voo padrão, esse campo vai conter o designador de voo padrão (normalmente 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 rastros de condensação de um voo ou segmento de voo.

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

integer

O comprimento, em metros, do subconjunto da trajetória de voo ao qual os rastros de condensação foram atribuídos. Isso é calculado como a distância do círculo máximo entre os pontos de passagem do voo.
effectiveEnergyForcingJoules

string (int64 format)

Força energética total do rastro de condensação, em joules. Atualmente, isso é calculado com base nas médias climatológicas e está sujeito 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)
    }
  ]
}
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 de é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 de época UTC.
contrail

object (ContrailAttributes)

Atributos de rastros de condensação 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 segmento de voo.

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)

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

integer

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

  • O rastro de condensação pode ter evoluído (por exemplo, espalhado, alongado 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 esse 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 a detecção de rastros de condensação. Outros valores poderão ser adicionados no futuro.

Atualmente, as saídas de dados de satélite GOES East e MTG estão disponíveis. As atribuições baseadas no GOES East têm qualidade de produção, enquanto as atribuições baseadas no MTG ainda estão na fase Beta e estão 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 de disco completo do MTG-000.
HIMAWARI_FULL_DISK Dados de verificações de disco completo do Himawari.

Licença

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