Method: flights.computeDetailedFlightEmissions

Récupère des estimations d'émissions détaillées.

Les émissions de vol détaillées sont des estimations transparentes des émissions de gaz à effet de serre par passager, complétées par des métadonnées complètes détaillant la méthodologie de calcul, la répartition des émissions, l'impact des traînées de condensation et la provenance des données.

Pour en savoir plus sur le calcul des estimations d'émissions, consultez GitHub.

La réponse contient toutes les entrées correspondant aux tronçons de vol saisis, 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'à 100 segments de vol. Si la requête comporte plus de 100 segments de vol, elle échouera et une erreur INVALID_ARGUMENT sera renvoyée.

Requête HTTP

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

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 (Flight)
    }
  ]
}
Champs
flights[]

object (Flight)

Obligatoire. Vols directs pour lesquels renvoyer les estimations des émissions.

Corps de la réponse

Définition de la sortie pour la réponse flights.computeDetailedFlightEmissions.

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

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

object (FlightWithDetailedEmissions)

Liste des étapes de vol avec les estimations des é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.

FlightWithDetailedEmissions

Vol direct avec des informations sur les estimations d'émissions.

Représentation JSON 
{
  "flight": {
    object (Flight)
  },
  "flightEmissionsDetails": {
    object (FlightEmissionsDetails)
  },
  "emissionsMetadata": {
    object (EmissionsMetadata)
  }
}
Champs
flight

object (Flight)

Uniquement en sortie. Correspond aux identifiants de vol dans la requête. Remarque : Tous les codes IATA sont en majuscules.
flightEmissionsDetails

object (FlightEmissionsDetails)

Uniquement en sortie. Toutes les données sur les émissions des vols.
emissionsMetadata

object (EmissionsMetadata)

Uniquement en sortie. Métadonnées supplémentaires sur le calcul des émissions des vols.

FlightEmissionsDetails

Détails sur les émissions du vol spécifique.

Représentation JSON 
{
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "emissionsBreakdown": {
    object (EmissionsBreakdown)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket),
  "source": enum (Source)
}
Champs
emissionsGramsPerPax

object (EmissionsGramsPerPax)

Uniquement en sortie. Nombre d'estimations d'émissions par passager. Ce champ est absent 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 flights.computeDetailedFlightEmissions.
emissionsBreakdown

object (EmissionsBreakdown)

Uniquement en sortie. Détails sur les différentes parties des émissions de la valeur totale "emissionsGramsPerPax". La valeur de la somme des répartitions doit toujours être égale à emissionsGramsPerPax.
contrailsImpactBucket

enum (ContrailsImpactBucket)

Uniquement en sortie. 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.
source

enum (Source)

Uniquement en sortie. Source des données sur les émissions.

EmissionsBreakdown

Détails sur les différentes parties des émissions de la valeur totale "emissionsGramsPerPax". La valeur de la somme des répartitions doit toujours être égale à emissionsGramsPerPax.

Représentation JSON 
{
  "wttEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "ttwEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
Champs
wttEmissionsGramsPerPax

object (EmissionsGramsPerPax)

Estimations des émissions du puits au réservoir par passager. Ce champ est absent 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 flights.computeFlightEmissions.
ttwEmissionsGramsPerPax

object (EmissionsGramsPerPax)

Estimations des émissions par passager du réservoir à la vague. Ce champ est absent 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 flights.computeFlightEmissions.

EmissionsMetadata

Toutes les métadonnées supplémentaires.

Représentation JSON 
{
  "emissionsProvenance": {
    object (EmissionsProvenance)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "timWebsiteEmissionsCalculatorUrl": string
}
Champs
emissionsProvenance

object (EmissionsProvenance)

Uniquement en sortie. Détails sur la provenance des données utilisées pour calculer les données sur les émissions, y compris les facteurs contributifs avec leurs sources de données.
easaLabelMetadata

object (EasaLabelMetadata)

Uniquement en sortie. Métadonnées sur le système d'étiquetage des émissions des vols de l'AESA. Défini uniquement lorsque la source de données sur les émissions est l'EASA.
timWebsiteEmissionsCalculatorUrl

string

Uniquement en sortie. Lien vers le site Web du calculateur d'émissions travelimpactmodel.org. Exemple : https://travelimpactmodel.org/lookup/flight?itinerary=ZRH-BOS-LX-52-20261225.

EmissionsProvenance

Informations sur la provenance des données utilisées pour calculer les estimations des émissions, y compris les facteurs contributifs et leurs sources de données.

Représentation JSON 
{
  "provenanceEntries": [
    {
      object (EmissionsProvenance.EmissionsProvenanceEntry)
    }
  ]
}
Champs
provenanceEntries[]

object (EmissionsProvenance.EmissionsProvenanceEntry)

Uniquement en sortie. Tous les facteurs contribuant au calcul des émissions.

EmissionsProvenance.EmissionsProvenanceEntry

Détails sur un facteur de contribution unique dans les calculs d'émissions.

Représentation JSON 
{
  "provenanceEntryType": enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType),
  "source": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource),
  "sourceVersion": string,
  "dataCategory": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory),

  // Union field data_strategy can be only one of the following:
  "fuelBurnEeaStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy),
  "loadFactorsT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy),
  "loadFactorsChAviationStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy),
  "cargoMassFractionT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy),
  "seatAreaRatioIataStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy),
  "distanceAdjustmentStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)
  // End of list of possible types for union field data_strategy.

  // Union field data_value can be only one of the following:
  "loadFactorsData": number,
  "cargoMassFractionData": number,
  "seatAreaRatioData": {
    object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)
  },
  "estimatedFlightDistanceKm": integer
  // End of list of possible types for union field data_value.
}
Champs
provenanceEntryType

enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType)

Uniquement en sortie. Type d'entrée de provenance.
source

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource)

Uniquement en sortie. Source des données.
sourceVersion

string

Uniquement en sortie. Version des données sources. (par exemple, "2025/04").
dataCategory

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory)

Uniquement en sortie. Catégorie de données de la source de données.
Champ d'union data_strategy. Stratégie utilisée pour calculer les émissions pour la source de données spécifiée. L'ensemble de champs correspondra au type data_source. data_strategy ne peut être qu'un des éléments suivants :
fuelBurnEeaStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy)

Uniquement en sortie. Stratégie pour la consommation de carburant dans l'EEE.
loadFactorsT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy)

Uniquement en sortie. Stratégie pour les facteurs de charge T100.
loadFactorsChAviationStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy)

Uniquement en sortie. Stratégie pour les facteurs de charge CH-Aviation.
cargoMassFractionT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy)

Uniquement en sortie. Stratégie pour la fraction massique de la cargaison T100.
seatAreaRatioIataStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy)

Uniquement en sortie. Stratégie pour les ratios de zone de sièges IATA.
distanceAdjustmentStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)

Uniquement en sortie. Stratégie d'ajustement de la distance.
Champ d'union data_value. Valeur de données pour la source de données donnée. L'ensemble de champs correspondra à provenance_entry_type. data_value ne peut être qu'un des éléments suivants :
loadFactorsData

number

Uniquement en sortie. Valeur des données des facteurs de charge. Si elle n'est pas définie, la valeur des facteurs de charge n'est pas disponible.
cargoMassFractionData

number

Uniquement en sortie. Valeur de la fraction massique de la cargaison. Si elle n'est pas définie, la valeur de la fraction massique de la cargaison n'est pas disponible.
seatAreaRatioData

object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)

Uniquement en sortie. Valeur du ratio de surface de siège pour chaque classe. Si elle n'est pas définie, la valeur du ratio de surface de la place n'est pas disponible.
estimatedFlightDistanceKm

integer

Uniquement en sortie. Valeur de la distance parcourue estimée en phase de vol CCD en kilomètres, calculée à l'aide du facteur d'ajustement de la distance (DAF). Si elle n'est pas définie, la valeur de la distance de vol estimée n'est pas disponible.

EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType

Type d'entrée de provenance. De nouvelles valeurs pourront être ajoutées à l'avenir. Les clients doivent être prêts à gérer correctement les valeurs d'énumération inconnues.

Enums
EMISSIONS_PROVENANCE_ENTRY_TYPE_UNSPECIFIED Type d'entrée de provenance non spécifié.
FUEL_BURN Type d'entrée de la consommation de carburant.
LOAD_FACTORS Type d'entrée des facteurs de charge.
CARGO_MASS_FRACTION Type de saisie de la fraction massique de la cargaison.
SEATING_CONFIG Type d'entrée de configuration des sièges.
SEAT_AREA_RATIOS Type de saisie des ratios de surface des sièges.
DISTANCE_ADJUSTMENT Type d'entrée d'ajustement de la distance.

EmissionsProvenance.EmissionsProvenanceEntry.DataSource

Source de données pour les facteurs de provenance des émissions. De nouvelles valeurs pourront être ajoutées à l'avenir. Les clients doivent être prêts à gérer correctement les valeurs d'énumération inconnues.

