Travel Impact Model API | Google for Developers

本頁面由 Cloud Translation API 翻譯而成。

API 總覽

旅遊影響模型 API 會根據旅遊影響模型，提供預估碳排放量。Google 航班也會顯示這些預估排放量，您也可以透過 Google 試算表外掛程式存取 API。

這項 API 是公開的，而且免費。

如要進行驗證，您需要 API 金鑰。

碳排放量預估模型總覽

旅遊影響模型是目前最先進的航班碳排放量預估模型。

我們已在 GitHub 上發布這項方法。

航班預估排放量資料

這個 API 支援未來 11 個月內的全球商業航班。

不支援包機、私人航班和貨機。不支援過去的航班。如有任何問題或功能要求，請與我們聯絡 (請參閱支援頁面)。

這個 API 公開的資料採用 CC BY-SA 4.0 授權。

一般航班排放量資料

一般航班排放量是指兩個機場之間航班行程的溫室氣體排放量，以乘客為單位計算。

我們會使用航班排放量預估資料來計算這項指標，並在 GitHub 上發布建立這類資料集的方法。一般航班排放量不應取代航班排放量預估值。

範圍 3 航班碳排放量資料

範圍 3 航班排放量資料集旨在協助公司和個人計算及回報商務旅行的範圍 3 類別 6 空運排放量。完整模型輸出內容包含 2019 年全球定期商業航班的預估排放量。

取得航班碳排放量範例

curl https://travelimpactmodel.googleapis.com/v1/flights:computeFlightEmissions?key=$API_KEY \
  -H "Content-Type: application/json" -d \
  '{
    "flights": [
      {
        "origin": "ZRH",
        "destination": "CDG",
        "operatingCarrierCode": "AF",
        "flightNumber": 1115,
        "departureDate": {"year": 2026, "month": 10, "day": 2}
      },
      {
        "origin": "CDG",
        "destination": "BOS",
        "operatingCarrierCode": "AF",
        "flightNumber": 334,
        "departureDate": {"year": 2026, "month": 10, "day": 1}
      },
      {
        "origin": "ZRH",
        "destination": "BOS",
        "operatingCarrierCode": "LX",
        "flightNumber": 52,
        "departureDate": {"year": 2026, "month": 9, "day": 1}
      }
    ]
  }'

這個範例包含 ZRH - BOS 航班 (中途在 CDG 轉機) 和 ZRH - BOS 航班。

範例指令會使用 curl 呼叫 REST 端點。在指令中，您必須將 $API_KEY 替換成您的 API 金鑰。你可能也需要調整航班詳細資料，與現有的近期航班相符。

如需此 API 公開資源的完整說明文件，請參閱「參考資料」分頁。支援 HTTP 和 RPC 呼叫。

{
  "flightEmissions": [
    {
      "flight": {
        "origin": "ZRH",
        "destination": "CDG",
        "operatingCarrierCode": "AF",
        "flightNumber": 1115,
        "departureDate": {
          "year": 2026,
          "month": 10,
          "day": 2
        }
      },
      "emissionsGramsPerPax": {
        "first": 100360,
        "business": 100360,
        "premiumEconomy": 66907,
        "economy": 66907
      },
      "source": "TIM",
      "contrailsImpactBucket": "CONTRAILS_IMPACT_MODERATE"
    },
    {
      "flight": {
        "origin": "CDG",
        "destination": "BOS",
        "operatingCarrierCode": "AF",
        "flightNumber": 334,
        "departureDate": {
          "year": 2026,
          "month": 10,
          "day": 1
        }
      },
      "emissionsGramsPerPax": {
        "first": 1549875,
        "business": 1239900,
        "premiumEconomy": 464962,
        "economy": 309975
      },
      "source": "TIM",
      "contrailsImpactBucket": "CONTRAILS_IMPACT_MODERATE"
    },
    {
      "flight": {
        "origin": "ZRH",
        "destination": "BOS",
        "operatingCarrierCode": "LX",
        "flightNumber": 52,
        "departureDate": {
          "year": 2026,
          "month": 9,
          "day": 1
        }
      },
      "emissionsGramsPerPax": {
        "first": 1412110,
        "business": 1129688,
        "premiumEconomy": 423632,
        "economy": 282422
      },
      "source": "TIM",
      "contrailsImpactBucket": "CONTRAILS_IMPACT_MODERATE"
    }
  ],
  "modelVersion": {
    "major": 3,
    "minor": 0,
    "patch": 0,
    "dated": "20251013"
  }
}

