Method: flights.computeDetailedFlightEmissions

אחזור של אומדני פליטות מפורטים.

נתוני פליטות מפורטים של טיסות הם אומדנים שקופים של פליטות גזי חממה לכל נוסע, בתוספת מטא-נתונים מקיפים שמפרטים את מתודולוגיית החישוב, פירוט הפליטות, השפעת פסי ההתעבות ומקור הנתונים.

פרטים על אופן החישוב של אומדני הפליטות מופיעים ב-GitHub.

התשובה תכיל את כל הערכים שתואמים לקטעי הטיסה שהוזנו, באותו סדר. אם אין אומדנים זמינים לקטע טיסה מסוים, התגובה תחזיר את אובייקט קטע הטיסה עם שדות פליטה ריקים. הבקשה עדיין תיחשב כבקשה שהושלמה בהצלחה. הסיבות לכך שאומדני הפליטות לא מוצגים כוללות:

  • הטיסה לא מוכרת לשרת.
  • חסר מזהה אחד או יותר בקטע הטיסה של הקלט.
  • תאריך הטיסה חל בעבר.
  • המודל לא תומך בסוג המטוס.
  • חסרה הגדרת עמדה.

הבקשה יכולה להכיל עד 100 קטעי טיסה. אם הבקשה כוללת יותר מ-100 מקטעי טיסה, היא תיכשל עם השגיאה INVALID_ARGUMENT.

בקשת HTTP

POST https://travelimpactmodel.googleapis.com/v1/flights:computeDetailedFlightEmissions

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "flights": [
    {
      object (Flight)
    }
  ]
}
שדות
flights[]

object (Flight)

חובה. טיסות ישירות להערכת פליטות שנגרמות על ידי טיסות חזרה.

גוף התשובה

הגדרת הפלט של התשובה flights.computeDetailedFlightEmissions.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "flightsWithDetailedEmissions": [
    {
      object (FlightWithDetailedEmissions)
    }
  ],
  "modelVersion": {
    object (ModelVersion)
  }
}
שדות
flightsWithDetailedEmissions[]

object (FlightWithDetailedEmissions)

רשימה של מקטעי טיסה עם הערכות של פליטות.
modelVersion

object (ModelVersion)

גרסת המודל שבאמצעותה חושבו אומדני הפליטות של כל הטיסות בתשובה הזו.

FlightWithDetailedEmissions

טיסה ישירה עם פרטים על אומדני הפליטות.

ייצוג ב-JSON 
{
  "flight": {
    object (Flight)
  },
  "flightEmissionsDetails": {
    object (FlightEmissionsDetails)
  },
  "emissionsMetadata": {
    object (EmissionsMetadata)
  }
}
שדות
flight

object (Flight)

פלט בלבד. תואם למזהי הטיסות בבקשה. הערה: כל קודי ה-IATA הם באותיות רישיות.
flightEmissionsDetails

object (FlightEmissionsDetails)

פלט בלבד. כל נתוני הפליטות של הטיסה.
emissionsMetadata

object (EmissionsMetadata)

פלט בלבד. מטא נתונים נוספים על חישוב פליטות מטיסות.

FlightEmissionsDetails

פרטים על הפליטות של הטיסה הספציפית.

ייצוג ב-JSON 
{
  "emissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "emissionsBreakdown": {
    object (EmissionsBreakdown)
  },
  "contrailsImpactBucket": enum (ContrailsImpactBucket),
  "source": enum (Source)
}
שדות
emissionsGramsPerPax

object (EmissionsGramsPerPax)

פלט בלבד. מספרים של הערכות פליטה לכל נוסע. העמודה לא תופיע אם לא ניתן לחשב את פליטת הפחמן. רשימת הסיבות לכך שלא ניתן לחשב את פליטת הפחמן מופיעה במאמר flights.computeDetailedFlightEmissions
emissionsBreakdown

object (EmissionsBreakdown)

פלט בלבד. פרטים על חלקי הפליטות השונים של הערך הכולל של פליטות הגז (GramsPerPax). הערך של סכום הפירוטים תמיד צריך להיות שווה לערך של emissionsGramsPerPax.
contrailsImpactBucket

enum (ContrailsImpactBucket)

פלט בלבד. המשמעות של השפעת ההתחממות של פסי ההתעבות בהשוואה להשפעה הכוללת של פליטות CO2e.
source

enum (Source)

פלט בלבד. המקור של נתוני הפליטות.

EmissionsBreakdown

פרטים על חלקי הפליטות השונים של הערך הכולל של פליטות הגז (GramsPerPax). הערך של סכום הפירוטים תמיד צריך להיות שווה לערך של emissionsGramsPerPax.

