Panoramica dell'API
L'API Travel Impact Model espone le stime delle emissioni calcolate in base al Travel Impact Model. Queste stime delle emissioni vengono mostrate anche su Google Voli e l'accesso all'API è disponibile anche tramite il componente aggiuntivo Google Fogli.
L'API è pubblica e senza costi.
Per l'autenticazione, è necessaria una chiave API.
Panoramica del modello di stima delle emissioni
Il Travel Impact Model è un modello di stima delle emissioni all'avanguardia per i voli.
La metodologia è pubblicata su GitHub.
Dati sulle stime delle emissioni dei voli
Questa API supporta i voli commerciali in tutto il mondo in partenza nei prossimi 11 mesi.
I voli charter, i voli privati e i voli cargo non sono supportati. I voli passati non sono supportati. Contattaci (vedi la pagina di assistenza) per richieste e richieste di funzionalità.
I dati esposti da questa API sono soggetti alla licenza CC BY-SA 4.0.
Dati sulle emissioni tipiche dei voli
Le emissioni di un volo standard sono stime delle emissioni di gas serra prodotte per passeggero che viaggia in aereo tra due aeroporti.
Viene calcolato utilizzando i dati delle stime delle emissioni dei voli e la metodologia per la creazione del set di dati è pubblicata su GitHub. Le emissioni di un volo standard non devono essere utilizzate al posto delle stime delle emissioni dei voli.
Dati sulle emissioni dei voli Scope 3
Il set di dati sulle emissioni dei voli dell'ambito 3 è progettato per aiutare aziende e privati a calcolare e segnalare le emissioni dei viaggi aerei dell'ambito 3, categoria 6 derivanti dai viaggi di lavoro. L'output completo del modello include le stime delle emissioni dal 2019 per i voli commerciali programmati in tutto il mondo.
Visualizzare l'esempio di emissioni del volo
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} } ] }'
L'esempio include un volo ZRH - BOS con scalo a CDG e un volo ZRH - BOS.
Il comando di esempio chiama l'endpoint REST utilizzando curl. Nel comando, dovrai sostituire $API_KEY con la tua chiave API. Potresti anche dover modificare i dettagli del volo in modo che corrispondano a un volo in partenza esistente.
Consulta la scheda Riferimento per la documentazione completa delle risorse esposte da questa API. Sono supportate sia le chiamate HTTP che 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" } }
Esempio di risposta.
Visualizzare un esempio di emissioni di un volo standard
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" }, ] }'
L'esempio include due mercati: ZRH-BOS e BOS-ZRH.
Il comando di esempio chiama l'endpoint REST utilizzando curl. Nel comando, dovrai sostituire $API_KEY con la tua chiave API.
Consulta la scheda Riferimento per la documentazione completa delle risorse esposte da questa API. Sono supportate sia le chiamate HTTP che 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" } }
Esempio di risposta.
Esempio di emissioni dei voli di Scope 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 } }'
L'esempio include una richiesta di emissioni basata sul TIM per il volo KE71 da ICN a YVR in classe economy, una richiesta di emissioni di volo tipica per un volo tra JFK e SFO in classe business e una richiesta di emissioni basata sulla distanza per un volo di 1000 km in prima classe.
Il comando di esempio chiama l'endpoint REST utilizzando curl. Nel comando, dovrai sostituire $API_KEY con la tua chiave API.
Consulta la scheda Riferimento per la documentazione completa delle risorse esposte da questa API. Sono supportate sia le chiamate HTTP che 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 } }
Esempio di risposta.