Tổng quan về API
Travel Impact Model API cung cấp số liệu ước tính về lượng khí thải được tính toán theo Mô hình ước tính tác động của việc đi lại. 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.
Tổng quan về mô hình ước tính lượng khí thải
Mô hình ước tính tác động của việc đi lại là một mô hình ước tính lượng khí thải hiện đại cho các chuyến bay.
Phương pháp này được xuất bản trên GitHub.
Dữ liệu về lượng khí thải ước tính của chuyến bay
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 11 tháng tới.
Không hỗ trợ chuyến bay thuê bao, chuyến bay riêng và chuyến bay chở hàng. Không hỗ trợ chuyến bay đã qua. 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 do API này hiển thị được cấp phép theo CC BY-SA 4.0.
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ị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" }, ] }'
{ "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.