Method: flights.computeFlightEmissions

Método sem estado para recuperar estimativas de emissão. Detalhes sobre como as estimativas de emissão são calculadas: https://github.com/google/travel-impact-model

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

  • O voo é desconhecido para o servidor.
  • Faltam um ou mais identificadores no trecho de voo de entrada.
  • A data de veiculação está no passado.
  • O tipo de aeronave não é compatível com o modelo.
  • Configuração de licença ausente.

A solicitação pode conter até 1.000 trechos de voo. A solicitação tem mais de 1.000 voos diretos e falha 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

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

Definição de saída para a resposta [flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions].

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

object (FlightWithEmissions)

Lista de trechos do 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.

Avião

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

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

string

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

string

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

string

Obrigatório. Código da operadora 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 um dia, com ano zero (por exemplo, uma data comemorativa).
  • Um ano sozinho, com mês zero e dia zero.
  • Um ano e um mês, com um dia zero (por exemplo, uma data de validade do 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 9999 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)
  },
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
Campos
flight

object (Flight)

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

object (EmissionsGramsPerPax)

Opcional. Números estimados de emissão por passageiro. Não estará presente se não for possível calcular as emissões. Para ver uma lista de motivos pelos quais não foi possível calcular as emissões, consulte [flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions].

EmissionsGramsPerPax

Resultados de emissões agrupadas por classe de assentos.

Representação JSON 
{
  "first": integer,
  "business": integer,
  "premiumEconomy": integer,
  "economy": integer
}
Campos
first

integer

Emissões para um passageiro na primeira classe em gramas. Este campo sempre é calculado e preenchido, independentemente de a aeronave ter assentos de primeira classe ou não.
business

integer

Emissões para um passageiro na classe executiva em gramas. Este campo é sempre calculado e preenchido, independentemente de a aeronave ter assentos na classe executiva ou não.
premiumEconomy

integer

Emissões para um passageiro na classe econômica premium em gramas. Este campo é sempre calculado e preenchido, independentemente de a aeronave ter assentos da classe econômica premium.
economy

integer

Emissões para um passageiro na classe econômica, em gramas. Este campo é sempre calculado e preenchido, independentemente de a aeronave ter assentos na classe econômica.

ModelVersion

Versão do modelo de impacto de viagens. Para mais informações sobre o controle de versões do modelo, consulte https://github.com/google/travel-impact-model/#versioning.

Representação JSON 
{
  "major": integer,
  "minor": integer,
  "patch": integer,
  "dated": string
}
Campos
major

integer

Versões principais: alterações importantes na metodologia (por exemplo, adição de novas fontes de dados ao modelo que levam a grandes alterações no resultado). Essas mudanças não serão frequentes e serão anunciadas com bastante antecedência. Pode envolver alterações de versão da API, que respeitarão as diretrizes em https://cloud.google.com/endpoints/docs/openapi/versioning-an-api#backwards-incompatible
minor

integer

Versões secundárias: alterações no modelo que, embora sejam consistentes em todas as versões do esquema, alteram os parâmetros ou a implementação do modelo.
patch

integer

Versões de patch: mudanças de implementação destinadas a resolver bugs ou imprecisões na implementação do modelo.
dated

string

Versões datadas: os conjuntos de dados do modelo são recriados com dados de entrada atualizados, mas nenhuma alteração nos algoritmos regularmente.