Method: batchGetAttributions

Recebe várias atribuições de rastros de condensação por informações de voo.

Se a solicitação for bem-sucedida, a resposta será uma lista de atribuições de rastros de condensação.

Solicitação HTTP

GET https://contrails.googleapis.com/v2/{parent=attributions}:batchGet

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O recurso principal compartilhado por todas as atribuições que estão sendo recuperadas. Formato: atribuições

Parâmetros de consulta

Parâmetros
names[]

string

Obrigatório. Os nomes de recursos dos voos a serem recuperados. É possível fornecer até 100 nomes em uma única solicitação.

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

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta que contém os rastros de condensação atribuídos para "attributions.batchGet".

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

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 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:uma análise de contrail 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: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 int: época Unix; str: ISO 8601.
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 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 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 passagem do voo.
effectiveEnergyForcingJoules

string (int64 format)

Forçante energética total efetiva de rastros de condensação, em joules. No momento, esse cálculo é feito com base em 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 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 de 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 trecho de voo.

ContrailDetectionEvidence

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

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

string (Timestamp format)

Data e hora em que a imagem de satélite foi tirada e em que 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. Esse período 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 ao 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.

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.