Method: flights.computeFlightEmissions

Método sem estado para recuperar estimativas de emissão. Confira detalhes sobre como as estimativas de emissão são calculadas no GitHub (em inglês).

A resposta vai conter todas as entradas que correspondem aos trechos de voo de entrada, na mesma ordem. Se não houver estimativas disponíveis para um determinado trecho de voo, a resposta vai retornar o objeto do trecho com campos de emissão vazios. A solicitação ainda será considerada bem-sucedida. Estes são alguns motivos para a ausência de estimativas de emissão:

  • O voo é desconhecido para o servidor.
  • O trecho de voo de entrada não tem um ou mais identificadores.
  • A data do voo é anterior à data atual.
  • O tipo de aeronave não é compatível com o modelo.
  • Configuração de licenças ausente.

A solicitação pode conter até 1.000 trechos de voo. Se a solicitação tiver mais de mil voos diretos, ela vai falhar com um erro INVALID_ARGUMENT.

Solicitação HTTP

POST https://travelimpactmodel.googleapis.com/v1/flights:computeFlightEmissions

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

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "flights": [
    {
      object (Flight)
    }
  ]
}
Campos
flights[]

object (Flight)

Obrigatório. Voos diretos para retornar estimativas de emissão.

Corpo da resposta

Definição de saída para a resposta flights.computeFlightEmissions.

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

Representação JSON 
{
  "flightEmissions": [
    {
      object (FlightWithEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Campos
flightEmissions[]

object (FlightWithEmissions)

Lista de trechos de voo com estimativas de emissão.
modelVersion

object (ModelVersion)

A versão do modelo em que as estimativas de emissão de todos os voos nesta resposta foram calculadas.

Voos

Todos os detalhes relacionados a um único item de solicitação para estimativas de emissão de voo direto.

Representação JSON 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
Campos
origin

string

Obrigatório. Código IATA do aeroporto de origem do voo, por exemplo, "LHR".
destination

string

Obrigatório. Código IATA do aeroporto de destino do voo, por exemplo, "JFK".
operatingCarrierCode

string

Obrigatório. Código da transportadora IATA, por exemplo, "AA".
flightNumber

integer

Obrigatório. Número do voo, por exemplo, 324.
departureDate

object (Date)

Obrigatório. Data do voo no fuso horário do aeroporto de origem. Precisa ser uma data no presente ou no futuro.

Data

Representa uma data inteira ou parcial do calendário, como um aniversário. A hora do dia e o fuso horário são especificados em outro lugar ou são insignificantes. A data é referente ao calendário gregoriano. Isso pode representar uma das seguintes opções:

  • uma data completa, com valores de ano, mês e dia diferentes de zero;
  • um mês e dia, com um ano zero (por exemplo, uma data comemorativa);
  • um ano sozinho, com um mês zero e um dia zero;
  • um ano e mês, com um dia zero (por exemplo, uma data de validade de cartão de crédito).

Tipos relacionados:

Representação JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Ano da data. Precisa ser de 1 a 9.999 ou 0 para especificar uma data sem ano.
month

integer

Mês do ano. Precisa ser de 1 a 12, ou 0 para especificar um ano sem um mês e dia.
day

integer

Dia do mês. Precisa ser de 1 a 31 e válido para o ano e o mês, ou 0 para especificar um ano sozinho ou um ano e mês em que o dia não é significativo.

FlightWithEmissions

Voo direto com estimativas de emissão.

Representação JSON 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
Campos
flight

object (Flight)

Obrigatório. Corresponde aos identificadores de voo na solicitação. Observação: todos os códigos da IATA estão em maiúsculas.
source

enum (Source)

Opcional. A origem dos dados de emissões.
emissionsGramsPerPax

object (EmissionsGramsPerPax)

Opcional. Estimativas de emissão por passageiro. Não estará presente se não for possível calcular as emissões. Para conferir a lista de motivos pelos quais as emissões não puderam ser calculadas, consulte flights.computeFlightEmissions.
easaLabelMetadata

object (EasaLabelMetadata)

Opcional. Metadados sobre o selo de emissões de voo da EASA. Definido apenas quando a fonte de dados de emissões é a EASA.
contrailsImpactBucket

enum (ContrailsImpactBucket)

Opcional. A importância do impacto do aquecimento dos rastros de condensação em comparação com o impacto total das emissões de CO₂e.

Origem

A origem dos dados de emissões.

Enums
SOURCE_UNSPECIFIED A origem dos dados de emissões não é especificada.
TIM Os dados de emissões são do Modelo de impacto de viagens.
EASA Os dados de emissões são dos rótulos ambientais da EASA.

EasaLabelMetadata

Metadados sobre o selo de emissões de voo da EASA.

Representação JSON 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
Campos
labelIssueDate

object (Date)

A data em que o rótulo foi emitido.
labelExpiryDate

object (Date)

A data de expiração do rótulo. O marcador pode ser exibido até o final dessa data.
labelVersion

string

Versão do rótulo.
safDiscountPercentage

number

Porcentagem de desconto nas emissões de combustível de aviação sustentável (SAF) aplicada ao rótulo. É uma porcentagem como um decimal. Os valores estão no intervalo [0,1]. Por exemplo, 0,0021 significa 0,21%.

Esse desconto e a redução nas emissões são informados pelo rótulo da EASA, mas não estão incluídos nas estimativas de CO₂e distribuídas por essa API.

ContrailsImpactBucket

A importância do impacto do aquecimento dos rastros de condensação em comparação com o impacto total das emissões de CO₂e.

Enums
CONTRAILS_IMPACT_UNSPECIFIED O impacto das esteiras de condensação não foi especificado.
CONTRAILS_IMPACT_NEGLIGIBLE O impacto dos rastros de condensação é insignificante em comparação com as emissões totais de CO₂e.
CONTRAILS_IMPACT_MODERATE O impacto dos rastros de condensação é comparável ao total de emissões de CO₂e.
CONTRAILS_IMPACT_SEVERE O impacto dos rastros de condensação é maior do que o impacto total das emissões de CO₂e.