Method: flights.computeScope3FlightEmissions

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

La réponse contiendra toutes les entrées correspondant aux segments de vol Scope3FlightSegment d'entrée, dans le même ordre que celui fourni. Les estimations seront 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 pour origin, destination, carrier, flightNumber, departureDate et cabinClass.
  2. Émissions de vol types pour origin, destination, l'année departureDate et cabinClass.
  3. Émissions basées sur la distance calculées à l'aide de distanceKm, année en departureDate et cabinClass.

Si un vol futur est demandé au cours de l'année civile en cours, nous ne prenons pas en charge les émissions de niveau 1 et nous nous rabattons sur les émissions de niveau 2 ou 3. Si le vol futur demandé n'est pas prévu pour l'année civile en cours, nous renverrons une réponse vide. Nous vous recommandons d'utiliser l'API computeFlightEmissions pour les prochains vols.

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 sera toujours considérée comme réussie. En général, les estimations d'émissions sont manquantes lorsque le vol est inconnu du serveur (par exemple, s'il n'existe pas de vol spécifique ou si 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 requête contient plus de 1 000 segments de vol.
  • Il manque un ou plusieurs identifiants dans le segment de vol d'entrée. Par exemple, l'origine/la destination sont manquantes 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 utiliser les émissions basées sur la distance ou si vous souhaitez 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.
  • Classe de réservation manquante.

Comme la requête est traitée avec une logique de remplacement, il est possible que des requêtes mal configurées renvoient des estimations d'émissions valides à l'aide de méthodes de remplacement. Par exemple, si une requête comporte un numéro de vol incorrect, mais spécifie l'origine et la destination, elle aboutira quand même, mais les émissions renvoyées seront basées uniquement sur les émissions de vol types. De même, si une requête ne contient pas l'origine d'une requête d'émissions de vol standard, mais spécifie une distance valide, elle peut aboutir en se basant uniquement sur les émissions basées sur la distance. Par conséquent, vous devez vérifier la source des émissions renvoyées (source) pour confirmer 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 des estimations d'émissions.
modelVersion

object (ModelVersion)

Facultatif. Version du modèle utilisée pour calculer les estimations d'émissions pour tous les vols de cette requête.

Corps de la réponse

Liste de 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 utilisée pour calculer les estimations d'émissions de tous les vols de cette réponse.

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 types basés sur les vols et la distance (les valeurs de mois et de jour sont ignorées et peuvent donc être omises, définies sur 0 ou définies sur une date valide dans ces cas). De même, si aucune date spécifique n'est fournie pour les émissions TIM, nous utiliserons par défaut les émissions d'un vol standard (ou basées sur la distance).
cabinClass

enum (Scope3FlightSegment.CabinClass)

Obligatoire. Classe de réservation du vol.
origin

string

Facultatif. Code d'aéroport IATA à trois caractères pour l'aéroport de départ du vol, par exemple YVR. Utilisé pour faire correspondre un vol spécifique s'il est fourni avec la destination, le transporteur et le numéro de vol. Si aucune correspondance n'est trouvée, nous essaierons d'abord de faire correspondre le vol à un vol standard 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 du vol est fournie.
destination

string

Facultatif. Code d'aéroport IATA à trois caractères pour la destination du vol, par exemple ICN. Cette valeur permet de faire correspondre un vol spécifique si elle est fournie avec l'origine, le transporteur et le numéro de vol. Si aucune correspondance n'est trouvée, nous essaierons d'abord de faire correspondre le vol à un vol standard 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 du vol est fournie.
carrierCode

string

Facultatif. Code de transporteur IATA à deux caractères, par exemple KE. Cette étape est obligatoire si vous souhaitez faire correspondre des vols spécifiques. Sinon, il n'est pas utilisé pour les modèles d'émissions standards basés sur les vols et la distance. Il peut s'agir du code du transporteur exploitant et du transporteur commercial (le partage de code est donc couvert).
flightNumber

integer

Facultatif. Numéro de vol de quatre chiffres maximum, 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 essaierons d'abord de faire correspondre le vol à un vol standard entre les aéroports de départ et d'arrivée 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 du vol fournie.
distanceKm

string (int64 format)

Facultatif. Distance en kilomètres, par exemple 2423, de [1, 1e12) km. Permet de faire correspondre un vol à des é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 types correspondants.

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

Représentation JSON 
{
  "flight": {
    object (Scope3FlightSegment)
  },
  "wtwEmissionsGramsPerPax": string,
  "ttwEmissionsGramsPerPax": string,
  "wttEmissionsGramsPerPax": string,
  "source": enum (Scope3FlightEmissions.Scope3DataType),
  "modelVersion": string
}
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 TTW ou WTT, 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 de vol du puits au réservoir par passager en fonction des informations demandées.
source

enum (Scope3FlightEmissions.Scope3DataType)

Facultatif. Source des données sur les émissions.
modelVersion

string

Facultatif. Version du modèle sous laquelle les émissions ont été calculées.

Scope3FlightEmissions.Scope3DataType

Type de correspondance utilisé pour calculer les émissions de scope 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 habituelles des vols 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.