Method: flights.computeScope3FlightEmissions

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) :

  1. Émissions basées sur TIM pour origin, destination, carrier, flightNumber, departureDate et cabinClass.
  2. Émissions de vol habituelles pour origin, destination, l'année departureDate et cabinClass.
  3. É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.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "flights": [
    {
      object (Scope3FlightSegment)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Champs
flights[]

object (Scope3FlightSegment)

Obligatoire. Vols pour lesquels renvoyer les estimations d'émissions.
modelVersion

object (ModelVersion)

Facultatif. Version du modèle sous laquelle les estimations d'émissions pour tous les vols de cette requête ont été calculées.

Corps de la réponse

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

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "flightEmissions": [
    {
      object (Scope3FlightEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Champs
flightEmissions[]

object (Scope3FlightEmissions)

Liste des segments de vol avec les estimations d'émissions.
modelVersion

object (ModelVersion)

Version du modèle sous laquelle les estimations d'émissions pour tous les vols de cette réponse ont été calculées.

Scope3FlightSegment

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

Représentation JSON 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (CabinClass),
  "origin": string,
  "destination": string,
  "carrierCode": string,
  "flightNumber": integer,
  "distanceKm": string
}
Champs
departureDate

object (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).
cabinClass

enum (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.
carrierCode

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).
flightNumber

integer

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

string (int64 format)

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.

Scope3FlightEmissions

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

Représentation JSON 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3DataType)
}
Champs
flight

object (Scope3FlightSegment)

Obligatoire. Correspond aux identifiants de vol dans la requête.
wtwEmissionsGramsPerPax

string (int64 format)

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

string (int64 format)

Facultatif. Émissions de vol "du réservoir à l'éveil" par passager, en fonction des informations demandées.
wttEmissionsGramsPerPax

string (int64 format)

Facultatif. Émissions de gaz à effet de serre par passager, du puits au réservoir, en fonction des informations demandées.
source

enum (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.