ייצוג ב-JSON 
{
  "wttEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  },
  "ttwEmissionsGramsPerPax": {
    object (EmissionsGramsPerPax)
  }
}
שדות
wttEmissionsGramsPerPax

object (EmissionsGramsPerPax)

מספרים של הערכות פליטה מתהליך הייצור ועד התדלוק (well-to-tank) לכל נוסע. העמודה לא תופיע אם לא ניתן לחשב את פליטת הפחמן. רשימת הסיבות לכך שלא ניתן לחשב את פליטת הפחמן מופיעה במאמר flights.computeFlightEmissions.
ttwEmissionsGramsPerPax

object (EmissionsGramsPerPax)

מספרים של הערכות פליטה ממיכל הדלק ועד לזנב המטוס לכל נוסע. העמודה לא תופיע אם לא ניתן לחשב את פליטת הפחמן. רשימת הסיבות לכך שלא ניתן לחשב את פליטת הפחמן מופיעה במאמר flights.computeFlightEmissions.

EmissionsMetadata

כל המטא-נתונים הנוספים.

ייצוג ב-JSON 
{
  "emissionsProvenance": {
    object (EmissionsProvenance)
  },
  "easaLabelMetadata": {
    object (EasaLabelMetadata)
  },
  "timWebsiteEmissionsCalculatorUrl": string
}
שדות
emissionsProvenance

object (EmissionsProvenance)

פלט בלבד. פרטים על מקור הנתונים שמשמשים לחישוב נתוני הפליטות, כולל הגורמים התורמים ומקורות הנתונים שלהם.
easaLabelMetadata

object (EasaLabelMetadata)

פלט בלבד. מטא-נתונים על EASA Flight Emissions Label (תווית פליטות הטיסה של הסוכנות האירופית לבטיחות תעופה). הערך מוגדר רק אם מקור נתוני הפליטות הוא EASA.
timWebsiteEmissionsCalculatorUrl

string

פלט בלבד. קישור לאתר של travelimpactmodel.org מחשבון פליטת הפחמן. דוגמה: https://travelimpactmodel.org/lookup/flight?itinerary=ZRH-BOS-LX-52-20261225.

EmissionsProvenance

מידע על מקור הנתונים שמשמשים לחישוב אומדני הפליטות, כולל גורמים תורמים ומקורות הנתונים שלהם.

ייצוג ב-JSON 
{
  "provenanceEntries": [
    {
      object (EmissionsProvenance.EmissionsProvenanceEntry)
    }
  ]
}
שדות
provenanceEntries[]

object (EmissionsProvenance.EmissionsProvenanceEntry)

פלט בלבד. כל הגורמים התורמים שמשמשים לחישוב הפליטות.

EmissionsProvenance.EmissionsProvenanceEntry

פרטים על גורם יחיד שמשפיע על חישובי הפליטות.

ייצוג ב-JSON 
{
  "provenanceEntryType": enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType),
  "source": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource),
  "sourceVersion": string,
  "dataCategory": enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory),

  // Union field data_strategy can be only one of the following:
  "fuelBurnEeaStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy),
  "loadFactorsT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy),
  "loadFactorsChAviationStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy),
  "cargoMassFractionT100Strategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy),
  "seatAreaRatioIataStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy),
  "distanceAdjustmentStrategy": enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)
  // End of list of possible types for union field data_strategy.

  // Union field data_value can be only one of the following:
  "loadFactorsData": number,
  "cargoMassFractionData": number,
  "seatAreaRatioData": {
    object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)
  },
  "estimatedFlightDistanceKm": integer
  // End of list of possible types for union field data_value.
}
שדות
provenanceEntryType

enum (EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType)

פלט בלבד. סוג רשומת המקור.
source

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataSource)

פלט בלבד. מקור הנתונים.
sourceVersion

string

פלט בלבד. הגרסה של נתוני המקור. לדוגמה, ‎2025/04.
dataCategory

enum (EmissionsProvenance.EmissionsProvenanceEntry.DataCategory)

פלט בלבד. קטגוריית הנתונים של מקור הנתונים.
שדה איחוד data_strategy. האסטרטגיה שמשמשת לחישוב הפליטות של מקור הנתונים הנתון. קבוצת השדות תתאים לסוג data_source. הערך data_strategy יכול להיות רק אחד מהבאים:
fuelBurnEeaStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy)

פלט בלבד. אסטרטגיה לחישוב שריפת דלק באזור הכלכלי האירופי.
loadFactorsT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy)

פלט בלבד. אסטרטגיה לגבי גורמי עומס T100.
loadFactorsChAviationStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy)

פלט בלבד. אסטרטגיה לגבי גורמי עומס של CH Aviation.
cargoMassFractionT100Strategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy)

