Package google.travel.sustainability.travelimpactmodel.v1

Index

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

TravelImpactModelService

API permettant de fournir des estimations des émissions de carbone.

ComputeFlightEmissions

rpc ComputeFlightEmissions(ComputeFlightEmissionsRequest) returns (ComputeFlightEmissionsResponse) Méthode sans état permettant de récupérer les estimations d'émissions. Pour en savoir plus sur le calcul des estimations d'émissions, consultez GitHub. La réponse contient toutes les entrées correspondant aux étapes de vol saisies, dans le même ordre. Si aucune estimation n'est disponible pour une étape de vol donnée, la réponse renvoie l'objet de l'étape de vol avec des champs d'émissions vides. La demande sera toujours considérée comme ayant abouti. Voici quelques raisons pour lesquelles les estimations d'émissions peuvent être manquantes : Le serveur ne connaît pas le vol. Il manque un ou plusieurs identifiants à la section de vol saisie. La date du vol est antérieure à la date actuelle. Le type d'aéronef n'est pas pris en charge par le modèle. La configuration des licences utilisateur est manquante. La requête peut contenir jusqu'à 1 000 tronçons de vol. Si la requête comporte plus de 1 000 vols directs, elle échouera et une erreur INVALID_ARGUMENT sera renvoyée.

ComputeScope3FlightEmissions