Enums
DATA_SOURCE_UNSPECIFIED Source de données non spécifiée.
EEA Données fournies par l'Agence européenne pour l'environnement (AEE).
T100 Données de l'ensemble de données T-100, fournies par le Bureau des statistiques sur les transports des États-Unis.
CH_AVIATION Données fournies par ch-aviation.
OAG Données fournies par l'Official Aviation Guide (OAG).
OPERATING_CARRIER Données fournies par le transporteur.
AIRCRAFT_MODEL_TYPICAL Données types basées sur le modèle d'avion.
GLOBAL_DEFAULT Valeur globale par défaut, utilisée lorsqu'aucune autre source de données n'est disponible.
IATA Données fournies par l'Association internationale du transport aérien (IATA).
ICL Données fournies par l'Imperial College London.

EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy

Stratégie pour la consommation de carburant dans l'EEE. De nouvelles valeurs pourront être ajoutées à l'avenir. Les clients doivent être prêts à gérer correctement les valeurs d'énumération inconnues.

Enums
STRATEGY_UNSPECIFIED Stratégie non spécifiée.
AIRCRAFT_MAPPING_FALLBACK_WITH_CORRECTION_FACTOR Un facteur de correction statique a été appliqué.
AIRCRAFT_MAPPING_EXACT Un mappage exact des avions a été utilisé.
AIRCRAFT_MAPPING_FALLBACK Un mappage d'aéronef de secours a été utilisé.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy

Stratégie pour les facteurs de charge T100. De nouvelles valeurs pourront être ajoutées à l'avenir. Les clients doivent être prêts à gérer correctement les valeurs d'énumération inconnues.

Enums
STRATEGY_UNSPECIFIED Stratégie non spécifiée.
CARRIER_ROUTE_MONTH Données par transporteur, itinéraire et mois de voyage.
CARRIER_MONTH Données par transporteur et par mois de voyage.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH Données historiques correspondant au transporteur, à l'itinéraire, à l'année et au mois.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy

Stratégie pour les coefficients de remplissage CH-Aviation. De nouvelles valeurs pourront être ajoutées à l'avenir. Les clients doivent être prêts à gérer correctement les valeurs d'énumération inconnues.

Enums
STRATEGY_UNSPECIFIED Stratégie non spécifiée.
CARRIER_MONTH Données par transporteur et par mois de voyage.
ACTUAL_CARRIER_YEAR_MONTH Données historiques correspondant au transporteur, à l'année et au mois.

EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy

Stratégie pour la fraction massique de la cargaison T100. De nouvelles valeurs pourront être ajoutées à l'avenir. Les clients doivent être prêts à gérer correctement les valeurs d'énumération inconnues.

Enums
STRATEGY_UNSPECIFIED Stratégie non spécifiée.
CARRIER_ROUTE_AIRCRAFT_CLASS Données par transporteur, itinéraire et classe d'avion.
ROUTE_AIRCRAFT_CLASS Données par itinéraire et par classe d'avion.
DISTANCE_AIRCRAFT_CLASS Données par tranche de distance et par classe d'aéronef.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH_AIRCRAFT_CLASS Données historiques correspondant au transporteur, à l'itinéraire, à l'année, au mois et à la classe de l'avion.

EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy

Stratégie pour les ratios de zone de sièges IATA. De nouvelles valeurs pourront être ajoutées à l'avenir. Les clients doivent être prêts à gérer correctement les valeurs d'énumération inconnues.

Enums
STRATEGY_UNSPECIFIED Stratégie non spécifiée.
NARROW_AIRCRAFT_BODY Les ratios de surface des sièges pour les avions monocouloirs ont été utilisés.
WIDE_AIRCRAFT_BODY Les ratios de surface des sièges pour les avions long-courriers ont été utilisés.

EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy

Stratégie d'ajustement de la distance. De nouvelles valeurs pourront être ajoutées à l'avenir. Les clients doivent être prêts à gérer correctement les valeurs d'énumération inconnues.

Enums
STRATEGY_UNSPECIFIED Stratégie non spécifiée.
ORIGIN_DESTINATION Facteur d'ajustement de la distance déterminé par la paire d'aéroports d'origine et de destination.
COUNTRY_PAIR Facteur d'ajustement de la distance déterminé par la paire de pays d'origine et de destination.
DEFAULT Le facteur d'ajustement de la distance est basé sur la valeur par défaut, car nous n'avons pas trouvé de facteur d'ajustement spécifique à un aéroport ou à un pays.

EmissionsProvenance.EmissionsProvenanceEntry.DataCategory

Catégorie de données de la source de données. De nouvelles valeurs pourront être ajoutées à l'avenir. Les clients doivent être prêts à gérer correctement les valeurs d'énumération inconnues.

Enums
DATA_CATEGORY_UNSPECIFIED Catégorie de données non spécifiée.
PRIMARY Données primaires, telles que définies dans la norme ISO 14083.
MODELED Données modélisées, telles que définies dans la norme ISO 14083.
DEFAULT Données de valeur par défaut, telles que définies dans la norme ISO 14083.