Package google.travel.sustainability.travelimpactmodel.v1

Índice

• TravelImpactModelService (interface)
• ComputeFlightEmissionsRequest (mensagem)
• ComputeFlightEmissionsResponse (mensagem)
• ComputeScope3FlightEmissionsRequest (mensagem)
• ComputeScope3FlightEmissionsResponse (mensagem)
• ComputeTypicalFlightEmissionsRequest (mensagem)
• ComputeTypicalFlightEmissionsResponse (mensagem)
• ContrailsImpactBucket (enum)
• EasaLabelMetadata (mensagem)
• EmissionsGramsPerPax (mensagem)
• Flight (mensagem)
• FlightWithEmissions (mensagem)
• Market (mensagem)
• ModelVersion (mensagem)
• Scope3FlightEmissions (mensagem)
• Scope3FlightEmissions.Scope3DataType (enum)
• Scope3FlightSegment (mensagem)
• Scope3FlightSegment.CabinClass (enum)
• Source (enum)
• TypicalFlightEmissions (mensagem)

TravelImpactModelService

API para fornecer estimativas de emissão de carbono.

ComputeFlightEmissions

rpc ComputeFlightEmissions(ComputeFlightEmissionsRequest) returns (ComputeFlightEmissionsResponse) 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. Os motivos para a ausência de estimativas de emissão incluem: 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.

ComputeScope3FlightEmissions

rpc ComputeScope3FlightEmissions(ComputeScope3FlightEmissionsRequest) returns (ComputeScope3FlightEmissionsResponse) Método sem estado para recuperar estimativas de emissões de gases de efeito estufa de um conjunto de trechos de voo para relatórios do Escopo 3. A resposta vai conter todas as entradas que correspondem aos segmentos de voo Scope3FlightSegment de entrada, na mesma ordem fornecida. As estimativas serão calculadas usando a seguinte lógica em cascata (usando a primeira disponível): Emissões com base no TIM, considerando origin, destination, carrier, flightNumber, departureDate e cabinClass. Emissões típicas de voos considerando origin, destination, ano em departureDate e cabinClass. Emissões com base na distância calculadas usando distanceKm, ano em departureDate e cabinClass. Se houver um voo futuro solicitado neste ano civil, não vamos oferecer suporte às emissões de nível 1 e vamos usar as de nível 2 ou 3. Se o voo futuro solicitado não for neste ano civil, vamos retornar uma resposta vazia. Recomendamos que, para voos futuros, a API computeFlightEmissions seja usada. Se não houver estimativas disponíveis para um determinado voo com nenhum dos três métodos, a resposta vai retornar um objeto Scope3FlightEmissions com campos de emissão vazios. A solicitação ainda será considerada bem-sucedida. Em geral, as estimativas de emissões ausentes ocorrem quando o voo é desconhecido para o servidor (por exemplo, não existe um voo específico ou as emissões típicas de voos não estão disponíveis para o par solicitado). A solicitação vai falhar com um erro INVALID_ARGUMENT se: A solicitação contém mais de 1.000 trechos de voo. O trecho de voo de entrada não tem um ou mais identificadores. Por exemplo, origem/destino ausente sem uma distância válida para correspondência de tipo TIM_EMISSIONS ou TYPICAL_FLIGHT_EMISSIONS ou distância ausente para uma correspondência de tipo DISTANCE_BASED_EMISSIONS. Se você quiser usar emissões com base na distância ou uma estimativa de emissões com base na distância, especifique uma distância. A data do voo é anterior a 2019 (os dados do escopo 3 só estão disponíveis para 2019 e depois). A distância do voo é 0 ou menor. A classe do voo está faltando. Como a solicitação é processada com lógica de substituição, é possível que solicitações mal configuradas retornem estimativas de emissões válidas usando métodos de substituição. Por exemplo, se uma solicitação tiver o número do voo errado, mas especificar a origem e o destino, ela ainda será bem-sucedida, mas as emissões retornadas serão baseadas apenas nas emissões típicas do voo. Da mesma forma, se uma solicitação não tiver a origem de uma solicitação típica de emissões de voo, mas especificar uma distância válida, ela poderá ser bem-sucedida com base apenas nas emissões por distância. Portanto, é necessário verificar a origem das emissões retornadas (source) para confirmar se os resultados estão como esperado.

ComputeTypicalFlightEmissions

rpc ComputeTypicalFlightEmissions(ComputeTypicalFlightEmissionsRequest) returns (ComputeTypicalFlightEmissionsResponse) Recupera estimativas típicas de emissões de voos entre dois aeroportos, também conhecidos como mercado. Se não houver estimativas disponíveis para um determinado mercado, a resposta vai retornar o objeto de mercado com campos de emissão vazios. A solicitação ainda será considerada bem-sucedida. Confira detalhes sobre como as estimativas de emissões típicas são calculadas no GitHub (em inglês). A solicitação pode conter até 1.000 mercados. Se a solicitação tiver mais de mil mercados, ela vai falhar com um erro INVALID_ARGUMENT.

