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.

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 são maiúsculos.
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 as emissões não puderem ser calculadas. 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.

Tipos enumerados
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, na sigla em inglês) 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 CO2e 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.

Tipos enumerados
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.