ভ্রমণসূচী ফিড

ভ্রমণসূচী ফিডে ক্রুজ যাত্রার তথ্য থাকে। প্রতিটি ভ্রমণসূচীতে একাধিক ট্রিপ থাকে। প্রতিটি ট্রিপে বন্দর, পৌঁছানো ও ছাড়ার সময় ও তারিখ, যাত্রার প্রতিটি পর্যায়ের যাত্রার সময়কাল এবং প্রতিটি ট্রিপের বিবরণের মতো বিস্তারিত তথ্য থাকে। আপনি CSV ফরম্যাটে ভ্রমণসূচী ফিড আপলোড করতে পারেন।

মূল উপাদান

ভ্রমণসূচী ফিডে কিছু আবশ্যিক ফিল্ড রয়েছে যা কেস-ইনসেনসিটিভ। কিছু ফিল্ড ঐচ্ছিক এবং সেগুলো খালি রাখা যেতে পারে। ঐচ্ছিক ডেটা পাঠালে ডেটার গুণমান উন্নত হয়।

এতে নিম্নলিখিত আবশ্যিক ক্ষেত্রগুলো রয়েছে:

  • 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 গন্তব্য বন্দরের প্রতিনিধিত্বকারী একটি ছবির ইউআরএল। উদাহরণস্বরূপ, 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_idstop_index ফিল্ড দুটিকে সংযুক্ত করে কম্পোজিট প্রাইমারি কী গঠন করা হয় এবং প্রতিটি সারির জন্য এগুলো অবশ্যই অনন্য হতে হবে।

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

একমুখী যাত্রা (সকল)

নিম্নলিখিত উদাহরণটি একমুখী যাত্রার জন্য উপলব্ধ সমস্ত ক্ষেত্রগুলি তুলে ধরেছে:

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

আসা-যাওয়ার টিকিট (আবশ্যক)

দ্বিতীয় সমুদ্রযাত্রাটি সান ফ্রান্সিসকো থেকে আলাস্কা ও কানাডা জুড়ে ১৪ রাতের একটি রাউন্ড-ট্রিপ। নিম্নলিখিত উদাহরণটিতে শুধুমাত্র আবশ্যিক ক্ষেত্রগুলো দেখানো হয়েছে:

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