خوراک برنامه سفر

فید برنامه سفر شامل اطلاعات سفر دریایی است. هر برنامه سفر شامل مجموعه‌ای از سفرها است. هر سفر شامل جزئیات سفر مانند بنادر، زمان و تاریخ ورود و خروج، مدت زمان سفر در هر مرحله از سفر و شرح هر سفر است. می‌توانید فیدهای برنامه سفر را با فرمت CSV بارگذاری کنید.

اجزای کلیدی

فید برنامه سفر فیلدهای اجباری دارد که به حروف کوچک و بزرگ حساس نیستند. برخی از فیلدها اختیاری هستند و می‌توانند خالی گذاشته شوند. ارسال داده‌های اختیاری کیفیت داده‌ها را بهبود می‌بخشد.

دارای فیلدهای اجباری زیر است:

• sail_id : یک شناسه منحصر به فرد برای یک سفر دریایی خاص.

• stop_index : یک شناسه توقف منحصر به فرد برای هر بندر خروجی.

  نکته کلیدی: sail_id و stop_index به هم متصل می‌شوند تا یک کلید اصلی مرکب تشکیل دهند و باید منحصر به فرد باشند.

• port_of_call : بندر توقف یا مکانی که کشتی کروز در آن توقف می‌کند.

• itinerary_desc : شرح برنامه سفر.

• arrival_dt : تاریخ و زمان ورود به بندر بر اساس زمان هماهنگ جهانی (UTC).

• departure_dt : تاریخ و زمان حرکت به زمان هماهنگ جهانی (UTC) بندر.

• ship_name : نام کشتی.

• sail_duration : مدت زمان یا تعداد روزهای دریانوردی.

فیلدها

جدول زیر تمام فیلدهای موجود در فید برنامه سفر را شرح می‌دهد:

نام فیلد	الزامی است؟	نوع	توضیحات
sail_id	Required	string	شناسه منحصر به فرد سفر دریایی برای یک سفر خاص در برنامه سفر با تاریخ شروع و پایان. برای مثال، برای یک برنامه سفر ۵ شب که ۳ توقف دارد، sail_id منحصر به فرد است و برای هر ۳ توقف یکسان باقی می‌ماند. نمونه‌ای از sail_id ABC12345 است. نکته: sail_id و stop_index به هم متصل می‌شوند تا یک کلید اصلی مرکب تشکیل دهند و باید منحصر به فرد باشند.
stop_index	Required	integer	شناسه شاخص منحصر به فرد برای هر توقف در برنامه سفر دریایی. این شناسه برای اولین توقف با شاخص صفر شروع می‌شود. صفر نشان دهنده اولین بندر حرکت است. به عنوان مثال، stop_index به صورت 0 نمایش داده می‌شود. نکته: sail_id و stop_index به هم متصل می‌شوند تا یک کلید اصلی مرکب تشکیل دهند و باید منحصر به فرد باشند.
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	مدت زمان سفر یا تعداد شب‌های دریانوردی. برای مثال، برای ۵ شب دریانوردی، sail_duration به صورت 5 نمایش داده می‌شود.
itinerary_id	Required	string	برنامه سفر را مشخص می‌کند. itinerary_id برنامه‌های سفر را از یکدیگر متمایز می‌کند. همه سفرهایی که از بنادر ورودی یکسانی بازدید می‌کنند، itinerary_id یکسانی دارند که امکان گروه‌بندی و سازماندهی سفرها را فراهم می‌کند. برای مثال، اگر بندر توقف برای دو برنامه سفر مختلف از طریق سانفرانسیسکو باشد، شناسه برنامه سفر برای هر دو برنامه سفر یکسان است و به صورت XYZ12345 نمایش داده می‌شود.
latitude	Optional	decimal	عرض جغرافیایی این بندر محل توقف. این باید با نمادگذاری WGS84 مشخص شود. این اطلاعات برای تعیین دقیق موقعیت مکانی موجودیت بندر محل توقف مفید است. به عنوان مثال، مختصات عرض جغرافیایی برای تریسته، ایتالیا 45.64665541364354 است. موارد زیر پشتیبانی نمی‌شوند: توکیو جی سی جی-۰۲
longitude	Optional	decimal	طول جغرافیایی این بندر محل توقف. این طول جغرافیایی باید در نماد WGS84 مشخص شود. این اطلاعات برای تعیین دقیق موقعیت مکانی بندر محل توقف مفید است. به عنوان مثال، مختصات طول جغرافیایی برای تریسته، ایتالیا 13.76188003458354 است. موارد زیر پشتیبانی نمی‌شوند: توکیو جی سی جی-۰۲
image_url	Optional	URL	آدرس اینترنتی (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 برای تشکیل کلید اصلی مرکب به هم متصل می‌شوند و باید برای هر سطر منحصر به فرد باشند.

نکته کلیدی: از فرمت JSON استفاده نکنید؛ این فرمت فقط برای اطلاع‌رسانی است. همه فیدها باید با فرمت CSV باشند.

سی اس وی

سفر یک طرفه (الزامی)

اولین سفر دریایی یا برنامه سفر، یک سفر یک طرفه از سانفرانسیسکو به کانادا به مدت ۴ شب است. مثال زیر فقط فیلدهای اجباری را نشان می‌دهد:

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

رفت و برگشت (الزامی)

دومین سفر دریایی، سفری رفت و برگشت از سانفرانسیسکو است که آلاسکا و کانادا را به مدت ۱۴ شب پوشش می‌دهد. مثال زیر فقط فیلدهای اجباری را نشان می‌دهد:

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 (برای اهداف اطلاعاتی)

سفر یک طرفه (الزامی)

اولین سفر دریایی یا برنامه سفر، یک سفر یک طرفه از سانفرانسیسکو به کانادا به مدت ۴ شب است. مثال زیر فقط فیلدهای اجباری را نشان می‌دهد:

[
  {
    "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"
  }
]

توجه: همه فیدها باید با فرمت CSV باشند. از فرمت JSON استفاده نکنید.

سفر یک طرفه (همه)

مثال زیر تمام فیلدهای موجود برای سفر یک طرفه را نشان می‌دهد:

[
  {
    "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"
  }
]

توجه: همه فیدها باید با فرمت CSV باشند. از فرمت JSON استفاده نکنید.

رفت و برگشت (الزامی)

دومین سفر دریایی، سفری رفت و برگشت از سانفرانسیسکو است که آلاسکا و کانادا را به مدت ۱۴ شب پوشش می‌دهد. مثال زیر فقط فیلدهای اجباری را نشان می‌دهد:

[
  {
    "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"
  }
]

توجه: همه فیدها باید با فرمت CSV باشند. از فرمت JSON استفاده نکنید.

رفت و برگشت (همه)

مثال زیر تمام فیلدهای موجود برای رفت و برگشت را نشان می‌دهد:

[
  {
    "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"
  }
]

توجه: همه فیدها باید با فرمت CSV باشند. از فرمت JSON استفاده نکنید.