פלט בלבד. אסטרטגיה לחישוב החלק היחסי של מסת המטען ב-T100.
seatAreaRatioIataStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy)

פלט בלבד. אסטרטגיה ליחסי שטחי מושבים לפי IATA.
distanceAdjustmentStrategy

enum (EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy)

פלט בלבד. אסטרטגיה להתאמת המרחק.
שדה איחוד data_value. ערך הנתונים של מקור הנתונים הנתון. השדה יתאים ל-provenance_entry_type. הערך data_value יכול להיות רק אחד מהבאים:
loadFactorsData

number

פלט בלבד. ערך הנתונים של גורמי העומס. אם לא מוגדר, ערך גורמי העומס לא זמין.
cargoMassFractionData

number

פלט בלבד. ערך של חלק המסה של המטען. אם לא מוגדר ערך, ערך מסת המטען לא זמין.
seatAreaRatioData

object (EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioData)

פלט בלבד. הערך של יחס שטח המושב לכל מחלקה. אם לא מוגדר, ערך היחס בין שטח המושב לא זמין.
estimatedFlightDistanceKm

integer

פלט בלבד. המרחק המשוער של הטיסה בשלב הטיסה של CCD, בערך קילומטרים, שמחושב באמצעות מקדם התאמת המרחק (DAF). אם לא מגדירים את המדיניות הזו, ערך המרחק המשוער של הטיסה לא זמין.

EmissionsProvenance.EmissionsProvenanceEntry.EmissionsProvenanceEntryType

סוג רשומת המקור. יכול להיות שבעתיד נוסיף ערכים חדשים. לקוחות צריכים להיות מוכנים לטפל בערכי enum לא ידועים בצורה חלקה.

טיפוסים בני מנייה (enum)
EMISSIONS_PROVENANCE_ENTRY_TYPE_UNSPECIFIED סוג רשומת המקור לא צוין.
FUEL_BURN סוג הרשומה של צריכת הדלק.
LOAD_FACTORS סוג הרשומה של גורמי העומס.
CARGO_MASS_FRACTION סוג הרשומה של חלק המסה של המטען.
SEATING_CONFIG סוג הרשומה של תצורת מקומות הישיבה.
SEAT_AREA_RATIOS סוג הרשומה של יחסי שטח המושב.
DISTANCE_ADJUSTMENT סוג רשומה של התאמת מרחק.

EmissionsProvenance.EmissionsProvenanceEntry.DataSource

המקור של נתוני הגורמים שמשפיעים על אומדני הפליטות. יכול להיות שבעתיד נוסיף ערכים חדשים. לקוחות צריכים להיות מוכנים לטפל בערכי enum לא ידועים בצורה חלקה.

טיפוסים בני מנייה (enum)
DATA_SOURCE_UNSPECIFIED לא צוין מקור נתונים.
EEA הנתונים סופקו על ידי European Environment Agency (הסוכנות האירופית לאיכות הסביבה, EEA).
T100 נתונים ממערך הנתונים T-100, שסופק על ידי המשרד לנתונים סטטיסטיים של ענף התחבורה בארה"ב.
CH_AVIATION הנתונים סופקו על ידי ch-aviation.
OAG הנתונים סופקו על ידי Official Aviation Guide ‏ (OAG).
OPERATING_CARRIER הנתונים סופקו על ידי חברת התעופה המפעילה.
AIRCRAFT_MODEL_TYPICAL נתונים אופייניים שמבוססים על דגם המטוס.
GLOBAL_DEFAULT ערך כללי לברירת מחדל, שמשמש כשאין מקור נתונים אחר זמין.
IATA הנתונים מסופקים על ידי International Air Transport Association ‏ (IATA, התאחדות התובלה האווירית הבינלאומית).
ICL הנתונים סופקו על ידי Imperial College London.

EmissionsProvenance.EmissionsProvenanceEntry.FuelBurnEea.Strategy

אסטרטגיה לחישוב שריפת דלק באזור הכלכלי האירופי. יכול להיות שבעתיד נוסיף ערכים חדשים. לקוחות צריכים להיות מוכנים לטפל בערכי enum לא ידועים בצורה חלקה.

טיפוסים בני מנייה (enum)
STRATEGY_UNSPECIFIED לא צוינה אסטרטגיה.
AIRCRAFT_MAPPING_FALLBACK_WITH_CORRECTION_FACTOR הוחל פקטור תיקון סטטי.
AIRCRAFT_MAPPING_EXACT נעשה שימוש במיפוי מדויק של כלי הטיס.
AIRCRAFT_MAPPING_FALLBACK נעשה שימוש במיפוי חלופי של כלי טיס.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsT100.Strategy

