Method: flights.computeScope3FlightEmissions

Récupère les estimations des émissions de GES pour un ensemble de segments de vol pour les rapports scope 3.

La réponse contient toutes les entrées qui correspondent aux segments de vol Scope3FlightSegment saisis, dans le même ordre. Les estimations sont calculées à l'aide de la logique en cascade suivante (en utilisant la première disponible) :

  1. Émissions basées sur le modèle TIM, en fonction de origin, destination, carrier, flightNumber, departureDate et cabinClass.
  2. Émissions habituelles du vol, en fonction de origin, destination, de l'année dans departureDate et de 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 futur est demandé au cours de cette année civile, nous ne prenons pas en charge les émissions de niveau 1 et nous revenons aux émissions de niveau 2 ou 3. Si le vol futur demandé n'a pas lieu au cours de cette année civile, nous renvoyons une réponse vide. Nous vous recommandons d'utiliser l'API computeFlightEmissions pour les vols futurs.

Si aucune estimation n'est disponible pour un vol donné avec l'une des trois méthodes, la réponse renvoie un objet Scope3FlightEmissions avec des champs d'émission vides. La requête est 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 du vol ne sont pas disponibles pour la paire demandée).

La requête échoue avec une erreur INVALID_ARGUMENT si :

  • La requête contient plus de 1 000 segments de vol.
  • Il manque un ou plusieurs identifiants dans le segment de vol saisi. Par exemple, il manque l'origine/la destination sans distance valide pour une correspondance de type TIM_EMISSIONS ou TYPICAL_FLIGHT_EMISSIONS, ou il manque la distance 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ées sur la distance, vous devez spécifier une distance).
  • La date du vol est antérieure à 2019 (les données de scope 3 ne sont disponibles qu'à partir de 2019).
  • La distance du vol est inférieure ou égale à 0.
  • La classe de réservation est manquante.

Étant donné que la requête est traitée avec une logique de secours, il est possible que les requêtes mal configurées renvoient des estimations d'émissions valides à l'aide de méthodes de secours. Par exemple, si une requête comporte un numéro de vol incorrect, mais spécifie l'origine et la destination, elle aboutit, mais les émissions renvoyées sont basées uniquement sur les émissions habituelles du vol. De même, si une requête ne comporte pas d'origine pour une requête d'émissions habituelles du vol, mais spécifie une distance valide, elle peut aboutir en fonction uniquement des émissions basées sur la distance. Par conséquent, vous devez vérifier la source des émissions renvoyées (source) pour vous assurer que les résultats sont conformes à vos 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 des 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 d'é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 des 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 scope 3 sont récupérées.

Représentation JSON 
{
  "departureDate": {
    object (Date)
  },
  "cabinClass": enum (Scope3FlightSegment.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 habituelles du vol et basées sur la distance (les valeurs du mois et du jour sont ignorées et peuvent donc être omises, définies sur 0 ou sur une date valide dans ces cas). Par conséquent, si aucune date spécifique n'est fournie pour les émissions TIM, nous revenons aux émissions habituelles du vol (ou basées sur la distance).
cabinClass

enum (Scope3FlightSegment.CabinClass)

Obligatoire. Classe de réservation du vol.
origin

string

Facultatif. Code IATA à trois caractères de l'aéroport de départ du vol, par exemple YVR. Il permet de faire correspondre 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 essayons d'abord de faire correspondre le vol à un vol habituel entre les aéroports de départ et de destination fournis. Sinon, nous utilisons le modèle d'émissions basées sur la distance si la distance du vol est fournie.
destination

string

Facultatif. Code IATA à trois caractères de l'aéroport de destination du vol, par exemple ICN. Il 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 essayons d'abord de faire correspondre le vol à un vol habituel entre les aéroports de départ et de destination fournis. Sinon, nous utilisons le modèle d'émissions basées sur la distance si la distance du vol est fournie.
carrierCode

string

Facultatif. Code IATA à deux caractères de la compagnie aérienne , par exemple KE. Il est obligatoire si vous souhaitez faire correspondre un vol spécifique. Sinon, il n'est pas utilisé pour les modèles d'émissions habituelles du vol et basées sur la distance. Il peut s'agir du code de la compagnie aérienne exploitante et de la compagnie aérienne commerciale (c'est-à-dire que le partage de code est couvert).
flightNumber

integer

Facultatif. Numéro de vol comportant jusqu'à quatre chiffres, par exemple 71, compris entre 1 et 9999. Il est d'abord utilisé pour faire correspondre un vol spécifique si un numéro de vol est spécifié avec l'origine, la destination et la compagnie aérienne. Si aucun numéro de vol n'est spécifié, nous essayons d'abord de faire correspondre le vol à un vol habituel entre les aéroports de départ et de destination fournis. Si cela échoue et/ou si l'origine et la destination ne sont pas fournies, nous utilisons le modèle d'émissions basées sur la distance en fonction de la distance du vol fournie.
distanceKm

string (int64 format)

Facultatif. Distance en kilomètres, par exemple 2423, comprise entre 1 et 2, 5e16 km. Elle permet de faire correspondre un vol aux émissions basées sur la distance lorsque l'origine et la destination ne sont pas fournies ou qu'aucun vol habituel ne correspond.

Scope3FlightSegment.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 scope 3 avec estimations d'émissions.

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

object (Scope3FlightSegment)

Identifiant. Correspond aux identifiants de vol de 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 du vol du réservoir au sillage par passager en fonction des informations demandées.
wttEmissionsGramsPerPax

string (int64 format)

Facultatif. Émissions du vol du puits au réservoir par passager en fonction des informations demandées.
source

enum (Scope3FlightEmissions.Scope3DataType)

Facultatif. Source des données d'émissions.

Scope3FlightEmissions.Scope3DataType

Type de correspondance utilisé pour calculer les émissions de scope 3. Il est utilisé pour la réponse Scope 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 modèle TIM, en fonction de l'origine, de la destination, de la compagnie aérienne, du numéro de vol, de la date de départ et de l'année.
TYPICAL_FLIGHT_EMISSIONS Émissions habituelles du vol, en fonction de l'origine, de la destination et de l'année.
DISTANCE_BASED_EMISSIONS Émissions basées sur la distance, en fonction de la distance parcourue et de l'année.