خوراک برنامه سفر حاوی اطلاعات قایقرانی کروز است. هر برنامه سفر دارای مجموعه ای از سفرها است. هر سفر شامل جزئیات سفر از قبیل بنادر، زمان و تاریخ ورود و خروج، مدت زمان کشتی در هر مرحله از سفر و شرح هر سفر است. می توانید فیدهای برنامه سفر را در قالب CSV آپلود کنید.
اجزای کلیدی
فید برنامه سفر دارای فیلدهای ضروری است که به حروف بزرگ و کوچک حساس نیستند. برخی از فیلدها اختیاری هستند و ممکن است خالی باقی بمانند. ارسال داده های اختیاری کیفیت داده ها را بهبود می بخشد.
دارای فیلدهای اجباری زیر است:
-
sail_id: یک شناسه قایقرانی منحصر به فرد برای یک سفر خاص. stop_index: یک شناسه توقف منحصر به فرد برای هر پورت خروج.port_of_call: بندر مکالمه یا مکانی که کشتی در آن توقف می کند.itinerary_desc: شرح برنامه سفر.arrival_dt: تاریخ و زمان رسیدن در ساعت جهانی هماهنگ بندر (UTC).departure_dt: تاریخ و زمان حرکت در ساعت جهانی هماهنگ بندر (UTC).ship_name: نام کشتی.sail_duration: مدت یا تعداد روزهای کشتیرانی.
فیلدها
جدول زیر تمام فیلدهای موجود در فید برنامه سفر را توضیح می دهد:
| نام فیلد | مورد نیاز؟ | تایپ کنید | توضیحات |
|---|---|---|---|
| sail_id | Required | string | شناسه قایقرانی منحصر به فرد برای یک سفر خاص در برنامه سفر با تاریخ شروع و پایان. به عنوان مثال، برای یک برنامه سفر 5 شبه که 3 توقف دارد، توجه: |
| stop_index | Required | integer | شناسه شاخص منحصر به فرد برای هر توقف در برنامه سفر دریایی. برای اولین توقف با شاخص صفر شروع می شود. صفر نشان دهنده اولین پورت خروج است. به عنوان مثال، stop_index به صورت 0 نمایش داده می شود. توجه: |
| port_of_call | Required | string | مکان با نام شهر و کشوری که کشتی در آن متوقف می شود. به عنوان مثال، port_of_call را می توان به عنوان Venice,Italy نشان داد. نقل قول ( |
| itinerary_desc | Required | string | شرح برنامه سفر. با "X-night" شروع می شود که X تعداد شب های برنامه سفر است. به حروف کوچک و بزرگ حساس نیست. برای مثال، itinerary_desc میتواند 7-night greek isles & eastern med باشد. |
| arrival_dt | Required | datetime | تاریخ و زمان رسیدن در ساعت جهانی هماهنگ بندر (UTC). arrival_dt برای اولین پورت باید خالی و stop_index باید صفر باشد. برای مثال arrival_dt به صورت 2025-01-22T06:00:00+01:00 نشان داده می شود. |
| departure_dt | Required | datetime | تاریخ و زمان حرکت در ساعت جهانی هماهنگ بندر (UTC). departure_dt برای آخرین پورت باید خالی باشد. stop_index باید آخرین شب برنامه سفر باشد. برای مثال departure_dt به صورت 2025-01-23T18:00:00+01:00 نشان داده می شود. |
| ship_name | Required | string | نام کشتی. به حروف کوچک و بزرگ حساس نیست. برای مثال، ship_name را می توان به صورت NORWEGIAN Escape نشان داد. |
| sail_duration | Required | integer | مدت زمان سفر یا تعداد شب های قایقرانی. به عنوان مثال، برای 5 شب قایقرانی sail_duration به عنوان 5 نشان داده می شود. |
| itinerary_id | Required | string | مسیر سفر را مشخص می کند. itinerary_id سفرها را از یکدیگر متمایز می کند. همه سفرهایی که از یک درگاه تماس بازدید می کنند، itinerary_id یکسان دارند، که امکان گروه بندی و سازماندهی سفرها را فراهم می کند. به عنوان مثال، اگر بندر مکالمه از طریق سانفرانسیسکو برای دو برنامه سفر متفاوت باشد، شناسه سفر برای هر دو برنامه سفر یکسان است. به عنوان |
| latitude | Optional | decimal | عرض جغرافیایی این بندر مکالمه. باید در نماد WGS84 مشخص شود. این اطلاعات برای تعیین محل دقیق درگاه تماس مفید است. برای مثال، مختصات عرض جغرافیایی برای Trieste، ایتالیا 45.64665541364354 است. موارد زیر پشتیبانی نمی شوند:
|
| longitude | Optional | decimal | طول جغرافیایی این بندر مکالمه. باید در نماد WGS84 مشخص شود. این اطلاعات برای تعیین محل دقیق درگاه تماس مفید است. برای مثال، مختصات طول جغرافیایی برای Trieste، ایتالیا 13.76188003458354 است. موارد زیر پشتیبانی نمی شوند:
|
| image_url | Optional | URL | نشانی اینترنتی یک تصویر که نشان دهنده درگاه تماس است. برای مثال، https://partner.com/images/XXXXX.jpg |
| updated_at | Optional | datetime | تاریخ و زمانی که آخرین بار این مدخل در زمان هماهنگ جهانی (UTC) به روز شده است. این اطلاعات برای شناسایی داده های قدیمی مفید است. باید از فرمت ISO 8601 پیروی کند. برای مثال updated_at 2025-01-22T00:00:00+00:00 است. |
نمونه ها
در زیر یک مثال اساسی از خوراک برنامه سفر برای دو بادبان است که در آن یک بادبان یک سفر یک طرفه و دیگری یک سفر رفت و برگشت است.
نمونه ها هر دو فرمت CSV و JSON را نشان می دهند. فیلدهای sail_id ، stop_index به هم پیوسته اند تا کلید اولیه ترکیبی را تشکیل دهند و باید برای هر ردیف منحصر به فرد باشند.
CSV
سفر یک طرفه (الزامی)
اولین بادبان یا برنامه سفر یک طرفه از سانفرانسیسکو به کانادا به مدت 4 شب است. مثال زیر فقط فیلدهای اجباری را نشان می دهد:
sail_id; stop_index; port_of_call; itinerary_desc; arrival_dt; departure_dt;ship_name;sail_duration;itinerary_id
54321; 0; Seattle, Washington; 4 Night Alaska Cruise Trip; NULL;2025-05-23 15:00:00; Floating Home; 04; 888888
54321; 1; Ketchikan, Alaska; 4 Night Alaska Cruise Trip;2025-05-25 18:00:00; 2025-05-25 7:00:00; Floating Home; 04; 888888
54321; 2; Vancouver (Canada Place), British Columbia;4 Night Alaska Cruise Trip; 2025-05-27 7:30:00; NULL; Floating Home; 04; 888888
سفر یک طرفه (همه)
مثال زیر تمام زمینه های موجود برای یک سفر یک طرفه را نشان می دهد:
sail_id; stop_index; port_of_call; itinerary_desc; arrival_dt; departure_dt; ship_name;sail_duration; itinerary_id; latitude; longitude; image_url; updated_at
54321; 0; Seattle, Washington; 4 Night Alaska Cruise Trip; NULL; 2025-05-23 15:00:00; Floating Home;04; 888888; 47.608013; -122.335167; https://partner.com/images/XXXXX.jpg; 2025-05-23T00:00:00+00:00
54321; 1; Ketchikan, Alaska; 4 Night Alaska Cruise Trip; 2025-05-25 18:00:00; 2025-05-25 7:00:00;Floating Home; 04; 888888; 55.341808; -131.647507; https://partner.com/images/XXXXX.jpg; 2025-05-25T00:00:00+00:00
54321; 2; Vancouver (Canada Place), British Columbia; 4 Night Alaska Cruise Trip; 2025-05-27 7:30:00; NULL; Floating Home; 04; 888888; 49.246292; -123.116226; https://partner.com/images/XXXXX.jpg; 2025-05-27T00:00:00+00:00
رفت و برگشت (الزامی)
بادبان دوم یک سفر رفت و برگشت از سانفرانسیسکو است که آلاسکا و کانادا را به مدت 14 شب پوشش می دهد. مثال زیر فقط فیلدهای اجباری را نشان می دهد:
sail_id; stop_index; port_of_call; itinerary_desc; arrival_dt; departure_dt; ship_name;sail_duration; itinerary_id
12345; 0; San Francisco, California; 14 Night Alaska Cruise with Glacier Bay National Park; NULL;2025-06-06 16:00:00; Beautiful Ship; 14; 888888
12345; 1; Ketchikan, Alaska; 14 Night Alaska Cruise with Glacier Bay National Park; 2025-06-09 21:00:00; 2025-06-10 5:00:00; Beautiful Ship; 14; 888888
12345; 2; Vancouver (Canada Place), British Columbia; 14 Night Alaska Cruise with Glacier Bay National Park; 2025-06-13 14:00:00; 2025-06-14 20:00:00; Beautiful Ship; 14; 888888
12345; 3; Victoria, British Columbia; 14 Night Alaska Cruise with Glacier Bay National Park 2025-06-15 21:00:00; 2025-06-16 6:00:00; Beautiful Ship; 14; 888888
12345; 4; San Francisco, California; 14 Night Alaska Cruise with Glacier Bay National Park 2025-06-20 7:00:00; NULL; Beautiful Ship; 14; 888888
رفت و برگشت (همه)
مثال زیر تمام زمینه های موجود برای سفر رفت و برگشت را نشان می دهد:
sail_id; stop_index; port_of_call; itinerary_desc; arrival_dt; departure_dt; ship_name; sail_duration; itinerary_id; latitude; longitude; image_url; updated_at
12345; 0; San Francisco, California; 14 Night Alaska Cruise with Glacier Bay National Park; NULL; 2025-06-06 16:00:00; Beautiful Ship; 14; 888888; 37.773972; -122.431297; https://partner.com/images/XXXXX.jpg; 2025-06-06T00:00:00+00:00
12345; 1; Ketchikan, Alaska; 14 Night Alaska Cruise with Glacier Bay National Park; 2025-06-09 21:00:00; 2025-06-10 5:00:00; Beautiful Ship; 14; 888888; 55.341808; -131.647507; https://partner.com/images/XXXXX.jpg; 2025-06-09T00:00:00+00:00
12345; 2; Vancouver (Canada Place), British Columbia; 14 Night Alaska Cruise with Glacier Bay National Park; 2025-06-13 14:00:00; 2025-06-14 20:00:00; Beautiful Ship; 14; 888888; 49.246292; -123.116226; https://partner.com/images/XXXXX.jpg; 2025-06-13T00:00:00+00:00
12345; 3; Victoria, British Columbia; 14 Night Alaska Cruise with Glacier Bay National Park; 2025-06-15 21:00:00; 2025-06-16 6:00:00; Beautiful Ship; 14; 888888; 48.407326; -123.329773; https://partner.com/images/XXXXX.jpg; 2025-06-15T00:00:00+00:00
12345; 4; San Francisco, California; 14 Night Alaska Cruise with Glacier Bay National Park;2025-06-20 7:00:00; NULL; Beautiful Ship; 14; 888888; 37.773972; -122.431297; https://partner.com/images/XXXXX.jpg; 2025-06-20T00:00:00+00:00
JSON (برای اهداف اطلاعاتی)
سفر یک طرفه (الزامی)
اولین بادبان یا برنامه سفر یک طرفه از سانفرانسیسکو به کانادا به مدت 4 شب است. مثال زیر فقط فیلدهای اجباری را نشان می دهد:
[
{
"sail_id": "54321",
"stop_index": "0",
"port_of_call": "Seattle, Washington",
"itinerary_desc": "4 Night Alaska Cruise Trip",
"arrival_dt": null,
"departure_dt": "2025-05-23 15:00:00",
"ship_name": "Floating Home",
"sail_duration": 4,
"itinerary_id": "888888"
},
---
{
"sail_id": "54321",
"stop_index": "2",
"port_of_call": "Vancouver (Canada Place), British Columbia",
"itinerary_desc": "4 Night Alaska Cruise Trip",
"arrival_dt": "2025-05-27 7:30:00",
"departure_dt": null,
"ship_name": "Floating Home",
"sail_duration": 4,
"itinerary_id": "888888"
}
]
سفر یک طرفه (همه)
مثال زیر تمام زمینه های موجود برای سفر یک طرفه را نشان می دهد:
[
{
"sail_id": "54321",
"stop_index": "0",
"port_of_call": "Seattle, Washington",
"itinerary_desc": "4 Night Alaska Cruise Trip",
"arrival_dt": "2025-05-23 15:00:00",
"departure_dt": null,
"ship_name": "Floating Home",
"sail_duration": 4,
"itinerary_id": "888888",
"latitude": "47.608013",
"longitude": "-122.335167",
"image_url": "https://partner.com/images/XXXXX.jpg",
"updated_at": "2025-05-23T00:00:00+00:00"
},
---
{
"sail_id": "54321",
"stop_index": "2",
"port_of_call": "Vancouver (Canada Place), British Columbia",
"itinerary_desc": "4 Night Alaska Cruise Trip",
"arrival_dt": null,
"departure_dt": "2025-05-27 7:30:00",
"ship_name": "Floating Home",
"sail_duration": 4,
"itinerary_id": "888888",
"latitude": "49.246292",
"longitude": "-123.116226",
"image_url": "https://partner.com/images/XXXXX.jpg",
"updated_at": "2025-05-27T00:00:00+00:00"
}
]
رفت و برگشت (الزامی)
بادبان دوم یک سفر رفت و برگشت از سانفرانسیسکو است که آلاسکا و کانادا را به مدت 14 شب پوشش می دهد. مثال زیر فقط فیلدهای اجباری را نشان می دهد:
[
{
"sail_id": "12345",
"stop_index": "0",
"port_of_call": "San Francisco, California",
"itinerary_desc": "14 Night Alaska Cruise with Glacier Bay National Park",
"arrival_dt": null,
"departure_dt": "2025-06-06 16:00:00",
"ship_name": "Beautiful Ship",
"sail_duration": 14,
"itinerary_id": "888888"
},
{
"sail_id": "12345",
"stop_index": "1",
"port_of_call": "Ketchikan, Alaska",
"itinerary_desc": "14 Night Alaska Cruise with Glacier Bay National Park",
"arrival_dt": "2025-06-09 21:00:00",
"departure_dt": "2025-06-10 5:00:00",
"ship_name": "Beautiful Ship",
"sail_duration": 14,
"itinerary_id": "888888"
},
---
{
"sail_id": "12345",
"stop_index": "4",
"port_of_call": "San Francisco, California",
"itinerary_desc": "14 Night Alaska Cruise with Glacier Bay National Park",
"arrival_dt": "2025-06-20 7:00:00",
"departure_dt": null,
"ship_name": "Beautiful Ship",
"sail_duration": 14,
"itinerary_id": "888888"
}
]
رفت و برگشت (همه)
مثال زیر تمام زمینه های موجود برای سفر رفت و برگشت را نشان می دهد:
[
{
"sail_id": "12345",
"stop_index": "0",
"port_of_call": "San Francisco, California",
"itinerary_desc": "14 Night Alaska Cruise with Glacier Bay National Park",
"arrival_dt": null,
"departure_dt": "2025-06-06 16:00:00",
"ship_name": "Beautiful Ship",
"sail_duration": 14,
"itinerary_id": "888888",
"latitude": "37.773972",
"longitude": "-122.335167",
"image_url": "https://partner.com/images/XXXXX.jpg",
"updated_at": "2025-06-06T00:00:00+00:00"
},
{
"sail_id": "12345",
"stop_index": "1",
"port_of_call": "Ketchikan, Alaska",
"itinerary_desc": "14 Night Alaska Cruise with Glacier Bay National Park",
"arrival_dt": "2025-06-09 21:00:00",
"departure_dt": "2025-06-10 5:00:00",
"ship_name": "Beautiful Ship",
"sail_duration": 14,
"itinerary_id": "888888",
"latitude": "55.341808",
"longitude": "-131.647507",
"image_url": "https://partner.com/images/XXXXX.jpg",
"updated_at": "2025-06-09T00:00:00+00:00"
},
---
{
"sail_id": "12345",
"stop_index": "4",
"port_of_call": "San Francisco, California",
"itinerary_desc": "14 Night Alaska Cruise with Glacier Bay National Park",
"arrival_dt": "2025-06-20 7:00:00",
"departure_dt": null,
"ship_name": "Beautiful Ship",
"sail_duration": 14,
"itinerary_id": "888888",
"latitude": "37.773972",
"longitude": "-122.431297",
"image_url": "https://partner.com/images/XXXXX.jpg",
"updated_at": "2025-06-20T00:00:00+00:00"
}
]