אסטרטגיה לגבי גורמי עומס T100. יכול להיות שבעתיד נוסיף ערכים חדשים. לקוחות צריכים להיות מוכנים לטפל בערכי enum לא ידועים בצורה חלקה.

טיפוסים בני מנייה (enum)
STRATEGY_UNSPECIFIED לא צוינה אסטרטגיה.
CARRIER_ROUTE_MONTH נתונים לפי חברת תובלה, מסלול וחודש הנסיעה.
CARRIER_MONTH נתונים לפי חברת תובלה וחודש הנסיעה.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH נתונים היסטוריים שתואמים לחברת התעופה, למסלול, לשנה ולחודש.

EmissionsProvenance.EmissionsProvenanceEntry.LoadFactorsChAviation.Strategy

אסטרטגיה לגבי גורמי עומס של CH-Aviation. יכול להיות שבעתיד נוסיף ערכים חדשים. לקוחות צריכים להיות מוכנים לטפל בערכי enum לא ידועים בצורה חלקה.

טיפוסים בני מנייה (enum)
STRATEGY_UNSPECIFIED לא צוינה אסטרטגיה.
CARRIER_MONTH נתונים לפי חברת תובלה וחודש הנסיעה.
ACTUAL_CARRIER_YEAR_MONTH נתונים היסטוריים שתואמים לספק הסלולר, לשנה ולחודש.

EmissionsProvenance.EmissionsProvenanceEntry.CargoMassFractionT100.Strategy

אסטרטגיה לחישוב החלק היחסי של מסת המטען ב-T100. יכול להיות שבעתיד נוסיף ערכים חדשים. לקוחות צריכים להיות מוכנים לטפל בערכי enum לא ידועים בצורה חלקה.

טיפוסים בני מנייה (enum)
STRATEGY_UNSPECIFIED לא צוינה אסטרטגיה.
CARRIER_ROUTE_AIRCRAFT_CLASS נתונים לפי חברת תובלה, מסלול ומחלקה במטוס.
ROUTE_AIRCRAFT_CLASS נתונים לפי מסלול ומחלקה במטוס.
DISTANCE_AIRCRAFT_CLASS נתונים לפי טווח מרחק וסוג מטוס.
ACTUAL_CARRIER_ROUTE_YEAR_MONTH_AIRCRAFT_CLASS נתונים היסטוריים שתואמים לחברת התעופה, למסלול, לשנה, לחודש ולמחלקה במטוס.

EmissionsProvenance.EmissionsProvenanceEntry.SeatAreaRatioIata.Strategy

אסטרטגיה ליחסי שטחי מושבים לפי IATA. יכול להיות שבעתיד נוסיף ערכים חדשים. לקוחות צריכים להיות מוכנים לטפל בערכי enum לא ידועים בצורה חלקה.

טיפוסים בני מנייה (enum)
STRATEGY_UNSPECIFIED לא צוינה אסטרטגיה.
NARROW_AIRCRAFT_BODY השתמשנו ביחסי שטח מושב למטוסים צרי גוף.
WIDE_AIRCRAFT_BODY השתמשנו ביחסי שטח המושב למטוסים רחבי גוף.

EmissionsProvenance.EmissionsProvenanceEntry.DistanceAdjustment.Strategy

אסטרטגיה להתאמת המרחק. יכול להיות שבעתיד נוסיף ערכים חדשים. לקוחות צריכים להיות מוכנים לטפל בערכי enum לא ידועים בצורה חלקה.

טיפוסים בני מנייה (enum)
STRATEGY_UNSPECIFIED לא צוינה אסטרטגיה.
ORIGIN_DESTINATION גורם התאמת המרחק שנקבע לפי זוג נמלי התעופה של המוצא והיעד.
COUNTRY_PAIR גורם התאמת המרחק נקבע לפי צמד המדינות של נקודת המוצא והיעד.
DEFAULT גורם ההתאמה למרחק מבוסס על ערך ברירת המחדל, כי לא מצאנו גורם התאמה ספציפי לשדה תעופה או למדינה.

EmissionsProvenance.EmissionsProvenanceEntry.DataCategory

קטגוריית הנתונים של מקור הנתונים. יכול להיות שבעתיד נוסיף ערכים חדשים. לקוחות צריכים להיות מוכנים לטפל בערכי enum לא ידועים בצורה חלקה.

טיפוסים בני מנייה (enum)
DATA_CATEGORY_UNSPECIFIED לא צוינה קטגוריית נתונים.
PRIMARY נתונים ראשוניים, כפי שמוגדרים בתקן ISO 14083.
MODELED נתונים לפי מודל, כפי שמוגדר בתקן ISO 14083.
DEFAULT נתוני ערך ברירת המחדל, כפי שמוגדר בתקן ISO 14083.