- درخواست HTTP
- درخواست بدن
- بدن پاسخگو
- پرواز
- تاریخ
- FlightWithEmissions
- EmissionsGramsPerPax
- ModelVersion
- آن را امتحان کنید!
روش بدون تابعیت برای بازیابی برآوردهای انتشار جزئیات در مورد نحوه محاسبه برآوردهای انتشار: https://github.com/google/travel-impact-model
پاسخ شامل تمام ورودیهایی است که با پایههای پرواز ورودی مطابقت دارند، به همان ترتیب. اگر هیچ تخمینی برای یک پرواز مشخص وجود نداشته باشد، پاسخ جسم پای پرواز را با میدانهای انتشار خالی برمیگرداند. درخواست همچنان موفق تلقی خواهد شد. دلایل عدم برآورد انتشار عبارتند از:
- پرواز برای سرور ناشناخته است.
- پای پرواز ورودی یک یا چند شناسه ندارد.
- تاریخ پرواز در گذشته است.
- نوع هواپیما توسط مدل پشتیبانی نمی شود.
- پیکربندی صندلی وجود ندارد.
این درخواست میتواند تا 1000 پای پرواز داشته باشد. اگر درخواست بیش از 1000 پرواز مستقیم داشته باشد، اگر با خطای INVALID_ARGUMENT ناموفق خواهد بود.
درخواست HTTP
POST https://travelimpactmodel.googleapis.com/v1/flights:computeFlightEmissions
URL از دستور GRPC Transcoding استفاده می کند.
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"flights": [
{
object ( |
زمینه های | |
---|---|
flights[] | ضروری. پروازهای مستقیم به بازگشت تخمین آلاینده برای. |
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
تعریف خروجی برای پاسخ [flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions].
نمایندگی JSON |
---|
{ "flightEmissions": [ { object ( |
زمینه های | |
---|---|
flightEmissions[] | فهرست پاهای پرواز با برآورد انتشار. |
modelVersion | نسخه مدلی که بر اساس آن برآورد انتشار برای همه پروازها در این پاسخ محاسبه شد. |
پرواز
تمام جزئیات مربوط به یک مورد درخواستی برای برآورد انتشار مستقیم پرواز.
نمایندگی JSON |
---|
{
"origin": string,
"destination": string,
"operatingCarrierCode": string,
"flightNumber": integer,
"departureDate": {
object ( |
زمینه های | |
---|---|
origin | ضروری. کد فرودگاه یاتا برای مبدا پرواز، به عنوان مثال "LHR". |
destination | ضروری. کد فرودگاه یاتا برای مقصد پرواز، به عنوان مثال "JFK". |
operatingCarrierCode | ضروری. کد حامل یاتا، به عنوان مثال "AA". |
flightNumber | ضروری. شماره پرواز، به عنوان مثال 324. |
departureDate | ضروری. تاریخ پرواز در منطقه زمانی فرودگاه مبدا. باید تاریخی در حال یا آینده باشد. |
تاریخ
نمایانگر یک تاریخ تقویم کامل یا جزئی، مانند روز تولد است. زمان روز و منطقه زمانی یا در جای دیگری مشخص شده است یا ناچیز است. تاریخ نسبت به تقویم میلادی است. این می تواند نشان دهنده یکی از موارد زیر باشد:
- تاریخ کامل، با مقادیر سال، ماه و روز غیر صفر.
- یک ماه و روز، با یک سال صفر (مثلاً یک سالگرد).
- یک سال به تنهایی، با یک ماه صفر و یک روز صفر.
- یک سال و یک ماه، با روز صفر (مثلاً تاریخ انقضای کارت اعتباری).
انواع مرتبط:
-
google.type.TimeOfDay
-
google.type.DateTime
-
google.protobuf.Timestamp
نمایندگی JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
زمینه های | |
---|---|
year | سال تاریخ. برای تعیین تاریخ بدون سال باید از 1 تا 9999 یا 0 باشد. |
month | ماه از یک سال. باید از 1 تا 12 یا 0 باشد تا یک سال بدون ماه و روز مشخص شود. |
day | روز یک ماه. باید از 1 تا 31 باشد و برای سال و ماه معتبر باشد، یا 0 برای مشخص کردن یک سال به تنهایی یا یک سال و ماهی که در آن روز مهم نیست، معتبر باشد. |
FlightWithEmissions
پرواز مستقیم با تخمین آلایندگی
نمایندگی JSON |
---|
{ "flight": { object ( |
زمینه های | |
---|---|
flight | ضروری. با شناسه های پرواز در درخواست مطابقت دارد. توجه: تمام کدهای یاتا با حروف بزرگ نوشته شده اند. |
emissionsGramsPerPax | اختیاری. اعداد برآورد انتشار گازهای گلخانه ای به ازای هر مسافر اگر انتشار گازهای گلخانه ای قابل محاسبه نباشد، وجود نخواهد داشت. برای فهرست دلایلی که چرا انتشارات را نمی توان محاسبه کرد، به [flights.computeFlightEmissions][google.travel.sustainability.travelimpactmodel.v1.ComputeFlightEmissions] مراجعه کنید. |
EmissionsGramsPerPax
نتایج گروه بندی انتشار گازهای گلخانه ای به ازای هر کلاس صندلی.
نمایندگی JSON |
---|
{ "first": integer, "business": integer, "premiumEconomy": integer, "economy": integer } |
زمینه های | |
---|---|
first | انتشار گازهای گلخانه ای برای یک مسافر در درجه یک بر حسب گرم. این فیلد همیشه محاسبه و پر می شود، صرف نظر از اینکه هواپیما صندلی های درجه یک دارد یا خیر. |
business | انتشار گازهای گلخانه ای برای یک مسافر در کلاس تجاری بر حسب گرم. این فیلد همیشه محاسبه و پر می شود، صرف نظر از اینکه هواپیما صندلی های کلاس تجاری دارد یا خیر. |
premiumEconomy | آلایندگی برای یک مسافر در کلاس اقتصادی ممتاز بر حسب گرم. این فیلد همیشه محاسبه و پر می شود، صرف نظر از اینکه هواپیما دارای صندلی های کلاس اکونومی ممتاز است یا خیر. |
economy | انتشار گازهای گلخانه ای برای یک مسافر در کلاس اقتصادی بر حسب گرم. این فیلد همیشه محاسبه و پر می شود، صرف نظر از اینکه هواپیما صندلی های کلاس اقتصادی دارد یا خیر. |
ModelVersion
نسخه Travel Impact Model. برای اطلاعات بیشتر در مورد نسخهسازی مدل به https://github.com/google/travel-impact-model/#versioning مراجعه کنید.
نمایندگی JSON |
---|
{ "major": integer, "minor": integer, "patch": integer, "dated": string } |
زمینه های | |
---|---|
major | نسخه های اصلی: تغییرات عمده در روش (مانند افزودن منابع داده جدید به مدل که منجر به تغییرات عمده خروجی می شود). چنین تغییراتی نادر خواهد بود و از قبل اعلام می شود. ممکن است شامل تغییرات نسخه API باشد که به دستورالعملهای موجود در https://cloud.google.com/endpoints/docs/openapi/versioning-an-api#backwards-incompatible احترام میگذارد. |
minor | نسخههای جزئی: تغییراتی در مدلی که در عین اینکه در نسخههای طرحواره سازگار است، پارامترهای مدل یا پیادهسازی را تغییر میدهد. |
patch | نسخههای وصله: تغییرات پیادهسازی به منظور رفع اشکال یا عدم دقت در اجرای مدل. |
dated | نسخههای دارای تاریخ: مجموعه دادههای مدل با دادههای ورودی تازهسازیشده، اما هیچ تغییری در الگوریتمها بهطور منظم ایجاد میشوند. |