यात्रा की योजना का फ़ीड

यात्रा की योजना वाले फ़ीड में, क्रूज़ के सफ़र की जानकारी शामिल होती है. हर यात्रा की योजना में, यात्राओं का एक सेट होता है. हर यात्रा में यात्रा की जानकारी होती है, जैसे कि बंदरगाह, पहुंचने और जाने का समय और तारीख, यात्रा के हर चरण में समुद्र में चलने का समय, और हर यात्रा का ब्यौरा. यात्रा की योजना के फ़ीड, CSV फ़ॉर्मैट में अपलोड किए जा सकते हैं.

मुख्य कॉम्पोनेंट

यात्रा की योजना वाले फ़ीड में ज़रूरी फ़ील्ड होते हैं, जो केस-सेंसिटिव नहीं होते. कुछ फ़ील्ड भरना ज़रूरी नहीं है और उन्हें खाली छोड़ा जा सकता है. वैकल्पिक डेटा भेजने से डेटा क्वालिटी बेहतर होती है.

इसमें ये ज़रूरी फ़ील्ड शामिल हैं:

  • sail_id : किसी खास यात्रा के लिए, नौकायन का यूनीक आइडेंटिफ़ायर.

  • stop_index : हर पोर्ट के लिए, स्टॉप का यूनीक आइडेंटिफ़ायर.

  • port_of_call: वह बंदरगाह या जगह जहां क्रूज़ रुकता है.

  • itinerary_desc: यात्रा की योजना की जानकारी.

  • arrival_dt: बंदरगाह में पहुंचने की तारीख और समय, कोऑर्डिनेटेड यूनिवर्सल टाइम(यूटीसी) में.

  • departure_dt: बंदरगाह के कोऑर्डिनेटेड यूनिवर्सल टाइम (यूटीसी) में, रवाना होने की तारीख और समय.

  • 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 बंदरगाह के कोऑर्डिनेटेड यूनिवर्सल टाइम(यूटीसी) में, पहुंचने की तारीख और समय. पहले पोर्ट के लिए arrival_dt खाली होना चाहिए और stop_index शून्य होना चाहिए. उदाहरण के लिए, arrival_dt को 2025-01-22T06:00:00+01:00 के तौर पर दिखाया जाता है.
departure_dt Required datetime पोर्ट के कोऑर्डिनेटेड यूनिवर्सल टाइम(यूटीसी) में, जाने की तारीख और समय. आखिरी पोर्ट के लिए 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 हैं. इनका इस्तेमाल नहीं किया जा सकता:
  • टोक्यो
  • GCJ-02
longitude Optional decimal इस पोर्ट ऑफ़ कॉल का देशांतर (लान्जिटूड). इसे WGS84 नोटेशन में बताया जाना चाहिए. यह जानकारी, कॉल के पोर्ट की इकाई की सटीक जगह का पता लगाने के लिए काम की है. उदाहरण के लिए, इटली के ट्रिएस्टे के लिए देशांतर निर्देशांक 13.76188003458354 है. इनका इस्तेमाल नहीं किया जा सकता:
  • टोक्यो
  • GCJ-02
image_url Optional URL पोर्ट ऑफ़ कॉल की इमेज का यूआरएल. उदाहरण के लिए, https://partner.com/images/XXXXX.jpg
updated_at Optional datetime कॉर्डिनेटेड यूनिवर्सल टाइम(यूटीसी) में, इस एंट्री को आखिरी बार अपडेट किए जाने की तारीख और समय. यह जानकारी, पुराने डेटा की पहचान करने के लिए काम की है. यह ISO 8601 फ़ॉर्मैट में होना चाहिए. उदाहरण के लिए, updated_at का मतलब है 2025-01-22T00:00:00+00:00.

उदाहरण

यहां दो सेल के लिए, यात्रा की योजना वाले फ़ीड का एक बुनियादी उदाहरण दिया गया है. इसमें एक सेल एकतरफ़ा यात्रा है और दूसरी सेल, राउंड ट्रिप है.

उदाहरणों में CSV और JSON, दोनों फ़ॉर्मैट दिखाए गए हैं. कॉम्पोज़िट प्राइमरी की बनाने के लिए, sail_id, stop_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

आने-जाने का किराया (ज़रूरी है)

दूसरी यात्रा, सैन फ़्रांसिस्को से शुरू होकर अलास्का और कनाडा होते हुए वापस सैन फ़्रांसिस्को तक की जाएगी. इसमें 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 (जानकारी देने के लिए)

एकतरफ़ा यात्रा (ज़रूरी है)

पहली यात्रा या यात्रा की योजना, सैन फ़्रांसिस्को से कनाडा के लिए एकतरफ़ा है और इसमें चार रातें होंगी. नीचे दिए गए उदाहरण में सिर्फ़ ज़रूरी फ़ील्ड दिखाए गए हैं:

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