Travel Impact Model API | Google for Developers

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

API 概览

Travel Impact Model API 会公开根据 Travel Impact Model 计算的排放量估算值。这些排放量估算值也会显示在 Google 机票中，您还可以通过 Google 表格插件访问该 API。

该 API 是公开的，并且免费。

您需要使用 API 密钥进行身份验证。

此 API 公开的数据已获得 CC BY-SA 4.0 许可。

排放量估算模型概览

旅行碳排放影响评估模型 (TIM) 是一款先进的航班排放量估算模型。

该方法已在 GitHub 上发布。

如有任何疑问或功能请求，请与我们联系（请参阅支持页面）。

航班排放量估算数据

航班排放量是指每位乘客乘坐特定航班时产生的温室气体排放量估算值。

此 API 支持未来 11 个月内起飞的全球商业航班。不支持包机、私人航班和货运航班。不支持过去的航班。

典型航班排放量数据

典型航班排放量是指两座机场之间乘坐飞机的每位乘客产生的温室气体排放量的估算值。

该指数是使用航班排放量预估数据计算得出的，该数据集的创建方法已发布在 GitHub 上。典型航班排放量不应替代航班排放量估算值。

范围 3 航班排放量数据

范围 3 航班排放量数据集旨在帮助公司和个人计算和报告因商务旅行而产生的范围 3 第 6 类航空旅行排放量。完整模型输出包括 2019 年全球定期商业航班的排放量估算值。

详细的航班排放量估算数据

详细的航班排放量数据是透明的，其中包含每位乘客的温室气体排放量估算值，并附有全面的元数据，详细说明了计算方法、排放量细分、航迹云影响和数据来源。

此 API 支持未来 11 个月内起飞的全球商业航班。不支持包机、私人航班和货运航班。不支持过去的航班。

MCP 客户端支持

Travel Impact Model API 支持 Model Context Protocol (MCP)。AI 智能体和大型语言模型可以使用 MCP 端点来动态发现和利用 API 的功能。

如需详细了解如何使用 MCP 端点，请参阅MCP 集成指南。

获取航班排放量示例

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
  }
}

示例响应。

获取详细的航班排放量示例

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

此示例包含一个航班 ZRH - BOS。

示例命令使用 curl 调用 REST 端点。在该命令中，您需要将 $API_KEY 替换为您的 API 密钥。您可能还需要调整航班详细信息，使其与即将搭乘的现有航班相符。

如需查看此 API 公开的资源的完整文档，请参阅“参考文档”标签页。支持 HTTP 和 RPC 调用。

{
  "flightsWithDetailedEmissions": [
    {
      "flight": {
        "origin": "ZRH",
        "destination": "BOS",
        "operatingCarrierCode": "LX",
        "flightNumber": 52,
        "departureDate": {
          "year": 2026,
          "month": 10,
          "day": 30
        }
      },
      "flightEmissionsDetails": {
        "emissionsGramsPerPax": {
          "first": 1546945,
          "business": 1237556,
          "premiumEconomy": 464083,
          "economy": 309389
        },
        "emissionsBreakdown": {
          "wttEmissionsGramsPerPax": {
            "first": 260720,
            "business": 208576,
            "premiumEconomy": 78216,
            "economy": 52144
          },
          "ttwEmissionsGramsPerPax": {
            "first": 1286225,
            "business": 1028980,
            "premiumEconomy": 385867,
            "economy": 257245
          }
        },
        "contrailsImpactBucket": "CONTRAILS_IMPACT_MODERATE",
        "source": "TIM"
      },
      "emissionsMetadata": {
        "emissionsProvenance": {
          "provenanceEntries": [
            {
              "provenanceEntryType": "FUEL_BURN",
              "source": "EEA",
              "fuelBurnEeaStrategy": "AIRCRAFT_MAPPING_EXACT",
              "dataCategory": "PRIMARY"
            },
            {
              "provenanceEntryType": "LOAD_FACTORS",
              "source": "T100",
              "sourceVersion": "2025-11",
              "loadFactorsT100Strategy": "CARRIER_ROUTE_MONTH",
              "dataCategory": "MODELED",
              "loadFactorsData": 0.83758790874357414
            },
            {
              "provenanceEntryType": "CARGO_MASS_FRACTION",
              "source": "T100",
              "sourceVersion": "2026-2",
              "cargoMassFractionT100Strategy": "CARRIER_ROUTE_AIRCRAFT_CLASS",
              "dataCategory": "MODELED",
              "cargoMassFractionData": 0.2935313907054376
            },
            {
              "provenanceEntryType": "SEATING_CONFIG",
              "source": "OPERATING_CARRIER",
              "dataCategory": "PRIMARY"
            },
            {
              "provenanceEntryType": "SEAT_AREA_RATIOS",
              "source": "IATA",
              "sourceVersion": "IATA_RP_1726",
              "dataCategory": "DEFAULT",
              "seatAreaRatioIataStrategy": "WIDE_AIRCRAFT_BODY",
              "seatAreaRatioData": {
                "first": 5,
                "business": 4,
                "premiumEconomy": 1.5,
                "economy": 1
              }
            },
            {
              "provenanceEntryType": "DISTANCE_ADJUSTMENT",
              "source": "ICL",
              "dataCategory": "MODELED",
              "distanceAdjustmentStrategy": "ORIGIN_DESTINATION",
              "estimatedFlightDistanceKm": 6119
            }
          ]
        },
        "timWebsiteEmissionsCalculatorUrl": "https://travelimpactmodel.org/lookup/flight?itinerary=ZRH-BOS-LX-52-20261030"
      }
    }
  ],
  "modelVersion": {
    "major": 3,
    "minor": 0,
    "patch": 0,
    "dated": "20260610"
  }
}

示例响应。