Method: flights.computeFlightEmissions

Méthode sans état permettant de récupérer les estimations d'émissions. Pour en savoir plus sur le calcul des estimations d'émissions, consultez GitHub.

La réponse contient toutes les entrées qui correspondent aux tronçons de vol d'entrée, dans le même ordre. Si aucune estimation n'est disponible pour un tronçon de vol donné, la réponse renvoie l'objet de tronçon de vol avec des champs d'émissions vides. La requête est toujours considérée comme ayant abouti. Voici quelques-unes des raisons pour lesquelles les estimations d'émissions peuvent être manquantes :

  • Le vol est inconnu du serveur.
  • Un ou plusieurs identifiants sont manquants dans le tronçon de vol d'entrée.
  • La date du vol est passée.
  • Le type d'avion n'est pas pris en charge par le modèle.
  • La configuration des sièges est manquante.

La requête peut contenir jusqu'à 1 000 tronçons de vol. Si la requête comporte plus de 1 000 vols directs, elle échoue et une erreur INVALID_ARGUMENT est renvoyée.

Requête HTTP

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

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 des estimations d'émissions.

Corps de la réponse

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

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 (FlightWithEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Champs
flightEmissions[]

object (FlightWithEmissions)

Liste des tronçons de vol avec estimations d'émissions.
modelVersion

object (ModelVersion)

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

Vol

Tous les détails liés à un seul élément de requête pour les estimations d'émissions d'un vol direct.

Représentation JSON 
{
  "origin": string,
  "destination": string,
  "operatingCarrierCode": string,
  "flightNumber": integer,
  "departureDate": {
    object (Date)
  }
}
Champs
origin

string

Obligatoire. Code IATA de l'aéroport de départ du vol, par exemple "LHR".
destination

string

Obligatoire. Code IATA de l'aéroport de destination du vol, par exemple "JFK".
operatingCarrierCode

string

Obligatoire. Code IATA de la compagnie aérienne, par exemple "AA".
flightNumber

integer

Obligatoire. Numéro de vol, par exemple 324.
departureDate

object (Date)

Obligatoire. Date du vol dans le fuseau horaire de l'aéroport de départ. Doit être une date présente ou future.

FlightWithEmissions

Vol direct avec estimations d'émissions.

Représentation JSON 
{
  "flight": {
    object (Flight)
  },
  "source": enum (Source),
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket)
}
Champs
flight

object (Flight)

Identifiant. Correspond aux identifiants de vol de la requête. Remarque : Tous les codes IATA sont en majuscules.
source

enum (Source)

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

object (EmissionsGramsPerPax)

Facultatif. Chiffres d'estimation des émissions par passager. Ne sera pas présent 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.
easaLabelMetadata

object (EasaLabelMetadata)

Facultatif. Métadonnées concernant le label d'émissions des vols de l'EASA. Défini uniquement lorsque la source des données d'émissions est l'EASA.
contrailsImpactBucket

enum (ContrailsImpactBucket)

Facultatif. Importance de l'impact des traînées de condensation sur le réchauffement climatique par rapport à l'impact total des émissions de CO2e.

Source

Source des données d'émissions.

Enums
SOURCE_UNSPECIFIED La source des données d'émissions n'est pas spécifiée.
TIM Les données d'émissions proviennent du modèle d'impact sur les voyages.
EASA Les données d'émissions proviennent des labels environnementaux de l'EASA.

EasaLabelMetadata

Métadonnées concernant le label d'émissions des vols de l'EASA.

Représentation JSON 
{
  "labelIssueDate": {
    object (Date)
  },
  "labelExpiryDate": {
    object (Date)
  },
  "labelVersion": string,
  "safDiscountPercentage": number
}
Champs
labelIssueDate

object (Date)

Date d'émission du label.
labelExpiryDate

object (Date)

Date d'expiration du label. Le label peut être affiché jusqu'à la fin de cette date.
labelVersion

string

Version du label.
safDiscountPercentage

number

Pourcentage de remise sur les émissions de carburant d'aviation durable (CAD) appliqué au label. Il s'agit d'un pourcentage sous forme décimale. Les valeurs sont comprises dans l'intervalle [0,1]. Par exemple, 0,0021 signifie 0,21 %.

Cette remise et cette réduction des émissions sont indiquées par le label de l'EASA, mais ne sont pas incluses dans les estimations de CO2e distribuées par cette API.

ContrailsImpactBucket

Importance de l'impact des traînées de condensation sur le réchauffement climatique par rapport à l'impact total des émissions de CO2e.

Enums
CONTRAILS_IMPACT_UNSPECIFIED L'impact des traînées de condensation n'est pas spécifié.
CONTRAILS_IMPACT_NEGLIGIBLE L'impact des traînées de condensation est négligeable par rapport aux émissions totales de CO2e.
CONTRAILS_IMPACT_MODERATE L'impact des traînées de condensation est comparable aux émissions totales de CO2e.
CONTRAILS_IMPACT_SEVERE L'impact des traînées de condensation est supérieur à l'impact total des émissions de CO2e.