ComputeFlightEmissionsRequest

Definição de entrada para a solicitação ComputeFlightEmissions.

Campos
flights[]	Flight Obrigatório. Voos diretos para retornar estimativas de emissão.

ComputeFlightEmissionsResponse

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

Campos
flight_emissions[]	FlightWithEmissions Lista de trechos de voo com estimativas de emissão.
model_version	ModelVersion A versão do modelo em que as estimativas de emissão de todos os voos nesta resposta foram calculadas.

ComputeScope3FlightEmissionsRequest

Uma lista de trechos de voo para solicitar as emissões do Escopo 3.

Campos
flights[]	Scope3FlightSegment Obrigatório. Voos para retornar estimativas de emissão.
model_version	ModelVersion Opcional. A versão do modelo em que as estimativas de emissão de todos os voos nesta solicitação foram calculadas.

ComputeScope3FlightEmissionsResponse

Uma lista de voos com estimativas de emissão do Escopo 3.

Campos
flight_emissions[]	Scope3FlightEmissions Lista de trechos de voo com estimativas de emissão.
model_version	ModelVersion A versão do modelo em que as estimativas de emissão de todos os voos nesta resposta foram calculadas.

ComputeTypicalFlightEmissionsRequest

Uma lista de pares de aeroportos (mercados) para solicitar as emissões típicas.

Campos
markets[]	Market Obrigatório. Solicita as estimativas típicas de emissões de voos para esse par de mercados. É possível solicitar no máximo 1.000 mercados.

ComputeTypicalFlightEmissionsResponse

A resposta inclui as emissões e a versão do modelo.

Campos
typical_flight_emissions[]	TypicalFlightEmissions Emissões típicas de voos do mercado solicitadas.
model_version	ModelVersion A versão do modelo em que as estimativas de emissão de voos típicos para todos os voos nesta resposta foram calculadas.

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.

EasaLabelMetadata

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

Campos
label_issue_date	Date A data em que o rótulo foi emitido.
label_expiry_date	Date A data de expiração do rótulo. O marcador pode ser exibido até o final dessa data.
label_version	string Versão do rótulo.
saf_discount_percentage	double 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.

EmissionsGramsPerPax

Resultados de emissões agrupadas por classe de voo.

Campos
first	int32 Emissões para um passageiro na primeira classe em gramas. Esse campo é sempre calculado e preenchido, independentemente de a aeronave ter assentos de primeira classe ou não.
business	int32 Emissões para um passageiro na classe executiva em gramas. Esse campo é sempre calculado e preenchido, independente de a aeronave ter assentos na classe executiva ou não.
premium_economy	int32 Emissões de um passageiro na classe econômica premium em gramas. Esse campo é sempre calculado e preenchido, independentemente de a aeronave ter assentos na classe econômica premium ou não.
economy	int32 Emissões para um passageiro na classe econômica em gramas. Esse campo é sempre calculado e preenchido, independentemente de a aeronave ter assentos na classe econômica ou não.

Voos

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

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".
operating_carrier_code	string Obrigatório. Código da transportadora IATA, por exemplo, "AA".
flight_number	int32 Obrigatório. Número do voo, por exemplo, 324.
departure_date	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.

Campos
flight	Flight Obrigatório. Corresponde aos identificadores de voo na solicitação. Observação: todos os códigos da IATA são maiúsculos.
source	Source Opcional. A origem dos dados de emissões.
emissions_grams_per_pax	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 ComputeFlightEmissions.
easa_label_metadata	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.
contrails_impact_bucket	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.

Mercado

Um par de aeroportos.

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".

ModelVersion

Versão do modelo de impacto das viagens. Para mais informações sobre o controle de versões de modelos, consulte o GitHub (em inglês).

Campos
major	int32 Versões principais: mudanças significativas na metodologia (por exemplo, adição de novas fontes de dados ao modelo que levam a grandes mudanças na saída). Essas mudanças serão raras e anunciadas com bastante antecedência. Pode envolver mudanças na versão da API, que vão respeitar as diretrizes da API do Google Cloud
minor	int32 Versões secundárias: mudanças no modelo que, embora sejam consistentes em todas as versões do esquema, alteram os parâmetros ou a implementação do modelo.
patch	int32 Versões de patch: mudanças na implementação destinadas a corrigir 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 sem mudanças regulares nos algoritmos.

Scope3FlightEmissions

Voo do escopo 3 com estimativas de emissão.

