इटनररी फ़ीड में, क्रूज़ की यात्रा की जानकारी होती है. हर इटनररी में, यात्राओं का एक सेट होता है. हर यात्रा में, यात्रा की जानकारी होती है. जैसे, पोर्ट, पहुंचने और जाने का समय और तारीखें, यात्रा के हर चरण की अवधि, और हर यात्रा की जानकारी. इटनररी फ़ीड को CSV फ़ॉर्मैट में अपलोड किया जा सकता है.
मुख्य कॉम्पोनेंट
इटनररी फ़ीड में ज़रूरी फ़ील्ड होते हैं. इनमें केस सेंसिटिविटी लागू नहीं होती. कुछ फ़ील्ड ज़रूरी नहीं होते. इन्हें खाली छोड़ा जा सकता है. ज़रूरी नहीं होने वाला डेटा भेजने से, डेटा की क्वालिटी बेहतर होती है.
इसमें ये ज़रूरी फ़ील्ड शामिल होते हैं:
sail_id: किसी खास यात्रा के लिए, एक यूनीक सेलिंग आइडेंटिफ़ायर.stop_index: हर डिपार्चर पोर्ट के लिए एक यूनीक स्टॉप आइडेंटिफ़ायर.port_of_call: पोर्ट ऑफ़ कॉल या वह जगह जहां क्रूज़ रुकता है.itinerary_desc: इटनररी की जानकारी.arrival_dt: पोर्ट के कोऑर्डिनेटेड यूनिवर्सल टाइम(यूटीसी) के हिसाब से, पहुंचने की तारीख और समय.departure_dt: पोर्ट के कोऑर्डिनेटेड यूनिवर्सल टाइम (यूटीसी) के हिसाब से, जाने की तारीख और समय.ship_name: जहाज़ का नाम.sail_duration: यात्रा की अवधि या सेलिंग के दिनों की संख्या.
फ़ील्ड
यहां दी गई टेबल में, इटनररी फ़ीड में मौजूद सभी फ़ील्ड की जानकारी दी गई है:
| फ़ील्ड का नाम | ज़रूरी है? | टाइप | ब्यौरा |
|---|---|---|---|
| sail_id | Required | string | इटनररी में किसी खास यात्रा के लिए, सेलिंग का यूनीक आइडेंटिफ़ायर.
इसमें यात्रा शुरू और खत्म होने की तारीख शामिल होती है.
उदाहरण के लिए, पांच रातों की इटनररी में तीन स्टॉप हैं. इसके लिए, ध्यान दें: |
| 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 | पोर्ट के कोऑर्डिनेटेड यूनिवर्सल टाइम(यूटीसी) के हिसाब से, पहुंचने की तारीख और समय.
पहले पोर्ट के लिए, 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 एक ही होता है. इससे यात्राओं को ग्रुप में बांटा जा सकता है और
व्यवस्थित किया जा सकता है.
उदाहरण के लिए, अगर दो
अलग-अलग इटनररी के लिए पोर्ट ऑफ़ कॉल सैन फ़्रांसिस्को है, तो दोनों
इटनररी के लिए इटनररी आईडी एक ही होगा. इसे |
| 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 | कोऑर्डिनेटेड यूनिवर्सल टाइम(यूटीसी) के हिसाब से, वह तारीख और समय जब इस एंट्री को आखिरी बार अपडेट किया गया था
. इस जानकारी से, पुराने डेटा की पहचान करने में मदद मिलती है. यह
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"
}
]