rpc ComputeScope3FlightEmissions(ComputeScope3FlightEmissionsRequest) returns (ComputeScope3FlightEmissionsResponse) Méthode sans état permettant de récupérer les estimations des émissions de GES pour un ensemble de segments de vol à des fins de reporting sur le champ d'application 3. La réponse contient toutes les entrées qui correspondent aux segments de vol Scope3FlightSegment saisis, dans le même ordre. Les estimations seront calculées à l'aide de la logique en cascade suivante (en utilisant la première disponible) : Émissions basées sur TIM pour origin, destination, carrier, flightNumber, departureDate et cabinClass. Émissions de vol habituelles pour origin, destination, l'année departureDate et cabinClass. Émissions basées sur la distance calculées à l'aide de distanceKm, de l'année dans departureDate et de cabinClass. Si un vol est prévu au cours de l'année civile, nous ne prenons pas en charge les émissions de niveau 1 et nous passerons aux émissions de niveau 2 ou 3. Si le vol futur demandé n'a pas lieu au cours de l'année civile en cours, nous renverrons une réponse vide. Nous vous recommandons d'utiliser l'API computeFlightEmissions pour les futurs vols. Si aucune estimation n'est disponible pour un vol donné avec l'une des trois méthodes, la réponse renverra un objet Scope3FlightEmissions avec des champs d'émissions vides. La demande sera toujours considérée comme ayant abouti. En général, les estimations d'émissions manquantes se produisent lorsque le vol est inconnu du serveur (par exemple, aucun vol spécifique n'existe ou les émissions habituelles des vols ne sont pas disponibles pour la paire demandée). La requête échouera avec une erreur INVALID_ARGUMENT si : La demande contient plus de 1 000 segments de vol. Il manque un ou plusieurs identifiants à la section de vol saisie. Par exemple, une origine ou une destination manquantes sans distance valide pour une correspondance de type TIM_EMISSIONS ou TYPICAL_FLIGHT_EMISSIONS, ou une distance manquante pour une correspondance de type DISTANCE_BASED_EMISSIONS (si vous souhaitez revenir aux émissions basées sur la distance ou obtenir une estimation des émissions basée sur la distance, vous devez spécifier une distance). La date du vol est antérieure à 2019 (les données de champ d'application 3 ne sont disponibles qu'à partir de 2019). La distance de vol est égale ou inférieure à 0. Classe de réservation manquante. Étant donné que la requête est traitée avec une logique de remplacement, il est possible que les requêtes mal configurées renvoient des estimations d'émissions valides à l'aide de méthodes de remplacement. Par exemple, si une requête indique un mauvais numéro de vol, mais spécifie l'origine et la destination, elle aboutira quand même. Toutefois, les émissions renvoyées seront basées uniquement sur les émissions de vol typiques. De même, si une requête ne contient pas d'origine pour une requête d'émissions de vol typique, mais spécifie une distance valide, elle peut aboutir en fonction uniquement des émissions basées sur la distance. Par conséquent, il convient de vérifier la source des émissions renvoyées (source) pour s'assurer que les résultats sont conformes aux attentes.

ComputeTypicalFlightEmissions

rpc ComputeTypicalFlightEmissions(ComputeTypicalFlightEmissionsRequest) returns (ComputeTypicalFlightEmissionsResponse) Récupère les estimations des émissions de vol habituelles entre deux aéroports, également appelés "marché". Si aucune estimation n'est disponible pour un marché donné, la réponse renvoie l'objet de marché avec des champs d'émissions vides. La demande sera toujours considérée comme ayant abouti. Pour en savoir plus sur le calcul des estimations d'émissions habituelles, consultez GitHub. La requête peut contenir jusqu'à 1 000 marchés. Si la requête comporte plus de 1 000 marchés, elle échouera et une erreur INVALID_ARGUMENT sera renvoyée.

ComputeFlightEmissionsRequest

Définition des entrées pour la requête ComputeFlightEmissions.

Champs
flights[]	Flight Obligatoire. Vols directs pour lesquels renvoyer les estimations d'émissions.

ComputeFlightEmissionsResponse

Définition de la sortie pour la réponse ComputeFlightEmissions.

Champs
flight_emissions[]	FlightWithEmissions Liste des étapes de vol avec les estimations d'émissions.
model_version	ModelVersion Version du modèle sous laquelle les estimations d'émissions pour tous les vols de cette réponse ont été calculées.

ComputeScope3FlightEmissionsRequest

Liste des segments de vol pour lesquels demander les émissions de scope 3.

Champs
flights[]	Scope3FlightSegment Obligatoire. Vols pour lesquels renvoyer les estimations d'émissions.
model_version	ModelVersion Facultatif. Version du modèle sous laquelle les estimations d'émissions pour tous les vols de cette requête ont été calculées.

ComputeScope3FlightEmissionsResponse

Liste des vols avec des estimations des émissions de scope 3.

Champs
flight_emissions[]	Scope3FlightEmissions Liste des segments de vol avec les estimations d'émissions.
model_version	ModelVersion Version du modèle sous laquelle les estimations d'émissions pour tous les vols de cette réponse ont été calculées.

ComputeTypicalFlightEmissionsRequest

Liste de paires d'aéroports (marchés) pour lesquels demander les émissions habituelles.

Champs
markets[]	Market Obligatoire. Demandez les estimations des émissions de vols habituelles pour cette paire de marchés. Vous pouvez demander jusqu'à 1 000 marchés.

ComputeTypicalFlightEmissionsResponse

La réponse inclut les émissions, mais aussi la version du modèle.

Champs
typical_flight_emissions[]	TypicalFlightEmissions Émissions habituelles des vols pour le marché demandées.
model_version	ModelVersion Version du modèle sous lequel les estimations des émissions habituelles des vols pour tous les vols de cette réponse ont été calculées.

ContrailsImpactBucket

Importance de l'impact des traînées de condensation sur le réchauffement climatique par rapport à l'impact total des émissions de CO₂e.

Enums
CONTRAILS_IMPACT_UNSPECIFIED	L'impact des traînées de condensation n'est pas spécifié.
CONTRAILS_IMPACT_NEGLIGIBLE	L'impact des traînées de condensation est négligeable par rapport aux émissions totales de CO₂e.
CONTRAILS_IMPACT_MODERATE	L'impact des traînées de condensation est comparable aux émissions totales de CO₂e.
CONTRAILS_IMPACT_SEVERE	L'impact des traînées de condensation est supérieur à l'impact total des émissions de CO₂e.

EasaLabelMetadata

Métadonnées sur le système d'étiquetage des émissions des vols (FEL) de l'AESA.

Champs
label_issue_date	Date Date d'émission du libellé.
label_expiry_date	Date Date d'expiration du libellé. Le libellé peut être affiché jusqu'à cette date.
label_version	string Version du libellé.
saf_discount_percentage	double Pourcentage de remise sur les émissions de carburant d'aviation durable (SAF) appliqué au libellé. Il s'agit d'un pourcentage sous forme décimale. Les valeurs sont comprises dans l'intervalle [0,1]. Par exemple, 0,0021 signifie 0,21 %. Cette remise et cette réduction des émissions sont indiquées par le label EASA, mais ne sont pas incluses dans les estimations de CO2e distribuées par cette API.

EmissionsGramsPerPax

Résultats des émissions groupées par classe.

Champs
first	int32 Émissions pour un passager en première classe, en grammes. Ce champ est toujours calculé et renseigné, que l'avion dispose ou non de sièges en première classe.
business	int32 Émissions pour un passager en classe affaires, en grammes. Ce champ est toujours calculé et renseigné, que l'avion dispose ou non de sièges en classe affaires.
premium_economy	int32 Émissions pour un passager en classe économique premium, en grammes. Ce champ est toujours calculé et renseigné, que l'avion dispose ou non de sièges en classe économique premium.
economy	int32 Émissions pour un passager en classe économique, en grammes. Ce champ est toujours calculé et renseigné, que l'avion dispose ou non de sièges en classe économique.

Vol

Tous les détails liés à un seul élément de requête pour les estimations d'émissions d'un vol direct.

Champs
origin	string Obligatoire. Code IATA de l'aéroport de départ du vol (par exemple, "LHR").
destination	string Obligatoire. Code IATA de l'aéroport de destination du vol (par exemple, "JFK")
operating_carrier_code	string Obligatoire. Code IATA de la compagnie aérienne, par exemple "AA".
flight_number	int32 Obligatoire. Numéro de vol, par exemple 324.
departure_date	Date Obligatoire. Date du vol dans le fuseau horaire de l'aéroport de départ. Il doit s'agir d'une date dans le présent ou le futur.

FlightWithEmissions

Vol direct avec estimations des émissions.

Champs
flight	Flight Obligatoire. Correspond aux identifiants de vol dans la requête. Remarque : Tous les codes IATA sont en majuscules.
source	Source Facultatif. Source des données sur les émissions.
emissions_grams_per_pax	EmissionsGramsPerPax Facultatif. Nombre estimé d'émissions par passager. Ce champ n'est pas présent si les émissions n'ont pas pu être calculées. Pour obtenir la liste des raisons pour lesquelles les émissions n'ont pas pu être calculées, consultez ComputeFlightEmissions.
easa_label_metadata	EasaLabelMetadata Facultatif. Métadonnées sur le système d'étiquetage des émissions des vols (FEL) de l'AESA. Défini uniquement lorsque la source de données sur les émissions est l'EASA.
contrails_impact_bucket	ContrailsImpactBucket Facultatif. Importance de l'impact des traînées de condensation sur le réchauffement climatique par rapport à l'impact total des émissions de CO₂e.

Marché

Une paire d'aéroports.

Champs
origin	string Obligatoire. Code IATA de l'aéroport de départ du vol (par exemple, "LHR").
destination	string Obligatoire. Code IATA de l'aéroport de destination du vol (par exemple, "JFK")

ModelVersion

Version du modèle d'impact des voyages. Pour en savoir plus sur la gestion des versions de modèle, consultez GitHub.

Champs
major	int32 Versions majeures : modifications majeures de la méthodologie (par exemple, ajout de nouvelles sources de données au modèle entraînant des modifications majeures des résultats). De tels changements seront rares et annoncés bien à l'avance. Cela peut impliquer des modifications de la version de l'API, qui respecteront les Consignes relatives aux API Google Cloud.
minor	int32 Versions mineures : modifications apportées au modèle qui, tout en étant cohérentes entre les versions du schéma, modifient les paramètres ou l'implémentation du modèle.
patch	int32 Versions correctives : modifications de l'implémentation destinées à corriger les bugs ou les inexactitudes dans l'implémentation du modèle.
dated	string Versions datées : les ensembles de données du modèle sont recréés régulièrement avec des données d'entrée actualisées, mais sans modification des algorithmes.

Scope3FlightEmissions

Vol de catégorie 3 avec estimations des émissions.

Champs
flight	Scope3FlightSegment Obligatoire. Correspond aux identifiants de vol dans la requête.
wtw_emissions_grams_per_pax	int64 Facultatif. Émissions totales du vol (somme des émissions du puits au réservoir et du réservoir au sillage) par passager, en fonction des informations demandées. Il s'agit des émissions totales. Sauf si vous avez des raisons spécifiques d'utiliser les émissions du réservoir au sillage ou du puits au réservoir, vous devez utiliser ce nombre.
ttw_emissions_grams_per_pax	int64 Facultatif. Émissions de vol "du réservoir à l'éveil" par passager, en fonction des informations demandées.
wtt_emissions_grams_per_pax	int64 Facultatif. Émissions de gaz à effet de serre par passager, du puits au réservoir, en fonction des informations demandées.
source	Scope3DataType Facultatif. Source des données sur les émissions.

Scope3DataType

Type de correspondance utilisé pour calculer les émissions du champ d'application 3. Ce champ est utilisé pour la réponse du champ d'application 3, en indiquant la méthode utilisée pour calculer les émissions.

Enums
SCOPE3_DATA_TYPE_UNSPECIFIED	Type de données non spécifié.
TIM_EMISSIONS	Émissions basées sur le TIM, en fonction de l'origine, de la destination, du transporteur, du numéro de vol, de la date de départ et de l'année.
TYPICAL_FLIGHT_EMISSIONS	Émissions de vol habituelles en fonction de l'origine, de la destination et de l'année.
DISTANCE_BASED_EMISSIONS	Émissions basées sur la distance parcourue et l'année.

Scope3FlightSegment

Paramètres de vol avec lesquels les émissions de catégorie 3 sont récupérées.

Champs
departure_date	Date Obligatoire. Date du vol dans le fuseau horaire de l'aéroport de départ. Seule l'année est requise pour les modèles d'émissions typiques basés sur les vols et la distance (les valeurs du mois et du jour sont ignorées et peuvent donc être omises, définies sur 0 ou définies sur une date valide pour ces cas). De même, si aucune date spécifique n'est fournie pour les émissions TIM, nous utiliserons les émissions typiques des vols (ou basées sur la distance).
cabin_class	CabinClass Obligatoire. Classe de réservation du vol.
origin	string Facultatif. Code IATA de l'aéroport de départ du vol (par exemple, YVR). Ce paramètre permet de trouver un vol spécifique s'il est fourni avec la destination, la compagnie aérienne et le numéro de vol. En l'absence de correspondance, nous essaierons d'abord de faire correspondre le vol à un vol type entre les aéroports de départ et de destination fournis. Sinon, nous utiliserons le modèle d'émissions basé sur la distance si la distance de vol est fournie.
destination	string Facultatif. Code IATA de l'aéroport de destination du vol, par exemple ICN. Ce champ permet de faire correspondre un vol spécifique s'il est fourni avec l'origine, la compagnie aérienne et le numéro de vol. En l'absence de correspondance, nous essaierons d'abord de faire correspondre le vol à un vol type entre les aéroports de départ et de destination fournis. Sinon, nous utiliserons le modèle d'émissions basé sur la distance si la distance de vol est fournie.
carrier_code	string Facultatif. Code IATA de la compagnie aérienne (par exemple, KE). Cette option est obligatoire si vous souhaitez que les vols soient associés à des vols spécifiques. Sinon, il n'est pas utilisé pour les modèles d'émissions classiques basés sur les vols et les distances. Il peut s'agir du code du transporteur aérien opérationnel et du code du transporteur aérien commercial (c'est-à-dire que le partage de code est couvert).
flight_number	int32 Facultatif. Numéro de vol (par exemple, 71). Elle est d'abord utilisée pour trouver un vol spécifique si un numéro de vol est indiqué avec l'origine, la destination et le transporteur. Si aucun numéro de vol n'est spécifié, nous essaierons d'abord de faire correspondre le vol à un vol typique entre les aéroports d'origine et de destination fournis. Si cela échoue et/ou si l'origine et la destination ne sont pas fournies, nous utiliserons le modèle d'émissions basé sur la distance en fonction de la distance de vol fournie.
distance_km	int64 Facultatif. Distance en kilomètres, par exemple 2423. Il est utilisé pour faire correspondre un vol aux émissions basées sur la distance lorsque l'origine et la destination ne sont pas fournies ou qu'il n'y a pas de vols habituels correspondants. Ce champ accepte des valeurs comprises entre 0 et 2,5e16 km.

CabinClass

Classe de réservation du vol.

Enums
CABIN_CLASS_UNSPECIFIED	Classe de réservation non spécifiée.
ECONOMY	Classe économique
PREMIUM_ECONOMY	Classe économique premium.
BUSINESS	Classe affaires
FIRST	Première classe.

Source

Source des données sur les émissions.

Enums
SOURCE_UNSPECIFIED	La source des données sur les émissions n'est pas spécifiée.
TIM	Les données sur les émissions proviennent du modèle de calcul de l'impact des voyages.
EASA	Les données sur les émissions proviennent des écolabels de l'EASA.

TypicalFlightEmissions

Estimations des émissions habituelles des vols pour un marché donné

Champs
market	Market Obligatoire. Correspond aux identifiants de vol dans la requête. Remarque : Tous les codes IATA sont en majuscules.
emissions_grams_per_pax	EmissionsGramsPerPax Facultatif. Émissions de vol habituelles par passager pour le marché demandé. Ce champ n'est pas présent si les émissions habituelles n'ont pas pu être calculées. Pour obtenir la liste des raisons pour lesquelles les émissions de vol habituelles n'ont pas pu être calculées, consultez GitHub.