Campos
flight	Scope3FlightSegment Obrigatório. Corresponde aos identificadores de voo na solicitação.
wtw_emissions_grams_per_pax	int64 Opcional. Total de emissões de voo (soma de poço a tanque e tanque a despertar) por passageiro com base nas informações solicitadas. Esse é o total de emissões. A menos que você tenha motivos específicos para usar as emissões TTW ou WTT, use esse número.
ttw_emissions_grams_per_pax	int64 Opcional. Emissões de voo do tanque à esteira por passageiro com base nas informações solicitadas.
wtt_emissions_grams_per_pax	int64 Opcional. Emissões de voo do poço ao tanque por passageiro com base nas informações solicitadas.
source	Scope3DataType Opcional. A origem dos dados de emissões.

Scope3DataType

O tipo de correspondência usado para calcular as emissões do Escopo 3. Usado para a resposta do Escopo 3, marcando qual dos métodos foi usado para calcular as emissões.

Tipos enumerados
SCOPE3_DATA_TYPE_UNSPECIFIED	Tipo de dados não especificado.
TIM_EMISSIONS	Emissões com base no TIM, considerando origem, destino, operadora, número do voo, data de partida e ano.
TYPICAL_FLIGHT_EMISSIONS	Emissões típicas de voos de acordo com origem, destino e ano.
DISTANCE_BASED_EMISSIONS	Emissões com base na distância percorrida e no ano.

Scope3FlightSegment

Parâmetros de voo com que as emissões de escopo 3 são buscadas.

Campos
departure_date	Date Obrigatório. Data do voo no fuso horário do aeroporto de origem. Apenas o ano é necessário para modelos típicos de emissões de voos e baseados em distância. Os valores de mês e dia são ignorados e, portanto, podem ser omitidos, definidos como 0 ou definidos como uma data válida para esses casos. Da mesma forma, se uma data específica não for fornecida para as emissões de TIM, vamos usar as emissões típicas de voo (ou com base na distância).
cabin_class	CabinClass Obrigatório. A classe da cabine do voo.
origin	string Opcional. Código IATA do aeroporto de origem do voo, por exemplo, YVR. Usado para corresponder a um voo específico, se fornecido com destino, companhia aérea e número do voo. Se não houver uma correspondência, vamos tentar associar o voo a um voo típico entre os aeroportos de origem e destino fornecidos. Caso contrário, vamos usar o modelo de emissões com base na distância se a distância do voo for fornecida.
destination	string Opcional. Código IATA do aeroporto de destino do voo, por exemplo, ICN. Usado para corresponder a um voo específico, se fornecido com origem, companhia aérea e número do voo. Se não houver uma correspondência, vamos tentar associar o voo a um voo típico entre os aeroportos de origem e destino fornecidos. Caso contrário, vamos usar o modelo de emissões com base na distância se a distância do voo for fornecida.
carrier_code	string Opcional. Código da companhia aérea da IATA, por exemplo, KE. Isso é necessário se você quiser uma correspondência de voos específica. Caso contrário, esse campo não será usado para modelos típicos de emissões com base em voos e distância. Pode ser o código da transportadora operadora e de marketing (ou seja, o codeshare está coberto).
flight_number	int32 Opcional. Número do voo, por exemplo, 71. Primeiro, ele é usado para corresponder a um voo específico se um número de voo for especificado junto com a origem, o destino e a companhia aérea. Se um número de voo não for especificado, primeiro vamos tentar corresponder o voo a um voo típico entre os aeroportos de origem e destino fornecidos. Se isso falhar e/ou a origem e o destino não forem fornecidos, vamos usar o modelo de emissões com base na distância do voo.
distance_km	int64 Opcional. Distância em quilômetros, por exemplo, 2423. Usado para corresponder um voo a emissões com base na distância quando a origem e o destino não são fornecidos ou não há voos típicos correspondentes. Esse campo aceita valores entre 0 e 2,5e16 km.

CabinClass

A classe da cabine do voo.

Tipos enumerados
CABIN_CLASS_UNSPECIFIED	Classe não especificada.
ECONOMY	Classe econômica.
PREMIUM_ECONOMY	Classe econômica premium.
BUSINESS	Classe executiva.
FIRST	Primeira classe.

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.

TypicalFlightEmissions

Estimativas típicas de emissões de voos para um determinado mercado

Campos
market	Market Obrigatório. Corresponde aos identificadores de voo na solicitação. Observação: todos os códigos da IATA são maiúsculos.
emissions_grams_per_pax	EmissionsGramsPerPax Opcional. Emissões típicas de voos por passageiro para o mercado solicitado. Não estará presente se não for possível calcular uma emissão típica. Para conferir a lista de motivos por que as emissões típicas de voos não puderam ser calculadas, consulte o GitHub.