API 개요
여행 영향 모델 API는 여행 영향 모델에 따라 계산된 배출량 추정치를 노출합니다. 이러한 배출량 추정치는 Google 항공편에도 표시되며 Google Sheets 부가기능을 통해 API에 액세스할 수도 있습니다.
API는 공개되어 있으며 무료입니다.
인증에는 API 키가 필요합니다.
예상 배출량 모델 개요
여행 영향력 모델은 항공편의 최신 배출량 추정 모델입니다.
이 방법론은 GitHub에 게시되어 있습니다.
항공편 예상 탄소 배출량 데이터
이 API는 향후 11개월 이내에 출발하는 전 세계 상용 항공편을 지원합니다.
전세 항공편, 비즈니스 항공편, 화물 항공편은 지원되지 않습니다. 이전 항공편은 지원되지 않습니다. 문의사항이 있거나 기능을 요청하려면 Google에 문의해 주세요 (지원 페이지 참고).
이 API에서 노출하는 데이터는 CC BY-SA 4.0 라이선스에 따라 라이선스가 부여됩니다.
일반적인 항공편 탄소 배출량 데이터
일반적인 항공편 탄소 배출량은 두 공항 간에 항공편을 이용하는 승객 1인당 발생하는 온실 가스 배출량을 추정한 값입니다.
항공편 배출량 추정치 데이터를 사용하여 계산되며, 해당 데이터 세트를 만드는 방법에 관한 방법론은 GitHub에 게시되어 있습니다. 일반적인 항공편 탄소 배출량은 항공편 탄소 배출량 추정치를 대체하는 용도로 사용해서는 안 됩니다.
Scope 3 항공편 배출량 데이터
범위 3 항공편 배출량 데이터 세트는 기업과 개인이 비즈니스 여행에서 발생하는 범위 3, 카테고리 6 항공 여행 배출량을 계산하고 보고하는 데 도움이 되도록 설계되었습니다. 전체 모델 출력에는 전 세계 정기 상업 항공편의 2019년 배출량 추정치가 포함됩니다.
항공편 탄소 배출량 가져오기 예시
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": 2025, "month": 12, "day": 2} }, { "origin": "CDG", "destination": "BOS", "operatingCarrierCode": "AF", "flightNumber": 334, "departureDate": {"year": 2025, "month": 12, "day": 1} }, { "origin": "ZRH", "destination": "BOS", "operatingCarrierCode": "LX", "flightNumber": 52, "departureDate": {"year": 2025, "month": 11, "day": 1} } ] }'
{ "flightEmissions": [ { "flight": { "origin": "ZRH", "destination": "CDG", "operatingCarrierCode": "AF", "flightNumber": 1115, "departureDate": { "year": 2025, "month": 12, "day": 2 } }, "emissionsGramsPerPax": { "first": 100349, "business": 100349, "premiumEconomy": 66900, "economy": 66900 }, "source": "TIM", "contrailsImpactBucket": "CONTRAILS_IMPACT_MODERATE" }, { "flight": { "origin": "CDG", "destination": "BOS", "operatingCarrierCode": "AF", "flightNumber": 334, "departureDate": { "year": 2025, "month": 12, "day": 1 } }, "emissionsGramsPerPax": { "first": 1650750, "business": 1320600, "premiumEconomy": 495224, "economy": 330150 }, "source": "TIM", "contrailsImpactBucket": "CONTRAILS_IMPACT_MODERATE" }, { "flight": { "origin": "ZRH", "destination": "BOS", "operatingCarrierCode": "LX", "flightNumber": 52, "departureDate": { "year": 2025, "month": 11, "day": 1 } }, "emissionsGramsPerPax": { "first": 1557805, "business": 1246244, "premiumEconomy": 467341, "economy": 311561 }, "source": "TIM", "contrailsImpactBucket": "CONTRAILS_IMPACT_MODERATE" } ], "modelVersion": { "major": 3, "minor": 0, "patch": 0, "dated": "20250627" } }
샘플 응답
일반적인 항공편 탄소 배출량 가져오기 예시
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" } }
샘플 응답
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 } }'
이 예에는 이코노미 클래스로 ICN에서 YVR까지 운항하는 KE71 항공편의 TIM 기반 탄소 배출량 요청, 비즈니스 클래스로 JFK와 SFO 사이를 운항하는 항공편의 일반적인 항공편 탄소 배출량 요청, 퍼스트 클래스로 1,000km를 운항하는 항공편의 거리 기반 탄소 배출량 요청이 포함되어 있습니다.
예시 명령어는 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 } }
샘플 응답