API مدل تأثیر سفر، تخمین‌های انتشار گازهای گلخانه‌ای محاسبه‌شده بر اساس مدل تأثیر سفر را نمایش می‌دهد. این تخمین‌های انتشار گازهای گلخانه‌ای همچنین در Google Flights نشان داده می‌شوند و دسترسی به API از طریق افزونه Google Sheets نیز امکان‌پذیر است.

این API عمومی و رایگان است.

برای احراز هویت، به یک کلید API نیاز خواهید داشت.

داده‌های افشا شده توسط این API تحت مجوز CC BY-SA 4.0 است.

مدل تأثیر سفر، یک مدل تخمین انتشار گازهای گلخانه‌ای پیشرفته برای پروازها است.

این روش در GitHub منتشر شده است.

در صورت داشتن هرگونه سوال و درخواست ویژگی، لطفاً با ما تماس بگیرید (به صفحه پشتیبانی مراجعه کنید).

انتشار گازهای گلخانه‌ای در پرواز، تخمینی از میزان انتشار گازهای گلخانه‌ای تولید شده به ازای هر مسافر در یک پرواز خاص است.

این API از پروازهای تجاری جهانی که در ۱۱ ماه آینده انجام می‌شوند پشتیبانی می‌کند. پروازهای چارتر، پروازهای خصوصی و پروازهای باری پشتیبانی نمی‌شوند. پروازهای گذشته پشتیبانی نمی‌شوند.

انتشارات معمولی پرواز تخمینی از انتشار گازهای گلخانه ای تولید شده به ازای هر مسافری است که از طریق هوا بین دو فرودگاه سفر می کند.

با استفاده از داده‌های برآورد انتشار پرواز محاسبه می‌شود و روش‌شناسی نحوه ایجاد آن مجموعه داده در GitHub منتشر می‌شود. انتشار گازهای گلخانه ای معمولی نباید به عنوان جایگزینی برای تخمین های انتشار گازهای گلخانه ای پرواز استفاده شود.

مجموعه داده‌های انتشارات پرواز Scope 3 برای کمک به شرکت‌ها و افراد برای محاسبه و گزارش انتشارات Scope 3، رده 6 در سفرهای هوایی از سفرهای کاری طراحی شده است. خروجی کامل مدل شامل برآوردهای انتشار گازهای گلخانه ای از سال 2019 برای پروازهای تجاری برنامه ریزی شده در سراسر جهان است.

انتشار گازهای گلخانه‌ای دقیق پرواز، تخمین‌های شفافی از میزان انتشار گازهای گلخانه‌ای به ازای هر مسافر هستند که با فراداده‌های جامعی که روش محاسبه، تفکیک انتشار گازهای گلخانه‌ای، تأثیر پسدمه‌ها و منشأ داده‌ها را شرح می‌دهند، تکمیل می‌شوند.

این API از پروازهای تجاری جهانی که در ۱۱ ماه آینده انجام می‌شوند پشتیبانی می‌کند. پروازهای چارتر، پروازهای خصوصی و پروازهای باری پشتیبانی نمی‌شوند. پروازهای گذشته پشتیبانی نمی‌شوند.

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"
    },
  ]
}'

این مثال شامل دو بازار ZRH-BOS و BOS-ZRH است.

دستور مثال، نقطه پایانی REST را با استفاده از curl فراخوانی می‌کند. در این دستور، باید $API_KEY با کلید API خود جایگزین کنید.

لطفاً برای مشاهده مستندات کامل منابع در معرض این API، به برگه مرجع مراجعه کنید. هر دو فراخوانی 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"
  }
}

نمونه پاسخ

نمونه انتشارات پرواز 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
  }
}

نمونه پاسخ

مثال دقیق انتشار گازهای گلخانه‌ای پرواز را دریافت کنید

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 با کلید API خود جایگزین کنید. همچنین ممکن است لازم باشد جزئیات پرواز را برای مطابقت با یک پرواز آینده موجود تنظیم کنید.

لطفاً برای مشاهده مستندات کامل منابع در معرض این API، به برگه مرجع مراجعه کنید. هر دو فراخوانی 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"
  }
}

نمونه پاسخ