نمای کلی API
API مدل تاثیر سفر، تخمینهای انتشار محاسبهشده بر اساس مدل تاثیر سفر را نشان میدهد. این تخمینهای انتشار نیز در Google Flights نشان داده میشود و دسترسی به API نیز از طریق افزونه Google Sheets در دسترس است.
API عمومی و رایگان است.
برای احراز هویت، به یک کلید API نیاز دارید.
بررسی اجمالی مدل تخمین های انتشار
مدل تاثیر سفر یک مدل برآورد انتشار آلاینده برای پروازها است.
متدولوژی در GitHub منتشر شده است.
داده های برآورد انتشار پرواز
این API از پروازهای تجاری در سراسر جهان که در 11 ماه آینده حرکت می کنند پشتیبانی می کند.
پروازهای چارتر، پروازهای خصوصی و پروازهای باری پشتیبانی نمی شوند. پروازهای گذشته پشتیبانی نمی شود. لطفاً در صورت داشتن سؤال و درخواست ویژگی، با ما تماس بگیرید ( صفحه پشتیبانی را ببینید).
داده های افشا شده توسط این API تحت مجوز CC BY-SA 4.0 است.
داده های انتشار معمولی پرواز
انتشارات معمولی پرواز تخمینی از انتشار گازهای گلخانه ای تولید شده به ازای هر مسافری است که از طریق هوا بین دو فرودگاه سفر می کند.
با استفاده از دادههای برآورد انتشار پرواز محاسبه میشود و روششناسی نحوه ایجاد آن مجموعه داده در GitHub منتشر میشود. انتشار گازهای گلخانه ای معمولی نباید به عنوان جایگزینی برای تخمین های انتشار گازهای گلخانه ای پرواز استفاده شود.
محدوده 3 داده های انتشار پرواز
مجموعه دادههای انتشارات پرواز Scope 3 برای کمک به شرکتها و افراد برای محاسبه و گزارش انتشارات Scope 3، رده 6 در سفرهای هوایی از سفرهای کاری طراحی شده است. خروجی کامل مدل شامل برآوردهای انتشار گازهای گلخانه ای از سال 2019 برای پروازهای تجاری برنامه ریزی شده در سراسر جهان است.
پشتیبانی مشتری MCP
API مدل تأثیر سفر از پروتکل زمینه مدل (MCP) پشتیبانی میکند. عاملهای هوش مصنوعی و مدلهای زبان بزرگ میتوانند از نقطه پایانی MCP برای کشف و استفاده پویا از قابلیتهای API استفاده کنند.
برای جزئیات بیشتر در مورد نحوه استفاده از نقطه پایانی MCP، به راهنمای ادغام MCP مراجعه کنید.
نمونه انتشارات پرواز را دریافت کنید
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} } ] }'
این مثال شامل یک پرواز ZRH - BOS با توقف در CDG و یک پرواز ZRH - BOS است.
دستور مثال، نقطه پایانی REST را با استفاده از curl فراخوانی میکند. در این دستور، باید $API_KEY با کلید API خود جایگزین کنید. همچنین ممکن است لازم باشد جزئیات پرواز را برای مطابقت با یک پرواز آینده موجود تنظیم کنید.
لطفاً برای مشاهده مستندات کامل منابع در معرض این API، به برگه مرجع مراجعه کنید. هر دو فراخوانی HTTP و 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" } }
نمونه پاسخ
نمونه انتشارات پرواز معمولی را دریافت کنید
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 } }'
این مثال شامل یک درخواست انتشار گازهای گلخانهای مبتنی بر TIM برای پرواز KE71 از ICN به YVR در کلاس اقتصادی، یک درخواست انتشار گازهای گلخانهای معمولی برای پرواز بین JFK و SFO در کلاس تجاری و یک درخواست انتشار گازهای گلخانهای مبتنی بر مسافت برای پرواز ۱۰۰۰ کیلومتری در کلاس درجه یک است.
دستور مثال، نقطه پایانی REST را با استفاده از curl فراخوانی میکند. در این دستور، باید $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 } }
نمونه پاسخ