Method: flights.computeScope3FlightEmissions

Méthode sans état permettant de récupérer les estimations des émissions de gaz à effet de serre pour un ensemble de segments de vol pour les rapports de niveau 3.

La réponse contient toutes les entrées correspondant 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 de vol habituelles, 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 réussi. 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 de vol habituelles 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.
  • Un ou plusieurs identifiants sont manquants dans le segment de vol saisi. Par exemple, l'origine/la destination est manquante sans distance valide pour une correspondance de type TIM_EMISSIONS ou TYPICAL_FLIGHT_EMISSIONS, ou la distance est 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ées sur la distance, vous devez spécifier une distance).
  • La date du vol est antérieure à 2019 (les données de niveau 3 ne sont disponibles qu'à partir de 2019).
  • La distance du vol est inférieure ou égale à 0.
  • La classe de cabine est manquante.

Étant donné que la requête est traitée avec une logique de secours, il est possible que des 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 de vol habituelles. De même, si une requête ne comporte pas d'origine pour une requête d'émissions de vol habituelles, 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 niveau 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 niveau 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 de vol habituels et basés 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 de vol habituelles (ou basées sur la distance).
cabinClass

enum (CabinClass)

Obligatoire. Classe de cabine du vol.
origin

string

Facultatif. Code IATA à trois caractères de l'aéroport de départ, par exemple YVR. Il permet de faire correspondre un vol spécifique s'il est fourni avec la destination, le transporteur 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é sur la distance si la distance du vol est fournie.
destination

string

Facultatif. Code IATA à trois caractères de l'aéroport de destination, par exemple ICN. Il permet de faire correspondre un vol spécifique s'il est fourni avec l'origine, le transporteur 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é sur la distance si la distance du vol est fournie.
carrierCode

string

Facultatif. Code IATA à deux caractères du transporteur, 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 de vol habituels et basés sur la distance. Il peut s'agir du code du transporteur exploitant et du transporteur commercialisant (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 le transporteur. 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é 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.

CabinClass

Classe de cabine du vol.

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

Scope3FlightEmissions

Vol de niveau 3 avec des estimations d'émissions.

Représentation JSON 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (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 (Scope3DataType)

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

Scope3DataType

Type de correspondance utilisé pour calculer les émissions de niveau 3. Il est utilisé pour la réponse de niveau 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, 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, en fonction de la distance parcourue et de l'année.