回應範例。

取得一般航班排放量範例

curl https://travelimpactmodel.googleapis.com/v1/flights:computeTypicalFlightEmissions?key=$API_KEY \
-H "Content-Type: application/json" -d \
'{
  "markets": [
    {
      "origin": "ZRH",
      "destination": "BOS"
    },
    {
      "origin": "BOS",
      "destination": "ZRH"
    },
  ]
}'

這個範例包含兩個市場：ZRH-BOS 和 BOS-ZRH。

範例指令會使用 curl 呼叫 REST 端點。在指令中，您必須將 $API_KEY 替換成您的 API 金鑰。

如需此 API 公開資源的完整說明文件，請參閱「參考資料」分頁。支援 HTTP 和 RPC 呼叫。

{
  "typicalFlightEmissions": [
    {
      "market": {
        "origin": "ZRH",
        "destination": "BOS"
      },
      "emissionsGramsPerPax": {
        "first": 1721684,
        "business": 1411005,
        "premiumEconomy": 566775,
        "economy": 406535
      }
    },
    {
      "market": {
        "origin": "BOS",
        "destination": "ZRH"
      },
      "emissionsGramsPerPax": {
        "first": 2149656,
        "business": 1737021,
        "premiumEconomy": 688646,
        "economy": 488115
      }
    }
  ],
  "modelVersion": {
    "major": 2,
    "minor": 0,
    "patch": 0,
    "dated": "20250131"
  }
}

回應範例。

取得範圍 3 航班碳排放量範例

curl https://travelimpactmodel.googleapis.com/v1/flights:computeScope3FlightEmissions?key=$API_KEY \
-H "Content-Type: application/json" -d \
'{
  "flights": [{
    "departureDate": {
      "year": 2025,
      "month": 5,
      "day": 13
    },
    "cabinClass": "ECONOMY",
    "origin": "ICN",
    "destination": "YVR",
    "carrierCode": "KE",
    "flightNumber": 71
  }, {
    "departureDate": {
      "year": 2025,
      "month": 1,
      "day": 1
    },
    "cabinClass": "BUSINESS",
    "origin": "JFK",
    "destination": "SFO"
  }, {
    "departureDate": {
      "year": 2025,
      "month": 1,
      "day": 1
    },
    "cabinClass": "FIRST",
    "distanceKm": "1000"
  }],
  "modelVersion": {
    "major": 2,
    "minor": 0
  }
}'

範例包括：從 ICN 飛往 YVR 的 KE71 航班 (經濟艙) 的 TIM 排放量要求、從 JFK 飛往 SFO 的航班 (商務艙) 的一般航班排放量要求，以及 1,000 公里航班 (頭等艙) 的距離排放量要求。

範例指令會使用 curl 呼叫 REST 端點。在指令中，您必須將 $API_KEY 替換成您的 API 金鑰。

如需此 API 公開資源的完整說明文件，請參閱「參考資料」分頁。支援 HTTP 和 RPC 呼叫。

{
  "flightEmissions": [{
    "flight": {
      "departureDate": {
        "year": 2025,
        "month": 5,
        "day": 13
      },
      "cabinClass": "ECONOMY",
      "origin": "ICN",
      "destination": "YVR",
      "carrierCode": "KE",
      "flightNumber": 71
    },
    "wtwEmissionsGramsPerPax": "429613",
    "source": "TIM_EMISSIONS",
    "ttwEmissionsGramsPerPax": "357207",
    "wttEmissionsGramsPerPax": "72406"
  }, {
    "flight": {
      "departureDate": {
        "year": 2025,
      },
      "cabinClass": "BUSINESS",
      "origin": "JFK",
      "destination": "SFO"
    },
    "wtwEmissionsGramsPerPax": "885184",
    "source": "TYPICAL_FLIGHT_EMISSIONS",
    "ttwEmissionsGramsPerPax": "735997",
    "wttEmissionsGramsPerPax": "149187"
  }, {
    "flight": {
      "departureDate": {
        "year": 2025,
        "month": 0,
        "day": 0
      },
      "cabinClass": "FIRST",
      "distanceKm": "1000"
    },
    "wtwEmissionsGramsPerPax": "328000",
    "source": "DISTANCE_BASED_EMISSIONS",
    "ttwEmissionsGramsPerPax": "273000",
    "wttEmissionsGramsPerPax": "55000"
  }],
  "modelVersion": {
    "major": 2,
    "minor": 0
  }
}

回應範例。