ฟีดแผนการเดินทางมีข้อมูลการล่องเรือ แผนการเดินทางแต่ละรายการจะมีชุด การเดินทาง การเดินทางแต่ละครั้งจะมีรายละเอียดของการเดินทาง เช่น ท่าเรือ เวลาและวันที่การมาถึงและการออกเดินทาง ระยะเวลาการล่องเรือในแต่ละช่วงของเส้นทาง และคำอธิบายของการเดินทางแต่ละครั้ง คุณอัปโหลดฟีดแผนการเดินทางในรูปแบบ 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 | ตัวระบุดัชนีที่ไม่ซ้ำกันสำหรับแต่ละจุดในแผนการเดินทางของเรือสำราญ โดยจะ
เริ่มต้นด้วยดัชนี 0 สำหรับป้ายจอดรถแรก 0 หมายถึงท่าเรือต้นทางแรก ตัวอย่างเช่น 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 ต้องเป็น 0
ตัวอย่างเช่น 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 เดียวกัน ซึ่งช่วยให้จัดกลุ่มและ
จัดระเบียบการเดินทางได้
ตัวอย่างเช่น หากท่าเรือที่แวะพักอยู่ผ่านซานฟรานซิสโกสำหรับแผนการเดินทาง 2 แผนที่แตกต่างกัน รหัสแผนการเดินทางจะเหมือนกันสำหรับทั้ง 2 แผนการเดินทาง โดยแสดงเป็น |
| 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 |
ตัวอย่าง
ตัวอย่างพื้นฐานของฟีดแผนการเดินทางสำหรับการล่องเรือ 2 เที่ยว โดยเที่ยวหนึ่งเป็นเที่ยวเดียวและอีกเที่ยวหนึ่งเป็นแบบไปกลับ
ตัวอย่างแสดงทั้งรูปแบบ 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
ไป-กลับ (ต้องระบุ)
การล่องเรือครั้งที่ 2 เป็นการเดินทางไปกลับจากซานฟรานซิสโกไปยังอลาสก้าและ แคนาดาเป็นเวลา 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"
}
]
ไป-กลับ (ต้องระบุ)
การล่องเรือครั้งที่ 2 เป็นการเดินทางไปกลับจากซานฟรานซิสโกไปยังอลาสก้าและ แคนาดาเป็นเวลา 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"
}
]