Travel Impact Model API | Google for Developers

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

Tổng quan về API

Travel Impact Model API cung cấp số liệu ước tính lượng khí thải được tính toán theo Travel Impact Model. Những thông tin ước tính về lượng khí thải này cũng xuất hiện trên Google Chuyến bay và bạn cũng có thể truy cập vào API này thông qua Tiện ích bổ sung Google Trang tính.

API này là công khai và miễn phí.

Để xác thực, bạn sẽ cần có một khoá API.

Dữ liệu do API này cung cấp được cấp phép theo giấy phép CC BY-SA 4.0.

Tổng quan về mô hình ước tính lượng khí thải

Travel Impact Model là một mô hình ước tính lượng khí thải tối tân cho các chuyến bay.

Phương pháp này được công bố trên GitHub.

Vui lòng liên hệ với chúng tôi (xem trang Hỗ trợ) nếu bạn có thắc mắc và yêu cầu về tính năng.

Dữ liệu về lượng khí thải ước tính của chuyến bay

Lượng khí thải của chuyến bay là số liệu ước tính về lượng khí nhà kính mà mỗi hành khách tạo ra khi đi trên một chuyến bay cụ thể.

API này hỗ trợ các chuyến bay thương mại trên toàn thế giới khởi hành trong vòng 11 tháng tới. Chúng tôi không hỗ trợ các chuyến bay thuê bao, chuyến bay riêng và chuyến bay chở hàng. Không được hỗ trợ các chuyến bay trước đây.

Dữ liệu về lượng khí thải thông thường của chuyến bay

Lượng khí thải thông thường của chuyến bay là lượng khí nhà kính ước tính được phát thải trên mỗi hành khách đi bằng đường hàng không giữa hai sân bay.

Chỉ số này được tính bằng cách sử dụng dữ liệu ước tính về lượng khí thải của chuyến bay và phương pháp tạo tập dữ liệu đó được xuất bản trên GitHub. Bạn không nên sử dụng lượng khí thải thông thường của chuyến bay thay cho lượng khí thải ước tính của chuyến bay.

Dữ liệu về lượng khí thải từ chuyến bay thuộc phạm vi 3

Tập dữ liệu Lượng khí thải từ chuyến bay thuộc Phạm vi 3 được thiết kế để giúp các công ty và cá nhân tính toán và báo cáo lượng khí thải từ chuyến bay thuộc Phạm vi 3, Danh mục 6 trong các chuyến đi công tác. Đầu ra của mô hình đầy đủ bao gồm số liệu ước tính lượng khí thải từ năm 2019 cho các chuyến bay thương mại theo lịch trình trên toàn thế giới.

Dữ liệu chi tiết về lượng khí thải ước tính của chuyến bay

Thông tin chi tiết về lượng khí thải của chuyến bay là số liệu ước tính minh bạch về lượng khí thải nhà kính trên mỗi hành khách, được bổ sung bằng siêu dữ liệu toàn diện nêu chi tiết phương pháp tính toán, thành phần khí thải, tác động của vệt ngưng tụ và nguồn gốc dữ liệu.

Dịch vụ hỗ trợ khách hàng MCP

Travel Impact Model API hỗ trợ Giao thức ngữ cảnh mô hình (MCP). Các tác nhân AI và Mô hình ngôn ngữ lớn có thể sử dụng điểm cuối MCP để tự động phát hiện và tận dụng các chức năng của API.

Hãy xem Hướng dẫn tích hợp MCP để biết thông tin chi tiết về cách sử dụng điểm cuối MCP.

Ví dụ về cách lấy lượng khí thải của chuyến bay

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

Ví dụ này bao gồm chuyến bay ZRH – BOS có điểm quá cảnh ở CDG và chuyến bay ZRH – BOS.

Lệnh ví dụ gọi điểm cuối REST bằng curl. Trong lệnh này, bạn sẽ phải thay thế $API_KEY bằng khoá API của mình. Bạn cũng có thể cần điều chỉnh thông tin chi tiết về chuyến bay để khớp với một chuyến bay sắp tới hiện có.

Vui lòng xem thẻ Tham khảo để biết tài liệu đầy đủ về các tài nguyên do API này cung cấp. Cả lệnh gọi HTTP và RPC đều được hỗ trợ.

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

Câu trả lời mẫu.

Xem ví dụ về Lượng khí thải thông thường của chuyến bay

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"
    },
  ]
}'

Ví dụ này bao gồm hai thị trường ZRH-BOS và BOS-ZRH.

Lệnh ví dụ gọi điểm cuối REST bằng curl. Trong lệnh này, bạn sẽ phải thay thế $API_KEY bằng khoá API của mình.

Vui lòng xem thẻ Tham khảo để biết tài liệu đầy đủ về các tài nguyên do API này hiển thị. Cả lệnh gọi HTTP và RPC đều được hỗ trợ.

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

Câu trả lời mẫu.

Xem ví dụ về lượng khí thải từ chuyến bay thuộc Phạm vi 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
  }
}'

Ví dụ này bao gồm một yêu cầu về lượng khí thải dựa trên TIM cho chuyến bay KE71 từ ICN đến YVR ở hạng phổ thông, một yêu cầu điển hình về lượng khí thải cho chuyến bay giữa JFK và SFO ở hạng thương gia và một yêu cầu về lượng khí thải dựa trên khoảng cách cho chuyến bay dài 1.000 km ở hạng nhất.

Lệnh ví dụ gọi điểm cuối REST bằng curl. Trong lệnh này, bạn sẽ phải thay thế $API_KEY bằng khoá API của mình.

Vui lòng xem thẻ Tham khảo để biết tài liệu đầy đủ về các tài nguyên do API này cung cấp. Cả lệnh gọi HTTP và RPC đều được hỗ trợ.

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

Câu trả lời mẫu.

Ví dụ về lượng khí thải chi tiết của chuyến bay

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

Ví dụ này bao gồm một chuyến bay duy nhất từ ZRH đến BOS.

Lệnh ví dụ này gọi điểm cuối REST bằng cách sử dụng curl. Trong lệnh này, bạn sẽ phải thay thế $API_KEY bằng khoá API của mình. Bạn cũng có thể cần điều chỉnh thông tin chi tiết về chuyến bay cho phù hợp với một chuyến bay sắp tới hiện có.

Vui lòng xem thẻ Tài liệu tham khảo để biết tài liệu đầy đủ về các tài nguyên do API này cung cấp. Cả lệnh gọi HTTP và RPC đều được hỗ trợ.

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

Câu trả lời mẫu.