نظرة عامة على واجهة برمجة التطبيقات
تعرض Travel Impact Model API تقديرات الانبعاثات المحسوبة وفقًا لنموذج تأثير السفر. تظهر تقديرات الانبعاثات هذه أيضًا على رحلات جوية من Google، ويمكن الوصول إلى واجهة برمجة التطبيقات أيضًا من خلال إضافة جداول بيانات Google.
واجهة برمجة التطبيقات هذه عامة ومتاحة مجانًا.
للمصادقة، ستحتاج إلى مفتاح واجهة برمجة التطبيقات.
البيانات التي تعرضها واجهة برمجة التطبيقات هذه مرخّصة بموجب ترخيص CC BY-SA 4.0.
بيانات تقديرات انبعاثات الرحلات الجوية
تقديرات انبعاثات الكربون في الرحلات الجوية هي تقديرات لانبعاثات الغازات الدفيئة الناتجة عن كل مسافر يسافر على متن رحلة جوية معيّنة.
تتوفّر واجهة برمجة التطبيقات هذه للرحلات الجوية التجارية في جميع أنحاء العالم التي تغادر خلال الأشهر الـ 11 القادمة. لا تتوفّر الرحلات الجوية المستأجرة والرحلات الجوية الخاصة ورحلات الشحن. الرحلات الجوية السابقة غير متاحة.
بيانات مستوى الانبعاثات العادي في الرحلات الجوية
"مستوى الانبعاثات العادي في الرحلات الجوية" هو تقديرات لانبعاثات الغازات الدفيئة الناتجة عن كل راكب يسافر جوًا بين مطارَين.
ويتم احتسابها باستخدام بيانات تقديرات انبعاثات الرحلات الجوية، ويتم نشر المنهجية التي يتم من خلالها إنشاء مجموعة البيانات هذه على GitHub. يجب عدم استخدام مستوى الانبعاثات العادي للرحلات الجوية كبديل لتقديرات انبعاثات الرحلات الجوية.
بيانات انبعاثات الرحلات الجوية من النطاق 3
تم تصميم مجموعة بيانات "انبعاثات الرحلات الجوية في النطاق 3" لمساعدة الشركات والأفراد في احتساب انبعاثات السفر الجوي في النطاق 3، الفئة 6 الناتجة عن السفر لأغراض العمل والإبلاغ عنها. تشمل نتائج النموذج الكاملة تقديرات الانبعاثات من عام 2019 للرحلات الجوية التجارية المجدوَلة في جميع أنحاء العالم.
بيانات تقديرات الانبعاثات التفصيلية من الرحلات الجوية
"تفاصيل الانبعاثات الناتجة من الرحلات الجوية" هي تقديرات شفافة للانبعاثات الناتجة عن الغازات الدفيئة لكل راكب، ويتم استكمالها ببيانات وصفية شاملة توضّح منهجية الحساب وتفاصيل الانبعاثات وتأثير مسارات التكاثف ومصدر البيانات.
تتيح واجهة برمجة التطبيقات هذه البحث عن الرحلات الجوية التجارية في جميع أنحاء العالم التي ستغادر خلال الأشهر الـ 11 المقبلة. الرحلات الجوية المستأجرة والرحلات الجوية الخاصة ورحلات نقل البضائع غير متاحة. لا يمكن البحث عن رحلات جوية سابقة.
دعم عملاء MCP
تتوافق واجهة برمجة التطبيقات Travel Impact Model API مع بروتوكول Model Context Protocol (MCP). يمكن لوكلاء الذكاء الاصطناعي والنماذج اللغوية الكبيرة استخدام نقطة نهاية MCP للتعرّف على إمكانات واجهة برمجة التطبيقات واستخدامها بشكل ديناميكي.
لمعرفة تفاصيل حول كيفية استخدام نقطة نهاية 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} } ] }'
يتضمّن المثال رحلة جوية من زيورخ إلى بوسطن مع توقّف مؤقّت في باريس، ورحلة جوية من زيورخ إلى بوسطن.
يطلب الأمر النموذجي نقطة نهاية REST باستخدام curl. في الأمر، عليك استبدال $API_KEY بمفتاح واجهة برمجة التطبيقات. قد تحتاج أيضًا إلى تعديل تفاصيل الرحلة الجوية لتتطابق مع رحلة جوية مقبلة حالية.
يُرجى الاطّلاع على علامة التبويب "المراجع" للاطّلاع على المستندات الكاملة للموارد التي تعرضها واجهة برمجة التطبيقات هذه. يمكن استخدام طلبات 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" }, ] }'
يتضمّن المثال سوقَين هما ZRH-BOS وBOS-ZRH.
يطلب الأمر النموذجي نقطة نهاية REST باستخدام curl. في الأمر، عليك استبدال $API_KEY بمفتاح واجهة برمجة التطبيقات.
يُرجى الاطّلاع على علامة التبويب "المراجع" للاطّلاع على المستندات الكاملة للموارد التي تعرضها واجهة برمجة التطبيقات هذه. يمكن استخدام طلبات HTTP و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" } }
نموذج إجابة.
مثال على انبعاثات الرحلات الجوية من النطاق 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 على درجة رجال الأعمال، وطلب انبعاثات مستندًا إلى المسافة لرحلة جوية تبلغ مسافتها 1,000 كيلومتر على الدرجة الأولى.
يطلب الأمر النموذجي نقطة نهاية REST باستخدام curl. في الأمر، عليك استبدال $API_KEY بمفتاح واجهة برمجة التطبيقات.
يُرجى الاطّلاع على علامة التبويب "المراجع" للاطّلاع على المستندات الكاملة للموارد التي تعرضها واجهة برمجة التطبيقات هذه. يمكن استخدام طلبات 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 } }
نموذج إجابة.
مثال على الانبعاثات التفصيلية الناتجة عن الرحلات الجوية
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} } ] }'
يتضمّن المثال رحلة جوية واحدة من زيورخ إلى بوسطن (ZRH - BOS).
يستدعي أمر المثال نقطة نهاية REST باستخدام أداة curl. في الأمر، عليك استبدال $API_KEY بمفتاح واجهة برمجة التطبيقات. قد تحتاج أيضًا إلى تعديل تفاصيل الرحلة الجوية لتتطابق مع رحلة جوية مقبلة حالية.
يُرجى الانتقال إلى علامة التبويب "مرجع" للاطّلاع على المستندات الكاملة للموارد التي تعرضها واجهة برمجة التطبيقات هذه. يمكنك استخدام طلبات HTTP و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" } }
نموذج إجابة.