Method: flights.computeTypicalFlightEmissions

Retrieves typical flight emissions estimates between two airports, also known as a market. If there are no estimates available for a certain market, the response will return the market object with empty emission fields. The request will still be considered successful.

Details on how the typical emissions estimates are computed are on GitHub.

The request can contain up to 1000 markets. If the request has more than 1000 markets, it will fail with an INVALID_ARGUMENT error.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "markets": [
    {
      object (Market)
    }
  ]
}
Fields
markets[]

object (Market)

Required. Request the typical flight emissions estimates for this market pair. A maximum of 1000 markets can be requested.

Response body

The response includes the emissions but also the model version.

If successful, the response body contains data with the following structure:

JSON representation 
{
  "typicalFlightEmissions": [
    {
      object (TypicalFlightEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
Fields
typicalFlightEmissions[]

object (TypicalFlightEmissions)

Market's Typical Flight Emissions requested.
modelVersion

object (ModelVersion)

The model version under which typical flight emission estimates for all flights in this response were computed.

Market

A pair of airports.

JSON representation 
{
  "origin": string,
  "destination": string
}
Fields
origin

string

Required. IATA airport code for flight origin, e.g. "LHR".
destination

string

Required. IATA airport code for flight destination, e.g. "JFK".

TypicalFlightEmissions

Typical flight emission estimates for a certain market

JSON representation 
{
  "market": {
    object (Market)
  },
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
Fields
market

object (Market)

Required. Matches the flight identifiers in the request. Note: all IATA codes are capitalized.
emissionsGramsPerPax

object (EmissionsGramsPerPax)

Optional. Typical flight emissions per passenger for requested market. Will not be present if a typical emissions could not be computed. For the list of reasons why typical flight emissions could not be computed, see GitHub.