Omówienie interfejsu API
Interfejs Travel Impact Model API udostępnia szacunki emisji obliczone zgodnie z modelem wpływu podróży. Te szacunki emisji są też wyświetlane w Lotach Google, a dostęp do interfejsu API jest też możliwy za pomocą dodatku do Arkuszy Google.
Interfejs API jest publiczny i bezpłatny.
Do uwierzytelnienia potrzebny będzie klucz interfejsu API.
Dane udostępniane przez ten interfejs API są objęte licencją CC BY-SA 4.0.
Omówienie modelu szacowania emisji
Model wpływu podróży to zaawansowany model szacowania emisji w przypadku lotów.
Metodologia jest opublikowana na GitHub.
Jeśli masz pytania lub prośby dotyczące funkcji, skontaktuj się z nami (informacje znajdziesz na stronie pomocy).
Dane dotyczące szacowanej emisji lotów
Emisja lotu to szacunkowa emisja gazów cieplarnianych na pasażera podróżującego na danym locie.
Ten interfejs API obsługuje loty komercyjne na całym świecie, które odbędą się w ciągu najbliższych 11 miesięcy. Loty czarterowe, prywatne i towarowe nie są obsługiwane. Loty, które już się odbyły, nie są obsługiwane.
Dane dotyczące typowej emisji lotów
Typowa emisja lotu to szacowana emisja gazów cieplarnianych na pasażera podróżującego samolotem między dwoma lotniskami.
Jest on obliczany na podstawie danych o szacowanej emisji z lotów, a metodyka tworzenia tego zbioru danych jest dostępna w GitHub. Typowa emisja lotów nie powinna zastępować szacowanej emisji lotów.
Dane dotyczące emisji lotów w zakresie 3
Zbiór danych dotyczących emisji z lotów w zakresie 3 został opracowany, aby pomóc firmom i osobom fizycznym obliczać i zgłaszać emisje z podróży lotniczych w ramach podróży służbowych w zakresie 3, kategorii 6. Pełne dane wyjściowe modelu obejmują szacunki emisji z 2019 r. w przypadku regularnych lotów komercyjnych na całym świecie.
Szczegółowe dane dotyczące szacowanej emisji podczas lotu
Szczegółowe dane o emisjach z lotów to przejrzyste szacunki emisji gazów cieplarnianych na pasażera uzupełnione o obszerne metadane zawierające szczegółowe informacje o metodologii obliczeń, podziale emisji, wpływie smug kondensacyjnych i pochodzeniu danych.
Ten interfejs API obsługuje komercyjne loty na całym świecie, które odbędą się w ciągu najbliższych 11 miesięcy. Loty czarterowe, prywatne i towarowe nie są obsługiwane. Loty, które już się odbyły, nie są obsługiwane.
Obsługa klienta MCP
Interfejs Travel Impact Model API obsługuje protokół Model Context Protocol (MCP). Agenci AI i duże modele językowe mogą używać punktu końcowego MCP do dynamicznego wykrywania i wykorzystywania funkcji interfejsu API.
Szczegółowe informacje o korzystaniu z punktu końcowego MCP znajdziesz w przewodniku integracji MCP.
Pobieranie przykładu emisji lotów
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} } ] }'
Przykład obejmuje lot ZRH–BOS z przesiadką w CDG oraz lot ZRH–BOS.
Przykładowe polecenie wywołuje punkt końcowy REST za pomocą narzędzia curl. W poleceniu musisz zastąpić $API_KEY swoim kluczem interfejsu API. Może też być konieczne dostosowanie szczegółów lotu do istniejącego, nadchodzącego lotu.
Pełną dokumentację zasobów udostępnianych przez ten interfejs API znajdziesz na karcie Materiały referencyjne. Obsługiwane są zarówno wywołania HTTP, jak i 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" } }
Przykładowa odpowiedź.
Pobieranie przykładu typowej emisji lotów
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" }, ] }'
Przykład obejmuje 2 rynki: ZRH-BOS i BOS-ZRH.
Przykładowe polecenie wywołuje punkt końcowy REST za pomocą narzędzia curl. W poleceniu musisz zastąpić $API_KEY swoim kluczem interfejsu API.
Pełną dokumentację zasobów udostępnianych przez ten interfejs API znajdziesz na karcie Materiały referencyjne. Obsługiwane są zarówno wywołania HTTP, jak i 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" } }
Przykładowa odpowiedź.
Pobieranie przykładu emisji lotów w zakresie 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 } }'
Przykład obejmuje żądanie dotyczące emisji oparte na TIM w przypadku lotu KE71 z ICN do YVR w klasie ekonomicznej, typowe żądanie dotyczące emisji w przypadku lotu między JFK a SFO w klasie biznesowej oraz żądanie dotyczące emisji oparte na odległości w przypadku lotu o długości 1000 km w pierwszej klasie.
Przykładowe polecenie wywołuje punkt końcowy REST za pomocą narzędzia curl. W poleceniu musisz zastąpić $API_KEY swoim kluczem interfejsu API.
Pełną dokumentację zasobów udostępnianych przez ten interfejs API znajdziesz na karcie Materiały referencyjne. Obsługiwane są zarówno wywołania HTTP, jak i 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 } }
Przykładowa odpowiedź.
Przykład szczegółowych informacji o emisji związanej z lotami
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} } ] }'
Przykład obejmuje 1 lot na trasie ZRH – BOS.
Przykładowe polecenie wywołuje punkt końcowy REST za pomocą narzędzia curl. W poleceniu musisz zastąpić $API_KEY swoim kluczem API. Może też być konieczne dostosowanie szczegółów lotu do istniejącego nadchodzącego lotu.
Pełną dokumentację zasobów udostępnianych przez ten interfejs API znajdziesz na karcie Materiały referencyjne. Obsługiwane są wywołania HTTP i 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" } }
Przykładowa odpowiedź.