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 ficarã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)
  }
}
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)

Detalhes sobre os rastros de condensação atribuídos ao voo.

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.

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": string
}
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 associada ao ponto de passagem.
analyzedFlightDistanceMeters

string (int64 format)

Distância do voo analisado, em metros.

ContrailAttributes

Representa os atributos de rastros de condensação de um voo.

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

string (int64 format)

Comprimento estimado da formação de rastros de condensação, em metros.
effectiveEnergyForcingJoules

string (int64 format)

Força energética efetiva total atribuída a este voo, em joules.